Wiederherstellungs-Images

Auf Nicht-A/B-Geräten sollte das Wiederherstellungs-Image Informationen aus einem Device Tree Blob (DTB) oder einem Advanced Configuration and Power Interface (ACPI)-Overlay-Image enthalten. Wenn solche Geräte in den Wiederherstellungsmodus starten, kann der Bootloader das Overlay-Image laden, das mit dem Wiederherstellungs-Image kompatibel ist. Geräte mit A/B-Unterstützung (nahtlos) Updates die Wiederherstellung als Boot anstelle eines separate Wiederherstellungspartition (weitere Details finden Sie unter A/B implementieren Updates).

Die Optionen zum Einbinden eines DTBO/ACPIO für die Wiederherstellung als Teil des Boot-/Wiederherstellungsvorgangs Image unterscheiden sich je nach Android-Release.

Release	Schema aktualisieren	GKI-Compliance	Header-Version starten (startende Geräte)	Boot-Header-Version (Geräte mit Upgrade)	Spezielles Wiederherstellungs-Image erforderlich
11	A/B, Virtuelles A/B	Ja	3*	–	Nein
	A/B, Virtuelles A/B	Nein	2, 3	0, 1, 2, 3	Nein
	Nicht-A/B-	Ja	3	–	Ja
	Nicht A/B	Nein	2, 3	0, 1, 2, 3	Ja
10 (Q)	A/B	–	2	0, 1, 2	Nein
	Nicht-A/B-	–	2	0, 1, 2	Ja
9 (P)	A/B-Tests	–	1	0, 1	Nein
	Nicht-A/B-	–	1	0, 1	Ja
8 (O)	A/B-Tests	–	– (erfasst 0)	– (erfasst 0)	Nein
	Nicht-A/B-	–	– (erfasst 0)	– (erfasst 0)	Ja

* A/B-Geräte mit Android 11 oder höher und unter Verwendung des generischen Kernel-Images (GKI) muss ein Primäre Boot-Header-Version von 3 werden Kompatibel mit Boot-Browsern Partition.

Wichtige Punkte:

• Für A/B-Geräte muss kein Wiederherstellungs-Image angegeben werden, da A/B-Updates zwei Partitionen (einschließlich boot und dtbo) verwenden und während der Updates zwischen ihnen wechseln. Ein Wiederherstellungs-Image ist daher nicht erforderlich. A/B-Geräte können weiterhin ein spezielles Wiederherstellungs-Image verwenden.

• Nicht-A/B-Geräte, die mit Android 11 oder höher auf den Markt gebracht werden Bei Verwendung der Boot-Header-Version 3 muss explizit ein Boot-Header Version 2 für das Wiederherstellungsabbild separat einrichten. Beispiel:

  BOARD_RECOVERY_MKBOOTIMG_ARGS := --header_version 2
  

• Bei Architekturen, die keine Gerätestrukturen unterstützen, kann das Wiederherstellungsimage Ein ACPIO-Bild anstelle eines DTBO-Bilds.

OTA-Fehler und Wiederherstellungs-Images

Um OTA-Ausfälle (Over The Air) auf Nicht-A/B-Geräten zu vermeiden, sollte unabhängig von anderen Bildern sein. Wenn während eines OTA-Updates ein Problem auftritt, nachdem das Overlay-Image aktualisiert wurde, aber bevor das vollständige Update abgeschlossen wurde, versucht das Gerät, im Wiederherstellungsmodus zu starten, um das OTA-Update abzuschließen. Da die Overlay-Partition jedoch bereits aktualisiert wurde, könnte eine Diskrepanz mit dem Wiederherstellungsabbild (das nicht noch aktualisiert).

Damit die Wiederherstellung nicht von der DTBO/ACPIO-Partition während eines Updates abhängig ist, können Geräte ohne A/B-Partition, auf denen Android 9 oder höher ausgeführt wird, ein DTBO/ACPIO-Wiederherstellungs-Image mit Informationen aus dem Overlay-Image als separaten Abschnitt im Boot-Image-Format angeben. Dabei muss eine Boot-Header-Version von 1 oder 2 verwendet werden.

