リカバリ イメージ

非 A/B デバイスの場合、リカバリ イメージにはデバイスツリー blob（DTB）または Advanced Configuration and Power Interface（ACPI）オーバーレイ イメージの情報が含まれている必要があります。非 A/B デバイスでリカバリを起動すると、ブートローダーはリカバリ イメージに対応するオーバーレイ イメージを読み込めるようになります。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 以降を搭載し、Generic Kernel Image（GKI）を使用している A/B デバイスは、メインのブートヘッダー バージョン 3 を使用して、ベンダー ブート パーティションと互換性があるようにする必要があります。

主なポイントは以下のとおりです。

• A/B アップデートでは 2 つのパーティション セット（boot と dtbo を含む）を使用し、更新中に切り替えられるため、A/B デバイスはリカバリ イメージを指定する必要はありません。また、A/B デバイスでは専用のリカバリ イメージを使用することもできます。

• Android 11 以降を搭載し、ブートヘッダー バージョン 3 を使用している非 A/B デバイスでは、個別にリカバリ イメージのブートヘッダー バージョン 2 を明示的に指定する必要があります。例:

  BOARD_RECOVERY_MKBOOTIMG_ARGS := --header_version 2
  

• デバイスツリーをサポートしていないアーキテクチャの場合、DTBO イメージの代わりに ACPIO イメージをリカバリ イメージに含めることができます。

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
第 2 段階のブートローダー（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 セクションに挿入できます。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 ビルドシステムは recovery.img の BOARD_PREBUILT_DTBOIMAGE 変数で指定された DTBO を含めます。

ACPIO を実装する

Android 9 以降を搭載した非 A/B デバイスでは、DTBO イメージの代わりに ACPIO オーバーレイ イメージを使用し、recovery_dtbo セクションの代わりにリカバリ イメージの recovery_acpio セクションに挿入できます。recovery_acpio イメージを recovery.img に含めるには、デバイスの BoardConfig.mk で以下の操作を実行します。

• BOARD_INCLUDE_RECOVERY_ACPIO 構成を true に設定します。

  BOARD_INCLUDE_RECOVERY_ACPIO := true
  

• BOARD_MKBOOTIMG_ARGS 変数を拡張し、ブートイメージ ヘッダーのバージョンを指定します。リカバリ ACPIO をサポートするには、変数を 1 以上にする必要があります。

  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 を含めます。