Immagini di ripristino

Sui dispositivi non A/B, l'immagine di ripristino deve contenere informazioni provenienti da un blob ad albero dei dispositivi (DTB) o un'immagine overlay di configurazione avanzata e interfaccia di alimentazione (ACPI). Quando questi dispositivi avviano il sistema di ripristino, il bootloader può caricare l'immagine in overlay compatibile con l'immagine di ripristino. I dispositivi che supportano gli aggiornamenti A/B (seamless) devono utilizzare il recupero come avvio anziché una partizione di recupero separata (per maggiori dettagli, consulta Implementazione degli aggiornamenti A/B).

Le opzioni per includere un DTBO/ACPIO di recupero nell'immagine di avvio/recupero differiscono a seconda delle release di Android.

Release	Aggiorna schema	Conformità GKI	Versione dell'intestazione di avvio (dispositivi di lancio)	Versione dell'intestazione di avvio (dispositivi in fase di upgrade)	Immagine di ripristino dedicata richiesta
11	A/B, A/B virtuale	Sì	3^*	N/D	No
	A/B, A/B virtuale	No	2, 3	0, 1, 2, 3	No
	non A/B	Sì	3	N/D	Sì
	non A/B	No	2, 3	0, 1, 2, 3	Sì
10 (Q)	A/B	N/D	2	0, 1, 2	No
	non A/B	N/D	2	0, 1, 2	Sì
9 (R)	A/B	N/D	1	0, 1	No
	non A/B	N/D	1	0, 1	Sì
8 (O)	A/B	N/D	N/A (considerato 0)	N/A (considerato 0)	No
	non A/B	N/D	N/A (considerato 0)	N/A (considerato 0)	Sì

* I dispositivi A/B con Android 11 o versioni successive e che utilizzano l'immagine del kernel generico (GKI) devono utilizzare una versione dell'intestazione di avvio principale di 3 per essere compatibili con la partizione di avvio del fornitore.

Punti chiave:

• I dispositivi A/B non devono specificare un'immagine di ripristino perché gli aggiornamenti A/B utilizzano due insiemi di partizioni (incluse boot e dtbo) e passano da una all'altra durante gli aggiornamenti, eliminando la necessità di un'immagine di ripristino. I dispositivi A/B possono ancora utilizzare un'immagine di ripristino dedicata.

• I dispositivi non A/B lanciati con Android 11 o versioni successive e che utilizzano una versione dell'intestazione di avvio 3 devono specificare esplicitamente una versione dell'intestazione di avvio 2 per l'immagine di recupero separatamente. Ad esempio:

  BOARD_RECOVERY_MKBOOTIMG_ARGS := --header_version 2
  

• Per le architetture che non supportano le strutture ad albero dei dispositivi, l'immagine di ripristino può includere un'immagine ACPIO anziché un'immagine DTBO.

Informazioni sugli errori OTA e sulle immagini di ripristino

Per evitare errori over-the-air (OTA) su dispositivi non A/B, l'immagine di ripristino deve essere autosufficiente e indipendente da altre immagini. Durante un aggiornamento OTA, se si verifica un problema dopo l'aggiornamento dell'immagine in overlay (ma prima del completamento dell'aggiornamento completo), il dispositivo tenta di avviarsi in modalità di ripristino per completare l'aggiornamento OTA. Tuttavia, poiché la partizione overlay è già stata aggiornata, potrebbe verificarsi una mancata corrispondenza con l'immagine di ripristino (che non è stata ancora aggiornata).

Per evitare che il recupero dipenda dalla partizione DTBO/ACPIO durante un update, i dispositivi non A/B con Android 9 o versioni successive possono specificare un'immagine DTBO/ACPIO di recupero contenente le informazioni dell'immagine in overlay come sezione separata nel formato dell'immagine di avvio (deve essere utilizzata una versione del header di avvio 1 o 2).

Modifiche all'immagine di avvio

Per consentire all'immagine di ripristino di contenere il DTBO o l'ACPIO di ripristino su dispositivi non A/B con Android 9 o versioni successive, aggiorna la struttura dell'immagine di avvio come segue.

Sezione Immagine di avvio	Numero di pagine
Intestazione del boot (1 pagina)	1
Kernel (pagine L)	l = (kernel_size + page_size - 1) / page_size
Ramdisk (m pagine)	m = (ramdisk_size + page_size - 1) / page_size
Bootloader di secondo livello (n pagine)	n = (second_size + page_size - 1) / page_size
Recupero DTBO o ACPIO (o pagine)	o = (recovery_[dtbo|acpio]_size + page_size - 1) / page_size

Per maggiori dettagli sugli argomenti dello strumento mkbootimg per specificare la versione dell'intestazione dell'immagine di avvio e i percorsi dell'immagine overlay, consulta Controllo delle versioni dell'intestazione dell'immagine di avvio.

Implementare DTBO

I dispositivi non A/B con Android 9 o versioni successive possono compilare la sezione recovery_dtbo dell'immagine di ripristino. Per includere l'immagine recovery_dtbo in recovery.img, nel dispositivo BoardConfig.mk:

• Imposta la configurazione BOARD_INCLUDE_RECOVERY_DTBO su true:

   BOARD_INCLUDE_RECOVERY_DTBO := true
  

• Estendi la variabile BOARD_MKBOOTIMG_ARGS per specificare la versione dell'intestazione dell'immagine di avvio:

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

• Assicurati che la variabile BOARD_PREBUILT_DTBOIMAGE sia impostata sul percorso dell'immagine DTBO. Il sistema di compilazione di Android utilizza la variabile per impostare l'argomento recovery_dtbo dello strumento mkbootimg durante la creazione dell'immagine di ripristino.

Se le variabili BOARD_INCLUDE_RECOVERY_DTBO, BOARD_MKBOOTIMG_ARGS e BOARD_PREBUILT_DTBOIMAGE sono impostate correttamente, il sistema di build Android include il DTBO specificato dalla variabile BOARD_PREBUILT_DTBOIMAGE in recovery.img.

Implementare ACPIO

I dispositivi non A/B con Android 9 o versioni successive possono utilizzare un'immagine overlay ACPIO (anziché un'immagine DTBO) e possono completare la sezione recovery_acpio (anziché la sezione recovery_dtbo) dell'immagine di ripristino. Per includere l'immagine recovery_acpio in recovery.img, nel dispositivo BoardConfig.mk:

• Imposta la configurazione BOARD_INCLUDE_RECOVERY_ACPIO su true:

  BOARD_INCLUDE_RECOVERY_ACPIO := true
  

• Estendi la variabile BOARD_MKBOOTIMG_ARGS per specificare la versione dell'intestazione dell'immagine di avvio. La variabile deve essere maggiore o uguale a 1 per supportare il recupero ACPIO.

  BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
  

• Assicurati che la variabile BOARD_RECOVERY_ACPIO sia impostata sul percorso dell'immagine ACPIO. Il sistema di build Android utilizza la variabile per impostare l'argomento recovery_acpio dello strumento mkbootimg durante la creazione dell'immagine di ripristino.

Se le variabili BOARD_INCLUDE_RECOVERY_ACPIO, BOARD_MKBOOTIMG_ARGS e BOARD_RECOVERY_ACPIO sono impostate correttamente, il sistema di compilazione Android include l'ACPIO specificato dalla variabile BOARD_RECOVERY_ACPIO in recovery.img.