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 que foram lançados com suporte a partições dinâmicas, para dispositivos com Android 9 e versões anteriores.

Contexto

Há uma partição super no dispositivo. Essa partição não tem o sufixo de slot. O dispositivo de bloco precisa existir junto 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 como 0 e 1, correspondentes aos slots A/B para partições. Nesta página, os slots de metadados são chamados de Metadados S (origem) e Metadados T (destino). Da mesma forma, as partições são chamadas de system_s, vendor_t e assim por diante.

Antes do upgrade, o Metadata S 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ê os intervalos 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 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 pelo Bar
  • Grupo foo_b (remanescente do upgrade anterior)
  • Grupo bar_b (remanescente do upgrade anterior)
• Metadados 1
  • Grupo foo_a (remanescente do upgrade anterior)
  • Grupo bar_a (remanescente do upgrade 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 pelo Bar

Use 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. Inicialize os metadados de partição super.
   1. Carregue os intervalos das partições dinâmicas de origem do Metadata S. Seja M os metadados carregados.
   2. Remova os grupos e partições de destino (por exemplo, foo_t, bar_t) de M para que ele 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. Escreva M para Metadata T.
   5. Mapeie as partições adicionadas no mapeador de dispositivos como graváveis.
2. Aplique a atualização nos dispositivos bloqueados.
   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 desmonte-as.
3. Remova o mapeamento das 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 em um dispositivo A/B 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 ver 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;
}