Änderungen am Boot-Image

Damit das Wiederherstellungs-Image das DTBO oder ACPIO für die Wiederherstellung auf Nicht-A/B-Geräten mit Android 9 oder höher enthalten kann, aktualisieren Sie die Boot-Image-Struktur so:

Abschnitt „Boot-Image“	Seitenzahl
Bootheader (1 Seite)	1
Kernel (l-Seiten)	l = (kernel_size + page_size – 1) / page_size
Ramdisk (M-Seiten)	m = (ramdisk_size + page_size – 1) / page_size
Bootloader der zweiten Stufe (n Seiten)	n = (second_size + page_size – 1) ÷ page_size
Wiederherstellung DTBO oder ACPIO (o-Seiten)	o = (recovery_[dtbo|acpio]_size + page_size – 1) / page_size

Weitere Informationen zu den Argumenten des mkbootimg-Tools zum Angeben des Boot-Images Header-Version und Overlay-Image-Pfade, siehe Boot-Image-Header Versionsverwaltung.

DTBO implementieren

Nicht-A/B-Geräte mit Version 9 oder höher können Abschnitt recovery_dtbo des Wiederherstellungsabbilds. So fügen Sie das recovery_dtbo-Image in recovery.img auf dem Gerät BoardConfig.mk ein:

• Legen Sie die Konfiguration BOARD_INCLUDE_RECOVERY_DTBO auf true fest:

   BOARD_INCLUDE_RECOVERY_DTBO := true
  

• Erweitern Sie die Variable BOARD_MKBOOTIMG_ARGS, um die Version der Boot-Image-Kopfzeile anzugeben:

  BOARD_MKBOOTIMG_ARGS := --ramdisk_offset $(BOARD_RAMDISK_OFFSET) --tags_offset $(BOARD_KERNEL_TAGS_OFFSET) --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
  

• Die Variable BOARD_PREBUILT_DTBOIMAGE muss auf den Pfad des DTBO-Images festgelegt sein. Das Android-Build-System verwendet die Variable, um das recovery_dtbo-Argument des mkbootimg-Tools beim Erstellen des Wiederherstellungs-Images festzulegen.

Wenn die Variablen BOARD_INCLUDE_RECOVERY_DTBO, BOARD_MKBOOTIMG_ARGS und BOARD_PREBUILT_DTBOIMAGE richtig festgelegt sind, enthält das Android-Build-System die DTBO, die durch die Variable BOARD_PREBUILT_DTBOIMAGE in recovery.img angegeben ist.

ACPIO implementieren

Nicht-A/B-Geräte mit Android 9 oder höher können ein ACPIO-Overlay-Image (anstelle eines DTBO-Images) verwenden und den Bereich recovery_acpio (anstelle des Bereichs recovery_dtbo) des Wiederherstellungs-Images ausfüllen. So fügen Sie das Bild recovery_acpio in recovery.img ein: Gerät BoardConfig.mk:

• Legen Sie die Konfiguration BOARD_INCLUDE_RECOVERY_ACPIO auf true fest:

  BOARD_INCLUDE_RECOVERY_ACPIO := true
  

• Erweitern Sie die Variable BOARD_MKBOOTIMG_ARGS, um die Version der Boot-Image-Kopfzeile anzugeben. Die Variable muss größer oder gleich 1 sein, um die Wiederherstellung zu unterstützen ACPIO.

  BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
  

• Die Variable BOARD_RECOVERY_ACPIO muss auf den Pfad des ACPIO-Bild. Das Android-Build-System verwendet die Variable, um die Argument recovery_acpio des mkbootimg-Tools beim Erstellen des Wiederherstellungsabbild.

Wenn die Variablen BOARD_INCLUDE_RECOVERY_ACPIO, BOARD_MKBOOTIMG_ARGS und BOARD_RECOVERY_ACPIO richtig festgelegt sind, enthält das Android-Build-System die ACPIO, die in recovery.img durch die Variable BOARD_RECOVERY_ACPIO angegeben ist.