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. Esta 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

O dispositivo de bloco para super precisa existir em /dev/block/bootdevice/by-name/super, mas a partição super não precisa ser listada no arquivo fstab.

Na partição super, há dois slots de metadados, numerados 0 e 1, correspondentes 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 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
  • Grupo bar_a
    • Partição vendor_a
    • Partição product_a
    • Outras partições atualizadas por Bar
  • Grupo foo_b (restante da atualização anterior)
  • Grupo bar_b (restante da atualização 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 por Foo
  • Grupo bar_b
    • Partição vendor_b
    • Partição product_b
    • Outras partições atualizadas por Bar

É 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

Fluxo de atualização

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. Gravar M em Metadata T.
   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 de bloco no slot de destino.
   3. Monte as partições para executar o script pós-instalação e, em seguida, desmonte as partições.
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 a documentação detalhada de 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;
}