构建 OTA 软件包

您可以使用 build/make/tools/releasetools 中提供的 ota_from_target_files 工具,针对使用 A/B 系统更新非 A/B 系统更新的设备构建完整 OTA 软件包和增量 OTA 软件包。该工具将 Android 构建系统生成的 target-files.zip 文件作为输入文件。

对于搭载 Android 11 或更高版本的设备,您可以为具有不同 SKU 的多台设备构建一个 OTA 软件包。为此,需要将目标设备配置为使用动态指纹更新 OTA 元数据,以便在前提条件和后置条件条目中添加设备名称和指纹。

Android 8.0 废弃了非 A/B 设备基于文件的 OTA 软件包,而必须改用基于块的 OTA 软件包。如需为搭载 Android 7.x 或更低版本的设备生成基于块的 OTA 软件包,请将 --block 选项传递给 ota_from_target_files 参数。

构建完整更新

完整更新是指 OTA 软件包将对设备的整个最终状态(system 分区、boot 分区和 recovery 分区)进行更新。不管设备的当前状态如何,只要设备能够接收和应用软件包,软件包就会安装 build。例如,以下命令使用发布工具为 tardis 设备构建 target-files.zip 归档文件。

. build/envsetup.sh && lunch tardis-eng
mkdir dist_output
make dist DIST_DIR=dist_output

make dist 会构建完整的 OTA 软件包(在 $OUT 中)。生成的 .zip 文件包含为 tardis 设备构建 OTA 软件包所需的所有内容。您还可以将 ota_from_target_files 构建为 Python 二进制文件,并调用它来构建完整软件包或增量软件包。

ota_from_target_files dist_output/tardis-target_files.zip ota_update.zip

ota_from_target_files 路径在 $PATH 中设置,并且生成的 Python 二进制文件位于 out/ 目录中。

ota_update.zip 现已准备就绪,可以发送到测试设备(所有内容均使用测试密钥进行签名)。对于用户设备,请生成并使用自己的私钥,详情请参阅对需要发布的 build 进行签名

构建增量更新

增量更新是指 OTA 软件包将对设备上的现有数据应用二进制补丁。采用增量更新的软件包通常较小,因为它们无需包含未更改的文件。此外,由于更改的文件通常与之前的版本非常相似,因此软件包中只需包含针对两个文件之间的不同之处进行的编码。

只有当设备具有构建相应软件包所使用的源 build 时,您才能在设备上安装增量更新软件包。如需构建增量更新,您需要上一个 build(您要更新的那个 build)中的 target_files.zip 文件以及新 build 中的 target_files.zip 文件。例如,以下命令可使用发布工具为 tardis 设备构建增量更新。

ota_from_target_files -i PREVIOUS-tardis-target_files.zip dist_output/tardis-target_files.zip incremental_ota_update.zip

此 build 与上一个 build 非常相似,而且增量更新软件包(incremental_ota_update.zip,约 1MB)比对应的完整更新软件包 (60MB) 小得多。

仅当设备运行的上一个 build 与相应增量更新软件包的起点 build 完全一样时,才向其分发该增量更新软件包。您必须刷写 PREVIOUS-tardis-target_files.zipPREVIOUS-tardis-img.zip 中的映像(均使用 make dist 构建,将使用 fastboot update 进行刷写),而不是 PRODUCT_OUT 目录下的映像(使用 make 进行构建,将使用 fastboot flashall 进行刷写)。尝试在具有其他某个 build 的设备上安装增量更新软件包会导致安装错误。如果安装失败,设备同样会保持正常运行状态(运行旧系统);软件包在触及它要更新的所有文件之前,会验证其上一个状态,因此设备不会滞留在半升级状态。

为了提供最佳用户体验,请在每 3-4 次增量更新之后提供 1 次完整更新。这样有助于用户及时更新到最新版本,并避免冗长的增量更新安装序列。

为多个 SKU 构建 OTA 软件包

Android 11 或更高版本支持为具有不同 SKU 的多台设备使用单个 OTA 软件包。为此,需要将目标设备配置为使用动态指纹并更新 OTA 元数据(使用 OTA 工具),以便在前提条件和后置条件条目中添加设备名称和指纹。

关于 SKU

SKU 的格式是组合 build 参数值的变体,通常是当前 build_fingerprint 参数的未声明子集。原始设备制造商 (OEM) 可以为 SKU 使用由 CDD 批准的构建参数的任意组合,同时仍对这些 SKU 使用单个映像。例如,以下 SKU 具有多个变体:

