Gerar snapshots do fornecedor

O Android 11 oferece suporte a artefatos de build de instantâneos do VNDK e a instantâneos do fornecedor, que podem ser usados para criar vendor.img, independente da versão do Android na árvore de origem. Isso permite versões mistas de imagens, como um fornecedor antigo e uma imagem do sistema mais recente.

As versões de imagem mistas não são compatíveis com o seguinte:

  • Android.mk. Como o Soong gera o snapshot do fornecedor, os módulos definidos em Android.mk não são capturados como um snapshot do fornecedor. Os módulos proprietários do SoC em Android.mk também não têm garantia de funcionamento.

  • Limpador. Os snapshots do fornecedor e do VNDK não oferecem suporte ao limpador, já que as variantes do limpador precisam ser criadas separadamente.

Sobre os snapshots do fornecedor

Um snapshot do fornecedor é um snapshot de propriedade do OEM. É um conjunto de módulos C++ pré-criados instalados no /vendor, mas mantidos no AOSP. Sem capturar um snapshot do fornecedor da versão anterior do Android, o upgrade para uma nova versão do Android pode corromper a partição do fornecedor, já que os módulos de snapshot do fornecedor podem ser removidos ou mudados sem a compatibilidade com a API ou ABI.

Um snapshot de fornecedor contém os seguintes módulos no AOSP.

  • Bibliotecas compartilhadas, estáticas e de cabeçalho com vendor: true ou vendor_available: true
  • Bibliotecas estáticas do VNDK com vendor_available: true
  • Arquivos executáveis e de objeto com vendor: true ou vendor_available: true

Os módulos nos diretórios abaixo são considerados códigos de hardware de propriedade do SoC e são ignorados.

  • device/
  • vendor/
  • hardware/, exceto
    • hardware/interfaces
    • hardware/libhardware
    • hardware/libhardware_legacy

Os códigos de hardware pertencentes ao SoC também podem existir em outros diretórios. No momento, os snapshots do fornecedor não são compatíveis com essas configurações.

Criar snapshots do fornecedor

Crie um snapshot do fornecedor usando os comandos a seguir.

. build/envsetup.sh
lunch target
m dist vendor-snapshot

Esses comandos criam um arquivo vendor-$(TARGET_DEVICE).zip em $DIST_DIR. O exemplo a seguir mostra um arquivo ZIP de snapshot do fornecedor:

vendor-$(TARGET_DEVICE).zip
├── arch-arm64-armv8-a
│   ├── binary         -> binary files, *.json files
│   ├── header         -> *.json files
│   ├── object         -> *.o files, *.json files
│   ├── shared         -> *.so files, *.json files
│   └── static         -> *.a files, *.json files
├── arch-arm-armv8-a   -> (arch-arm64-armv8-a)
├── configs            -> *.rc files, *.xml files
├── include            -> exported header files (*.h, *.hh, etc.)
└── NOTICE_FILES       -> license txt files
  • Os arquivos JSON contêm flags, como nome do módulo, diretórios exportados, arquivos init_rc e vintf_fragments.
  • O diretório configs contém arquivos .rc e .xml das sinalizações init_rc e vintf_fragments.

Instalar snapshots do fornecedor

Para instalar um snapshot do fornecedor, navegue até o diretório de destino e use os comandos abaixo.

python3 development/vendor_snapshot/update.py --local $DIST_DIR --install-dir \
    vendor/vendor name/vendor_snapshot VER

Esse comando gera /vendor/vendor name/vendor_snapshot/vVER/$(TARGET_ARCH)/Android.bp. O exemplo a seguir mostra a estrutura de diretórios de um snapshot do fornecedor:

vendor/vendor name/vendor_snapshot/
├── v30
│   ├── arm64
│   │   ├── arch-arm64-armv8-a
│   │   │   ├── binary         -> (prebuilt libs)
│   │   │   ├── object         -> (prebuilt libs)
│   │   │   ├── shared         -> (prebuilt libs)
│   │   │   └── static         -> (prebuilt libs)
│   │   ├── arch-arm-armv8-a   -> (same as above)
│   │   ├── configs            -> (config files)
│   │   ├── include            -> (exported header files)
│   │   ├── NOTICE_FILES       -> (license files)
│   │   └── Android.bp         -> (snapshot modules)
│   ├── arm                    -> (same as above)
│   ├── x86_64                 -> (same as above)
│   └── x86                    -> (same as above)
└── (other vendor versions)    -> (same as above)

Criar imagens do fornecedor

Usando artefatos de build de snapshots do VNDK e um snapshot do fornecedor, é possível criar vendor.img, independente da versão do Android na árvore de origem, o que possibilita a criação de versões mistas de imagens. Depois de instalar os snapshots do VNDK e do fornecedor, defina BOARD_VNDK_VERSION como a versão do fornecedor. Exemplo:

# BoardConfig.mk
BOARD_VNDK_VERSION := 29

Quando BOARD_VNDK_VERSION é definido como um valor diferente de current, o sistema de build:

  • Ativa os módulos de snapshot do VNDK e do fornecedor de BOARD_VNDK_VERSION. Cada módulo de snapshot substitui um módulo de origem C++ com o mesmo nome.
  • Define ro.vndk.version como BOARD_VNDK_VERSION.
  • Instala os módulos de snapshot do VNDK de BOARD_VNDK_VERSION para system_ext.