[转载]recovery 升级前兼容性检查(Vendor Interface Object)

https://blog.csdn.net/csdn66_2016/article/details/81704720

  从android P(9.0)版本开始,我们发现编译出来的OTA升级了里面多了一个文件,compatibility.zip,这个里面存储这system与vendor分区的一些特性,用来做升级前的兼容性检查。其实从android O开始已经增加了这个功能,但是没有默认打开。直到android P上,已经默认打开了。

解压compatibility.zip后,内容如下:

我们先从google的官方了解下这个功能。

https://source.android.com/devices/architecture/vintf/

 

Framework(system)和Device(vendor)匹配的框架如下:

  Manifest 描述了提供给对方的feature, Matrix 描述了需要对方提供的feature。Manifest 和 Matrix 在OTA升级前会进行匹配检查,以确保framework和device是兼容的。总的来说,manifest是提供端,matrix是需求端。

 

下面以android P最新的aosp的code为例。

Framework Manifest:

manifest.xml的源文件由google手动生成,其存在路径:

system/libhidl/vintfdata/manifest.xml

system/libhidl/vintfdata/manifest_healthd_exclude.xml 

至于xml的内容就不贴上来了,可以到对应的目录去查看源文件。manifest.xml的格式可以参考官方文档即可,也不在此详细讲解。

 

Framework Compatibility Matrix:

Framework compatibility matrix描述的是framework对 device的需求。这个matrix文件是和Android Framework Image(system.img)关联的。Framework compatibility matrix的这些需要被device manifest支持。

 

compatibility matrix源文件路径:

hardware/interfaces/compatibility_matrices/compatibility_matrix.1.xml

hardware/interfaces/compatibility_matrices/compatibility_matrix.2.xml

hardware/interfaces/compatibility_matrices/compatibility_matrix.3.xml

hardware/interfaces/compatibility_matrices/compatibility_matrix.empty.xml

hardware/interfaces/compatibility_matrices/compatibility_matrix.legacy.xml

 

Device Manifest:

由BoardConfig.mk中定义

device/xxxx/xxxx/BoardConfig.mk定义:

DEVICE_MANIFEST_FILE := device/xxxx/xxxx/manifest.xml

源文件为 device/xxxx/xxxx/manifest.xml

 

Device Compatibility Matrix

如果BoardConfig.mk中有定义,则以定义的文件为源文件:

#DEVICE_MATRIX_FILE   := device/amlogic/common/compatibility_matrix.xml

如果没有定义,则使用缺省的源文件:

system/libhidl/vintfdata/device_compatibility_matrix.default.xml

 

如上,我们找到了device manifest,device compatibility matrix,framework manifest,framework compatibility matrix各自对应的源文件,然后我们通过编译规则生成最终的xml文件。

 

  build/make/target/board/Android.mk(定义了Device Manifest生成规则)


   
   
  1. # Device Manifest
  2. ifdef DEVICE_MANIFEST_FILE
  3. # $(DEVICE_MANIFEST_FILE) can be a list of files
  4. include $(CLEAR_VARS)
  5. LOCAL_MODULE := device_manifest.xml
  6. LOCAL_MODULE_STEM := manifest.xml
  7. LOCAL_MODULE_CLASS := ETC
  8. LOCAL_MODULE_PATH := $(TARGET_OUT_VENDOR)/etc/vintf
  9. GEN := $(local-generated-sources-dir)/manifest.xml
  10. $(GEN): PRIVATE_DEVICE_MANIFEST_FILE := $(DEVICE_MANIFEST_FILE)
  11. $(GEN): $(DEVICE_MANIFEST_FILE) $(HOST_OUT_EXECUTABLES)/assemble_vintf
  12. BOARD_SEPOLICY_VERS= $(BOARD_SEPOLICY_VERS) \
  13. PRODUCT_ENFORCE_VINTF_MANIFEST= $(PRODUCT_ENFORCE_VINTF_MANIFEST) \
  14. PRODUCT_SHIPPING_API_LEVEL= $(PRODUCT_SHIPPING_API_LEVEL) \
  15. $(HOST_OUT_EXECUTABLES)/assemble_vintf -o $@ \
  16. -i $(call normalize-path-list,$(PRIVATE_DEVICE_MANIFEST_FILE))
  17. LOCAL_PREBUILT_MODULE_FILE := $(GEN)
  18. include $(BUILD_PREBUILT)
  19. BUILT_VENDOR_MANIFEST := $(LOCAL_BUILT_MODULE)
  20. endif

