Imagens de recuperação

Em dispositivos não A/B, a imagem de recuperação precisa conter informações de um blob da árvore de dispositivos (DTB, na sigla em inglês) ou uma imagem de sobreposição da Configuração avançada e interface de energia (ACPI, na sigla em inglês). Quando esses dispositivos são inicializados na recuperação, o carregador de inicialização pode carregar a imagem de sobreposição compatível com a imagem de recuperação. Dispositivos com suporte a atualizações A/B (integradas) precisam usar a recuperação como inicialização em vez de uma partição de recuperação separada. Para mais detalhes, consulte Como implementar atualizações A/B.

As opções para incluir um DTBO/ACPIO de recuperação como parte da imagem de inicialização/recuperação diferem entre as versões do Android.

Versão	Atualizar esquema	Conformidade com a GKI	Versão do cabeçalho de inicialização (dispositivos de inicialização)	Versão do cabeçalho de inicialização (upgrade de dispositivos)	É necessária uma imagem de recuperação dedicada
11	A/B, A/B virtual	Sim	3*	N/A	Não
	A/B, A/B virtual	Não	2, 3	0, 1, 2, 3	Não
	não A/B	Sim	3	N/A	Sim
	não-A/B	Não	2, 3	0, 1, 2, 3	Sim
10 (T)	A/B	N/A	2	0, 1, 2	Não
	não-A/B	N/A	2	0, 1 e 2	Sim
9 (P)	A/B	N/A	1	0, 1	Não
	não-A/B	N/A	1	0, 1	Sim
8 (O)	A/B	N/A	N/D (considerado 0)	N/D (considerado 0)	Não
	não-A/B	N/A	N/D (considerado 0)	N/A (considerado 0)	Sim

* Os dispositivos A/B com o Android 11 ou versões mais recentes e que usam a imagem genérica do kernel (GKI, na sigla em inglês) precisam usar uma versão principal do cabeçalho de inicialização 3 para serem compatíveis com a partição de inicialização do fornecedor.

Pontos importantes:

• Os dispositivos A/B não precisam especificar uma imagem de recuperação porque as atualizações A/B usam dois conjuntos de partições (incluindo boot e dtbo) e alternam entre eles durante as atualizações, eliminando a necessidade de uma imagem de recuperação. Os dispositivos A/B ainda podem usar uma imagem de recuperação dedicada.

• Os dispositivos que não são A/B lançados com o Android 11 ou mais recente e que usam a versão 3 do cabeçalho de inicialização precisam especificar explicitamente uma versão de 2 para a imagem de recuperação separadamente. Exemplo:

  BOARD_RECOVERY_MKBOOTIMG_ARGS := --header_version 2
  

• Para arquiteturas que não oferecem suporte a árvores de dispositivos, a imagem de recuperação pode incluir uma imagem ACPIO em vez de uma DTBO.

Sobre falhas de OTA e imagens de recuperação

Para evitar falhas over-the-air (OTA) em dispositivos não A/B, a imagem de recuperação precisa ser independente de outras imagens. Durante uma atualização OTA, se um problema ocorrer após a atualização da imagem de sobreposição (mas antes de concluir a atualização completa), o dispositivo tentará inicializar no modo de recuperação para concluir a atualização OTA. No entanto, como a partição de sobreposição já foi atualizada, pode ocorrer uma incompatibilidade com a imagem de recuperação (que ainda não foi atualizada).

Para evitar que a recuperação dependa da partição DTBO/ACPIO durante uma atualização, dispositivos não A/B com o Android 9 ou versões mais recentes podem especificar uma imagem DTBO/ACPIO de recuperação contendo informações da imagem de sobreposição como uma seção separada no formato da imagem de inicialização (é necessário usar uma versão do cabeçalho de inicialização 1 ou 2).

Alterações na imagem de inicialização

Para permitir que a imagem de recuperação contenha o DTBO ou ACPIO de recuperação em dispositivos não A/B com o Android 9 ou versões mais recentes, atualize a estrutura da imagem de inicialização da seguinte maneira:

Seção de imagem de inicialização	Número de páginas
Cabeçalho de inicialização (1 página)	1
Kernel (páginas L)	l = (kernel_size + page_size - 1) / page_size
Ramdisk (páginas m)	m = (ramdisk_size + page_size - 1) / page_size
Carregador de inicialização de segunda fase (n páginas)	n = (second_size + page_size - 1) / page_size
DTBO de recuperação ou ACPIO (páginas o)	o = (recovery_[dtbo|acpio]_size + page_size - 1) / page_size

Para detalhes sobre os argumentos da ferramenta mkbootimg para especificar a versão do cabeçalho da imagem de inicialização e os caminhos de imagem de sobreposição, consulte Controle de versões do cabeçalho da imagem de inicialização.

Implementar DTBO

Dispositivos não A/B com o Android 9 ou versões mais recentes podem preencher a seção recovery_dtbo da imagem de recuperação. Para incluir a imagem recovery_dtbo em recovery.img, no dispositivo BoardConfig.mk:

• Defina a configuração BOARD_INCLUDE_RECOVERY_DTBO como true:

   BOARD_INCLUDE_RECOVERY_DTBO := true
  

• Estenda a variável BOARD_MKBOOTIMG_ARGS para especificar a versão do cabeçalho da imagem de inicialização:

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

• Verifique se a variável BOARD_PREBUILT_DTBOIMAGE está definida como o caminho da imagem DTBO. O sistema de build do Android usa a variável para definir o argumento recovery_dtbo da ferramenta mkbootimg durante a criação da imagem de recuperação.

Se as variáveis BOARD_INCLUDE_RECOVERY_DTBO, BOARD_MKBOOTIMG_ARGS e BOARD_PREBUILT_DTBOIMAGE estiverem definidas corretamente, o sistema de build do Android vai incluir o DTBO especificado pela variável BOARD_PREBUILT_DTBOIMAGE em recovery.img.

Implementar a ACPIO

Dispositivos que não são A/B com o Android 9 ou versões mais recentes podem usar uma imagem de sobreposição ACPIO (em vez de uma DTBO) e preencher a seção recovery_acpio (em vez da seção recovery_dtbo) da imagem de recuperação. Para incluir a imagem recovery_acpio em recovery.img, no dispositivo BoardConfig.mk:

• Defina a configuração BOARD_INCLUDE_RECOVERY_ACPIO como true:

  BOARD_INCLUDE_RECOVERY_ACPIO := true
  

• Estenda a variável BOARD_MKBOOTIMG_ARGS para especificar a versão do cabeçalho da imagem de inicialização. A variável precisa ser maior ou igual a 1 para oferecer suporte à recuperação ACPIO.

  BOARD_MKBOOTIMG_ARGS += --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
  

• Verifique se a variável BOARD_RECOVERY_ACPIO está definida como o caminho da imagem ACPIO. O sistema de build do Android usa a variável para definir o argumento recovery_acpio da ferramenta mkbootimg durante a criação da imagem de recuperação.

Se as variáveis BOARD_INCLUDE_RECOVERY_ACPIO, BOARD_MKBOOTIMG_ARGS e BOARD_RECOVERY_ACPIO estiverem definidas corretamente, o sistema de build do Android vai incluir a ACPIO especificada pela variável BOARD_RECOVERY_ACPIO em recovery.img.