OTA para dispositivos A/B com partições dinâmicas

O Android 10 oferece suporte a partições dinâmicas, um sistema de particionamento no espaço do usuário que pode criar, redimensionar e destruir partições durante atualizações OTA.

Esta página descreve como redimensionar partições dinâmicas durante uma atualização para dispositivos A/B lançados com suporte a partições dinâmicas, para dispositivos com Android 9 e anteriores.

Contexto

Há uma partição super no dispositivo. Essa partição não tem um slot de sufixo. O dispositivo de bloco precisa existir com a entrada blk_device para /misc em fstab. Por exemplo, se o arquivo fstab listar:

/dev/block/bootdevice/by-name/misc    /misc    # Other fields

Em seguida, o dispositivo de blocos para super precisa existir em /dev/block/bootdevice/by-name/super, mas a partição super não precisa estar listada no arquivo fstab.

Na partição super, há dois slots de metadados, numerados como 0 e 1, que correspondem aos slots A/B das partições. Nesta página, os slots de metadados são chamados de Metadata S (origem) e Metadata T (destino). Da mesma forma, as partições são chamadas de system_s, vendor_t e assim por diante.

Antes do upgrade, o S de "metadados" contém as informações das partições dinâmicas em uso (normalmente, system_s, vendor_s, product_s e assim por diante). O sistema lê as extensões dessas partições durante a atualização, então elas não podem ser excluídas.

As partições pertencem a grupos de atualização. Consulte Como implementar partições dinâmicas para mais detalhes.

Confira a seguir um exemplo de metadados em um dispositivo.

• Metadados 0
  • Grupo foo_a
    • Partição system_a
    • Partição product_services_a
    • Outras partições atualizadas por Foo
  • Barra de grupo_a
    • Partição vendor_a
    • Partição product_a
    • Outras partições atualizadas por Barra
  • Grupo foo_b (restante da atualização anterior)
  • Grupo bar_b (restante do upgrade anterior)
• Metadados 1
  • Grupo foo_a (restante da atualização anterior)
  • Grupo bar_a (restante da atualização anterior)
  • Grupo foo_b
    • Partição system_b
    • Partição product_services_b
    • Outras partições atualizadas pelo Foo
  • Grupo bar_b
    • Partição vendor_b
    • Partição product_b
    • Outras partições atualizadas por barra

É possível usar a ferramenta lpdump (código-fonte em system/extras/partition_tools) para despejar os metadados no dispositivo. Exemplo:

lpdump --slot 0 /dev/block/bootdevice/by-name/super
lpdump --slot 1 /dev/block/bootdevice/by-name/super

Atualizar fluxo

1. Inicializar os metadados da partição super.
   1. Carregar as extensões das partições dinâmicas de origem dos metadados S. Vamos chamar M de metadados carregados.
   2. Remova os grupos e partições de destino (por exemplo, foo_t, bar_t) de M para que M contenha apenas partições e grupos com o sufixo _s.
   3. Adicione grupos e partições de destino de acordo com o campo dynamic_partition_metadata no manifesto de atualização.
      O tamanho de cada partição pode ser encontrado em new_partition_info.
   4. Grave M em T de metadados.
   5. Mapeie as partições adicionadas no mapeador de dispositivos como graváveis.
2. Aplique a atualização nos dispositivos de bloco.
   1. Se necessário, mapeie as partições de origem no mapeador de dispositivos como somente leitura. Isso é necessário para o sideload porque as partições de origem não são mapeadas antes da atualização.
   2. Aplique uma atualização completa ou delta a todos os dispositivos em bloco no slot de destino.
   3. Ative as partições para executar o script pós-instalação e, em seguida, desative-as.
3. Desmapear as partições de destino.

Antes e depois da atualização, as seguintes propriedades do sistema precisam ter os respectivos valores:

ro.boot.dynamic_partitions=true
ro.boot.dynamic_partitions_retrofit=true

Adicionar grupos e partições ao manifesto de atualização

Ao realizar uma atualização OTA em um dispositivo A/B com partições dinâmicas ou que está adicionando suporte a partições dinâmicas, é necessário adicionar grupos e partições ao manifesto de atualização. O snippet abaixo mostra mais informações sobre o manifesto de atualização para oferecer suporte a partições dinâmicas. Consulte update_metadata.proto para conferir uma documentação detalhada sobre cada campo.

message DeltaArchiveManifest {
    optional DynamicPartitionMetadata dynamic_partition_metadata;
}

message DynamicPartitionMetadata {
    repeated DynamicPartitionGroup groups;
}

message DynamicPartitionGroup {
    required string name;
    optional uint64 size; // maximum size of group
    repeated string partition_names;
}