system/libhidl/vintfdata/Android.mk(定义了Device Compatibility Matrix / Framework Manifest编译规则)


   
   
  1. # Device Compatibility Matrix
  2. ifdef DEVICE_MATRIX_FILE
  3. DEVICE_MATRIX_INPUT_FILE := $(DEVICE_MATRIX_FILE)
  4. else
  5. DEVICE_MATRIX_INPUT_FILE := $(LOCAL_PATH)/device_compatibility_matrix.default.xml
  6. endif
  7. include $(CLEAR_VARS)
  8. LOCAL_MODULE := device_compatibility_matrix.xml
  9. LOCAL_MODULE_STEM := compatibility_matrix.xml
  10. LOCAL_MODULE_CLASS := ETC
  11. LOCAL_MODULE_PATH := $(TARGET_OUT_VENDOR)/etc/vintf
  12. GEN := $(local-generated-sources-dir)/compatibility_matrix.xml
  13. $(GEN): PRIVATE_VINTF_VNDK_VERSION := $(VINTF_VNDK_VERSION)
  14. $(GEN): $(DEVICE_MATRIX_INPUT_FILE) $(HOST_OUT_EXECUTABLES)/assemble_vintf
  15. REQUIRED_VNDK_VERSION= $(PRIVATE_VINTF_VNDK_VERSION) \
  16. BOARD_SYSTEMSDK_VERSIONS= "$(BOARD_SYSTEMSDK_VERSIONS)" \
  17. $(HOST_OUT_EXECUTABLES)/assemble_vintf -i $< -o $@
  18. LOCAL_PREBUILT_MODULE_FILE := $(GEN)
  19. include $(BUILD_PREBUILT)
  20. BUILT_VENDOR_MATRIX := $(LOCAL_BUILT_MODULE)
  21. # Framework Manifest
  22. include $(CLEAR_VARS)
  23. LOCAL_MODULE := framework_manifest.xml
  24. LOCAL_MODULE_STEM := manifest.xml
  25. LOCAL_MODULE_CLASS := ETC
  26. LOCAL_MODULE_PATH := $(TARGET_OUT)/etc/vintf
  27. GEN := $(local-generated-sources-dir)/manifest.xml
  28. $(GEN): PRIVATE_FLAGS :=
  29. ifeq ( $(PRODUCT_ENFORCE_VINTF_MANIFEST),true)
  30. ifdef BUILT_VENDOR_MATRIX
  31. $(GEN): $(BUILT_VENDOR_MATRIX)
  32. $(GEN): PRIVATE_FLAGS += -c "$(BUILT_VENDOR_MATRIX)"
  33. endif
  34. endif
  35. $(GEN): PRIVATE_VINTF_VNDK_VERSION := $(VINTF_VNDK_VERSION)
  36. $(GEN): PRIVATE_FRAMEWORK_MANIFEST_INPUT_FILES := $(FRAMEWORK_MANIFEST_INPUT_FILES)
  37. $(GEN): $(FRAMEWORK_MANIFEST_INPUT_FILES) $(HOST_OUT_EXECUTABLES)/assemble_vintf
  38. PROVIDED_VNDK_VERSIONS= "$(PRIVATE_VINTF_VNDK_VERSION) $(PRODUCT_EXTRA_VNDK_VERSIONS)" \
  39. PLATFORM_SYSTEMSDK_VERSIONS= "$(PLATFORM_SYSTEMSDK_VERSIONS)" \
  40. $(HOST_OUT_EXECUTABLES)/assemble_vintf \
  41. -i $(call normalize-path-list,$(PRIVATE_FRAMEWORK_MANIFEST_INPUT_FILES)) \
  42. -o $@ $(PRIVATE_FLAGS)

hardware/interfaces/compatibility_matrices/Android.mk

hardware/interfaces/compatibility_matrices/compatibility_matrix.mk (定义了Framework Compatibility Matrix规则)

# 详细规则请查看源文件,就不贴代码了
   
   

有了上述源文件及编译规则,则可以生成最终的xml文件了, 具体的调用,都是使用了out/host/linux-x86/bin/assemble_vintf工具。

 

生成的最终的xml对应的分区路径如下:

/system/compatibility_matrix.xml

/system/etc/vintf/manifest.xml

/vendor/etc/vintf/compatibility_matrix.xml

/vendor/etc/vintf/manifest.xml

 

  至此,我们在升级过程,可以从升级包update.zip中获取manifest与matrix文件(system_manifest.xml system_matrix.xml vendor_manifest.xml vendor_matrix.xml),然后挂载/system /vendor分区,与system/vendor分区对应的xml对比校验,检查是否符合升级条件。满足条件,则继续后面的升级,如果不满足条件,则终止升级。

 

具体的代码实现,bootable/recovery/install.cpp中

在升级包的完整性校验完成之后,就进行兼容性校验,最终的实现调用的接口是(system/libvintf/VintfObject.cpp):android::vintf::VintfObjectRecovery::CheckCompatibility

 

参考:

https://www.jianshu.com/p/a9ea323f892c

https://source.android.com/devices/architecture/vintf/

          

  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值