復原映像檔

在非 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)	是

* 搭載 Android 11 以上版本，並使用通用核心映像檔 (GKI) 的 A/B 裝置，必須使用 3 級的主要開機標頭版本，才能與供應商開機分區相容。

重點：

• A/B 裝置不需要指定復原映像檔，因為 A/B 更新會使用兩組分區 (包括 boot 和 dtbo)，並在更新期間在各組分區間切換，無需使用復原映像檔。A/B 裝置仍可使用專用復原映像檔。

• 非 A/B 裝置若要使用 Android 11 以上版本，並使用版本 3 的啟動標頭，則必須另外明確指定復原映像檔的啟動標頭版本 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 = (recovery_[dtbo|acpio]_size + page_size - 1) / page_size

如要進一步瞭解用於指定開機映像檔標頭版本和疊加圖像路徑的 mkbootimg 工具引數，請參閱「開機映像檔標頭版本管理」。

實作 DTBO

搭載 Android 9 以上版本的非 A/B 裝置，可以填入復原映像檔的 recovery_dtbo 區段。如要在 recovery.img 中加入 recovery_dtbo 圖片，請在裝置 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 建構系統會在 recovery.img 中加入 BOARD_PREBUILT_DTBOIMAGE 變數指定的 DTBO。

實作 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。