A ferramenta de definição do VNDK ajuda os fornecedores a migrar a árvore de origem para um Ambiente Android 8.0. Essa ferramenta verifica os arquivos binários do sistema e do fornecedor as imagens resolvem as dependências. Com base no gráfico de dependências do módulo, a também pode detectar violações dos conceitos do VNDK e fornecer insights/sugestões para mover módulos entre partições. Se um sistema genérico Se a imagem (GSI) for especificada, a ferramenta de definição do VNDK poderá comparar seu sistema imagem com a GSI e determinar as bibliotecas estendidas.
Esta seção aborda três comandos usados com frequência para a definição do VNDK ferramenta:
vndk
: Compute VNDK_SP_LIBRARIES, VNDK_SP_EXT_LIBRARIES, e EXTRA_VENDOR_LIBRARIES para soluções alternativas do sistema de build no Android 8.0 e mais alto.check-dep
: Verifique as dependências do módulo com violação no módulos de fornecedores para bibliotecas compartilhadas de framework não qualificadas.deps
: Mostre as dependências entre as bibliotecas compartilhadas e executáveis.
Para mais detalhes sobre o uso de comandos avançados, consulte README.md (em inglês) no repositório da ferramenta de definição do VNDK.
vndk.
O subcomando vndk
carrega as bibliotecas compartilhadas e os executáveis
da partição do sistema e das partições do fornecedor, depois resolve
dependências para determinar as bibliotecas que devem ser copiadas
/system/lib[64]/vndk-sp-${VER}
e /vendor/lib[64]
.
As opções para o subcomando vndk
incluem:
Opção | Descrição |
---|---|
--system |
Apontar para um diretório que contém os arquivos que residem no sistema partição. |
--vendor |
Apontar para um diretório que contenha os arquivos que residem em um fornecedor partição. |
--aosp-system |
Apontar para um diretório que contenha os arquivos que residem no namespace imagem do sistema (GSI). |
--load-extra-deps |
Aponte para um arquivo que descreva as dependências implícitas, como:
dlopen() : |
Por exemplo, para calcular os conjuntos da biblioteca VNDK, execute o seguinte
Subcomando vndk
:
./vndk_definition_tool.py vndk \
--system ${ANDROID_PRODUCT_OUT}/system \
--vendor ${ANDROID_PRODUCT_OUT}/vendor \
--aosp-system ${ANDROID_PRODUCT_OUT}/../generic_arm64_ab/system\
--load-extra-deps dlopen.dep
Especifique dependências extras com um formato de arquivo simples. Cada linha representa relação, com o arquivo antes dos dois pontos, dependendo do arquivo depois do dois-pontos. Exemplo:
/system/lib/libart.so: /system/lib/libart-compiler.so
Essa linha permite que a ferramenta de definição do VNDK saiba que libart.so
depende de libart-compiler.so
.
Destino da instalação
A ferramenta de definição do VNDK lista as bibliotecas e os diretórios de instalação correspondentes. das seguintes categorias:
Categoria | Diretório |
---|---|
Vndk_sp | É necessário instalar no /system/lib[64]/vndk-sp-${VER} |
vndk_sp_ext | É necessário instalar no /vendor/lib[64]/vndk-sp |
extra_vendor_libs | É necessário instalar no /vendor/lib[64] |
Criar modelos de sistema
Depois de coletar saídas da ferramenta de definição do VNDK, um fornecedor pode criar uma
Android.mk
e preencha VNDK_SP_LIBRARIES
,
VNDK_SP_EXT_LIBRARIES
e EXTRA_VENDOR_LIBRARIES
a
automatizar o processo de cópia de bibliotecas para a instalação designada
destino.
ifneq ($(filter $(YOUR_DEVICE_NAME),$(TARGET_DEVICE)),) VNDK_SP_LIBRARIES := ##_VNDK_SP_## VNDK_SP_EXT_LIBRARIES := ##_VNDK_SP_EXT_## EXTRA_VENDOR_LIBRARIES := ##_EXTRA_VENDOR_LIBS_## #------------------------------------------------------------------------------- # VNDK Modules #------------------------------------------------------------------------------- LOCAL_PATH := $(call my-dir) define define-vndk-lib include $$(CLEAR_VARS) LOCAL_MODULE := $1.$2 LOCAL_MODULE_CLASS := SHARED_LIBRARIES LOCAL_PREBUILT_MODULE_FILE := $$(TARGET_OUT_INTERMEDIATE_LIBRARIES)/$1.so LOCAL_STRIP_MODULE := false LOCAL_MULTILIB := first LOCAL_MODULE_TAGS := optional LOCAL_INSTALLED_MODULE_STEM := $1.so LOCAL_MODULE_SUFFIX := .so LOCAL_MODULE_RELATIVE_PATH := $3 LOCAL_VENDOR_MODULE := $4 include $$(BUILD_PREBUILT) ifneq ($$(TARGET_2ND_ARCH),) ifneq ($$(TARGET_TRANSLATE_2ND_ARCH),true) include $$(CLEAR_VARS) LOCAL_MODULE := $1.$2 LOCAL_MODULE_CLASS := SHARED_LIBRARIES LOCAL_PREBUILT_MODULE_FILE := $$($$(TARGET_2ND_ARCH_VAR_PREFIX)TARGET_OUT_INTERMEDIATE_LIBRARIES)/$1.so LOCAL_STRIP_MODULE := false LOCAL_MULTILIB := 32 LOCAL_MODULE_TAGS := optional LOCAL_INSTALLED_MODULE_STEM := $1.so LOCAL_MODULE_SUFFIX := .so LOCAL_MODULE_RELATIVE_PATH := $3 LOCAL_VENDOR_MODULE := $4 include $$(BUILD_PREBUILT) endif # TARGET_TRANSLATE_2ND_ARCH is not true endif # TARGET_2ND_ARCH is not empty endef $(foreach lib,$(VNDK_SP_LIBRARIES),\ $(eval $(call define-vndk-lib,$(lib),vndk-sp-gen,vndk-sp,))) $(foreach lib,$(VNDK_SP_EXT_LIBRARIES),\ $(eval $(call define-vndk-lib,$(lib),vndk-sp-ext-gen,vndk-sp,true))) $(foreach lib,$(EXTRA_VENDOR_LIBRARIES),\ $(eval $(call define-vndk-lib,$(lib),vndk-ext-gen,,true))) #------------------------------------------------------------------------------- # Phony Package #------------------------------------------------------------------------------- include $(CLEAR_VARS) LOCAL_MODULE := $(YOUR_DEVICE_NAME)-vndk LOCAL_MODULE_TAGS := optional LOCAL_REQUIRED_MODULES := \ $(addsuffix .vndk-sp-gen,$(VNDK_SP_LIBRARIES)) \ $(addsuffix .vndk-sp-ext-gen,$(VNDK_SP_EXT_LIBRARIES)) \ $(addsuffix .vndk-ext-gen,$(EXTRA_VENDOR_LIBRARIES)) include $(BUILD_PHONY_PACKAGE) endif # ifneq ($(filter $(YOUR_DEVICE_NAME),$(TARGET_DEVICE)),)
Confiança
O subcomando check-dep
verifica os módulos do fornecedor e os respectivos
dependências. Se detectar violações, ele vai mostrar o dependente
e usos de símbolos:
./vndk_definition_tool.py check-dep \
--system ${ANDROID_PRODUCT_OUT}/system \
--vendor ${ANDROID_PRODUCT_OUT}/vendor \
--tag-file eligible-list.csv \
--module-info ${ANDROID_PRODUCT_OUT}/module-info.json \
1> check_dep.txt \
2> check_dep_err.txt
Por exemplo, o exemplo de saída a seguir mostra uma dependência com violação de
De libRS_internal.so
a libmediandk.so
:
/system/lib/libRS_internal.so MODULE_PATH: frameworks/rs /system/lib/libmediandk.so AImageReader_acquireNextImage AImageReader_delete AImageReader_getWindow AImageReader_new AImageReader_setImageListener
As opções para o subcomando check-dep
incluem:
Opção | Descrição |
---|---|
--tag-file |
Deve consultar um arquivo de tag de biblioteca qualificado (descrito abaixo), que é um Planilha fornecida pelo Google que descrevia categorias de estrutura compartilhada bibliotecas. |
--module-info |
Aponta para o module-info.json gerado pelo build do Android
sistema. Ajuda a ferramenta de definição do VNDK a associar módulos binários à origem.
o código-fonte. |
Arquivo de tag de biblioteca qualificada
O Google fornece uma planilha do VNDK qualificada (por exemplo,
eligible-list.csv
) que marca as bibliotecas compartilhadas do framework que
podem ser usados pelos módulos do fornecedor:
Tag | Descrição |
---|---|
LL-NDK | Bibliotecas compartilhadas com ABIs/APIs estáveis que podem ser usadas por e módulos do fornecedor. |
LL-NDK-Private | Dependências particulares de bibliotecas LL-NDK. Os módulos do fornecedor não podem acessar diretamente essas bibliotecas. |
VNDK-SP | Dependências das bibliotecas compartilhadas do framework SP-HAL |
VNDK-SP-Privado | Dependências de VNDK-SP que não são acessíveis diretamente para todos os fornecedores módulos. |
VNDK | Bibliotecas compartilhadas de framework que estão disponíveis para módulos do fornecedor (exceto SP-HAL e SP-HAL-Dep). |
VNDK particular | Dependências de VNDK que não são diretamente acessíveis a todos os fornecedores módulos. |
SOMENTE FWK | Bibliotecas compartilhadas apenas de framework que não podem ser acessadas pelo fornecedor módulos (nem direta nem indiretamente). |
FWK-ONLY-RS | Bibliotecas compartilhadas apenas de framework que não podem ser acessadas pelo fornecedor (exceto para usos RS). |
A tabela a seguir descreve as tags usadas para as bibliotecas compartilhadas do fornecedor:
Tag | Descrição |
---|---|
HAL | Bibliotecas compartilhadas de implementação de HAL de mesmo processo. |
SP-HAL-Dep | Dependências de bibliotecas compartilhadas do fornecedor SP-HAL (também chamadas de dependências SP-HAL) excluindo o LL-NDK e o VNDK-SP). |
SOMENTE VND | Bibliotecas compartilhadas invisíveis de framework que não podem ser acessadas por módulos do framework. As bibliotecas VNDK estendidas copiadas são marcadas como VND-ONLY. |
Relações entre tags:
Figura 1. Relações entre tags.
dependências
Para depurar as dependências da biblioteca, o subcomando deps
é impresso.
as dependências do módulo:
./vndk_definition_tool.py deps \
--system ${ANDROID_PRODUCT_OUT}/system \
--vendor ${ANDROID_PRODUCT_OUT}/vendor
A saída consiste em várias linhas. A linha sem um caractere de tabulação inicia uma nova seção. A linha com o caractere de tabulação depende da nesta seção. Exemplo:
/system/lib/ld-android.so /system/lib/libc.so /system/lib/libdl.so
Essa saída mostra que ld-android.so
não tem uma dependência
e libc.so
depende de libdl.so
.
Ao especificar a opção --revert
, deps
o subcomando exibe os usos de bibliotecas (invertido
dependências):
./vndk_definition_tool.py deps \
--revert \
--system ${ANDROID_PRODUCT_OUT}/system \
--vendor ${ANDROID_PRODUCT_OUT}/vendor
Exemplo:
/system/lib/ld-android.so /system/lib/libdl.so
Esta saída mostra que ld-android.so
é usado pelo
libdl.so
, ou seja, libdl.so
depende
ld-android.so
: Além disso, esta saída mostra que
libdl.so
é o único usuário do ld-android.so
.
Ao especificar a opção --symbol
, o deps
subcomando imprime os símbolos que estão sendo usados:
./vndk_definition_tool.py deps \
--symbol \
--system ${ANDROID_PRODUCT_OUT}/system \
--vendor ${ANDROID_PRODUCT_OUT}/vendor
Exemplo:
/system/lib/libc.so /system/lib/libdl.so android_get_application_target_sdk_version dl_unwind_find_exidx dlclose dlerror dlopen dlsym
Esta saída mostra que libc.so
depende de seis funções exportadas
de libdl.so
. Se a opção --symbol
e
--revert
for especificada, os símbolos usados pelo usuário
são impressas.