在非 A/B 裝置上,復原映像檔應包含 裝置樹狀結構 blob (DTB) 或 進階設定和電源介面 (ACPI) 重疊廣告。當這類裝置啟動至復原模式時,系統啟動載入程式就能載入與復原映像相容的疊加層圖片。支援 A/B (無縫) 的裝置 更新應使用復原做為啟動,而非 不同的復原分區 (詳情請參閱實作 A/B 版本) 更新)。
將復原 DTBO/ACPIO 納入啟動/復原映像檔的選項,在不同 Android 版本之間有所差異。
發布 | 更新配置 | 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) | 是 |
* 如果 A/B 裝置搭載 Android 11 以上版本,並使用通用核心映像檔 (GKI),則必須使用主要 3 版的啟動序列標頭,才能與供應商啟動區相容。
重點:
A/B 裝置不需要指定復原映像檔,因為 A/B 更新會使用兩組更新 部分分區 (包括
boot
和dtbo
) 並在維護期間切換 移除需要還原映像檔的需求A/B 裝置 仍會使用專屬的復原映像檔搭載 Android 11 以上版本的非 A/B 裝置 並使用 3 的開機標頭版本明確指定 boot 標頭 版本 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)。
開機映像檔變更
為了讓復原映像檔在非 A/B 上包含復原 DTBO 或 ACPIO 搭載 Android 9 以上版本的裝置,請更新開機程序 映像檔結構
「開機映像檔」區段 | 頁數 |
---|---|
開機標頭 (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 = (recovery_[dtbo|acpio]_size + page_size - 1) / page_size |
進一步瞭解用於指定開機映像檔的 mkbootimg
工具引數
標頭版本和重疊圖片路徑,請參閱啟動映像檔標頭
版本管理:
實作 DTBO
搭載 9 以上版本的非 A/B 裝置可以填入
還原映像檔的 recovery_dtbo
部分。加入 recovery_dtbo
recovery.img
中的圖片,位於裝置 BoardConfig.mk
中:
將
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_DTBO
、BOARD_MKBOOTIMG_ARGS
和
BOARD_PREBUILT_DTBOIMAGE
變數設定正確,Android 建構系統
包含由 BOARD_PREBUILT_DTBOIMAGE
變數指定的 DTBO。
recovery.img
。
實作 ACPIO
搭載 Android 9 以上版本的非 A/B 裝置可以使用
ACPIO 疊加層圖片 (而不是 DTBO 圖片),並可填入
recovery_acpio
部分 (而非 recovery_dtbo
區段),
復原映像檔如要在 recovery.img
中加入 recovery_acpio
圖片,請在
裝置 BoardConfig.mk
:
將
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_ACPIO
、BOARD_MKBOOTIMG_ARGS
和 BOARD_RECOVERY_ACPIO
變數設定正確,Android 建構系統就會納入 recovery.img
中 BOARD_RECOVERY_ACPIO
變數指定的 ACPIO。