恢复映像

在非 A/B 设备上,恢复映像应包含设备树 blob (DTB)高级配置与电源接口 (ACPI) 叠加层映像的信息。当此类设备启动进入恢复模式时,引导加载程序可以加载与恢复映像兼容的叠加层映像。支持 A/B(无缝)更新的设备应将恢复用作启动,而非单独的恢复分区(如需了解详情,请参阅实现 A/B 更新)。

在不同的 Android 版本中,用于将恢复 DTBO/ACPIO 作为启动/恢复映像的一部分的选项有所不同。

版本 更新方案 GKI 合规性 启动头文件版本(发布设备) 启动头文件版本(升级设备) 需要专用恢复映像
11 A/B、
虚拟 A/B
3* 不适用
A/B、
虚拟 A/B
2、3 0、1、2、3
非 A/B 3 不适用
非 A/B 2、3 0、1、2、3
10 (Q) A/B 不适用 2 0、1、2
非 A/B 不适用 2 0、1、2
9 (P) A/B 不适用 1 0、1
非 A/B 不适用 1 0、1
8 (O) A/B 不适用 不适用(视为 0) 不适用(视为 0)
非 A/B 不适用 不适用(视为 0) 不适用(视为 0)

* 搭载 Android 11 或更高版本并使用通用内核映像 (GKI) 的 A/B 设备必须使用主启动头文件版本 3,才能与供应商启动分区相兼容。

要点:

  • A/B 设备不需要指定恢复映像,因为 A/B 更新使用两组分区(包括 bootdtbo),且在更新期间在两者间切换,从而无需恢复映像。A/B 设备仍可以使用专用恢复映像。

  • 发布时搭载 Android 11 或更高版本且使用启动头文件版本 3 的非 A/B 设备必须单独为恢复映像显式指定启动头文件版本 2。例如:

    BOARD_RECOVERY_MKBOOTIMG_ARGS := --header_version 2
    
  • 对于不支持设备树的架构,恢复映像可能包含 ACPIO 映像而不是 DTBO 映像。

关于 OTA 失败和恢复映像

为了防止非 A/B 设备上出现无线下载 (OTA) 失败的情况,恢复映像应该“自给自足”,不依赖于其他映像。在 OTA 更新期间,如果在叠加层映像更新后(但在完成全部更新之前)出现问题,设备会尝试启动进入恢复模式,以完成 OTA 更新。不过,由于叠加层分区已更新,恢复映像(尚未更新)可能会出现不匹配的情况。

为阻止恢复在更新过程中依赖于 DTBO/ACPIO 分区,搭载 Android 9 或更高版本的非 A/B 设备可以将包含来自叠加层映像的信息的恢复 DTBO/ACPIO 映像指定为启动映像格式的单独部分(必须使用启动头文件版本 1 或 2)。

启动映像更改

为允许恢复映像包含搭载 Android 9 或更高版本的非 A/B 设备上的恢复 DTBO 或 ACPIO,请按如下所示更新启动映像结构。

启动映像部分 页数
启动头文件(1 页) 1
内核(l 页) l = (kernel_size + page_size - 1) / page_size
Ramdisk(m 页) m = (ramdisk_size + page_size - 1) / page_size
第二阶段引导加载程序(n 页) n = (second_size + page_size - 1) / page_size
恢复 DTBO 或 ACPIO(o 页) o = (recovery_[dtbo|acpio]_size + page_size - 1) / page_size

如需详细了解用于指定启动映像头文件版本和叠加层映像路径的 mkbootimg 工具参数,请参阅启动映像头文件版本编号

实现 DTBO

搭载 9 或更高版本的非 A/B 设备可以填充恢复映像的 recovery_dtbo 部分。如需在 BoardConfig.mk 设备的 recovery.img 中添加 recovery_dtbo 映像,请执行以下操作:

  • BOARD_INCLUDE_RECOVERY_DTBO 配置设置为 true

     BOARD_INCLUDE_RECOVERY_DTBO := true
    
  • 扩展 BOARD_MKBOOTIMG_ARGS 变量以指定启动映像头文件版本:

    BOARD_MKBOOTIMG_ARGS := --ramdisk_offset $(BOARD_RAMDISK_OFFSET) --tags_offset $(BOARD_KERNEL_TAGS_OFFSET) --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
    
  • 确保将 BOARD_PREBUILT_DTBOIMAGE 变量设置为 DTBO 映像的路径。Android 构建系统使用该变量在创建恢复映像期间设置 mkbootimg 工具的 recovery_dtbo 参数。

如果变量 BOARD_INCLUDE_RECOVERY_DTBOBOARD_MKBOOTIMG_ARGSBOARD_PREBUILT_DTBOIMAGE 均正确设置,Android 构建系统会将变量 BOARD_PREBUILT_DTBOIMAGE 指定的 DTBO 添加到 recovery.img 中。

实现 ACPIO

搭载 Android 9 或更高版本的非 A/B 设备可以使用 ACPIO 叠加层映像(而不是 DTBO 映像),并且可以填充恢复映像的 recovery_acpio 部分(而不是 recovery_dtbo 部分)。如需在 BoardConfig.mk 设备的 recovery.img 中添加 recovery_acpio 映像,请执行以下操作:

  • BOARD_INCLUDE_RECOVERY_ACPIO 配置设置为 true

    BOARD_INCLUDE_RECOVERY_ACPIO := true
    
  • 扩展 BOARD_MKBOOTIMG_ARGS 变量以指定启动映像头文件版本。变量必须大于或等于 1,才能支持恢复 ACPIO。

    BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
    
  • 确保将 BOARD_RECOVERY_ACPIO 变量设置为 ACPIO 映像的路径。Android 构建系统使用该变量在创建恢复映像期间设置 mkbootimg 工具的 recovery_acpio 参数。

如果变量 BOARD_INCLUDE_RECOVERY_ACPIOBOARD_MKBOOTIMG_ARGSBOARD_RECOVERY_ACPIO 均正确设置,Android 构建系统会将变量 BOARD_RECOVERY_ACPIO 指定的 ACPIO 添加到 recovery.img 中。