SKU = <product><device><modifierA><modifierB><modifierC>
  • modifierA 是设备级(例如 Pro、Premium 或 Plus)
  • modifierB 是硬件变体(例如无线装置)
  • modifierC 是区域,可以是一般区域(如 NA、EMEA 或 CHN),也可以是特定于国家/地区或语言的区域(如 JPN、ENG 或 CHN)

许多 OEM 都针对多个 SKU 使用单个映像,然后在设备启动后在运行时衍生出最终的产品名称和设备指纹。此过程简化了平台开发流程,使进行了小规模自定义但产品名称不同的设备(如 tardistardispro)可以共用常见的映像。

使用动态指纹

指纹是一个定义好的构建参数的串联,如 ro.product.brandro.product.namero.product.device。设备的指纹衍生自 system 分区指纹,用作在设备中运行的映像(和字节)的唯一标识符。如需创建动态指纹,请使用设备 build.prop 文件中的动态逻辑,在设备启动时获取引导加载程序变量的值,然后使用这些数据为该设备创建动态指纹。

例如,如需为 tardistardispro 设备使用动态指纹,请按如下说明更新相应文件。

  • 更新 odm/etc/build_std.prop 文件,在其中添加以下代码行。

    ro.odm.product.device=tardis
    
  • 更新 odm/etc/build_pro.prop 文件,在其中添加以下代码行。

    ro.odm.product.device=tardispro
    
  • 更新 odm/etc/build.prop 文件,在其中添加以下代码行。

    ro.odm.product.device=tardis
    import /odm/etc/build_${ro.boot.product.hardware.sku}.prop
    

这些代码行会根据 ro.boot.product.hardware.sku 引导加载程序属性(只读)的值动态设置设备名称、指纹和 ro.build.fingerprint 值。

更新 OTA 软件包元数据

OTA 软件包中包含用于描述软件包的元数据文件 (META-INF/com/android/metadata),其中包括 OTA 软件包的前提条件和后置条件。例如,以下代码是某个以 tardis 设备为目标的 OTA 软件包的元数据文件。

post-build=google/tardis/tardis:11/RP1A.200521.001/6516341:userdebug/dev-keys
post-build-incremental=6516341
post-sdk-level=30
post-security-patch-level=2020-07-05
post-timestamp=1590026334
pre-build=google/tardis/tardis:11/RP1A.200519.002.A1/6515794:userdebug/dev-keys
pre-build-incremental=6515794
pre-device=tardis

pre-devicepre-build-incrementalpre-build 值定义了设备必须具备哪种状态后才能安装 OTA 软件包。post-build-incrementalpost-build 值定义了设备在安装 OTA 软件包后的预期状态。pre-post- 字段的值衍生自下列对应的构建属性。

  • pre-device 值衍生自 ro.product.device build 属性。
  • pre-build-incrementalpost-build-incremental 值衍生自 ro.build.version.incremental build 属性。
  • pre-buildpost-build 值衍生自 ro.build.fingerprint 构建属性。

在搭载 Android 11 或更高版本的设备上,您可以在 OTA 工具中使用 --boot_variable_file 标志指定一个文件的路径,该文件包含用于创建设备动态指纹的运行时变量的值。然后,这些数据将被用来更新 OTA 元数据,以在 pre-post- 条件中添加设备名称和指纹(使用竖线字符 | 作为分隔符)。--boot_variable_file 标志的语法和说明如下。

  • 语法:--boot_variable_file <path>
  • 说明:指定一个文件的路径,该文件包含 ro.boot.* 属性的可能值。该属性用于在某些 ro.product.* 属性被 import 语句覆盖时计算可能的运行时指纹。该文件每行需要填写一个属性,每行的格式如下:prop_name=value1,value2

例如,当属性为 ro.boot.product.hardware.sku=std,pro 时,tardistardispro 设备的 OTA 元数据如下所示。

post-build=google/tardis/tardis:11/<suffix>|google/tardis/tardispro:11/<suffix>
pre-build=google/tardis/tardis:11/<suffix>|google/tardis/tardispro:11/<suffix>
pre-device=tardis|tardispro

如需在搭载 Android 10 的设备上支持此功能,请参阅参考实现。此变更列表会有条件地解析 build.prop 文件中的 import 语句,使属性替换项能被系统识别出来并反映在最终 OTA 元数据中。