Questa pagina è stata tradotta dall'API Cloud Translation.

Strumento di definizione VNDK

Lo strumento di definizione VNDK aiuta i fornitori a migrare il loro albero di origine a un Ambiente Android 8.0. Questo strumento scansiona i file binari nel sistema e nel fornitore risolve le dipendenze. In base al grafico delle dipendenze del modulo, strumento è anche in grado di rilevare violazioni dei concetti VNDK e insight/suggerimenti per lo spostamento dei moduli tra le partizioni. Se un sistema generico L'immagine (GSI) è specificata, lo strumento di definizione VNDK può confrontare il tuo sistema l'immagine con GSI e determinare le librerie estese.

Questa sezione illustra tre comandi utilizzati di frequente per la definizione di VNDK. questo strumento:

vndk. Compute VNDK_SP_LIBRARIES, VNDK_SP_EXT_LIBRARIES e EXTRA_VENDOR_LIBRARIES per la soluzione alternativa del sistema di compilazione in Android 8.0 e in alto.
check-dep. Controlla le dipendenze del modulo in violazione da moduli del fornitore alle librerie condivise di framework non idonee.
deps. Stampa le dipendenze tra le librerie condivise eseguibili.

Per maggiori dettagli sull'utilizzo dei comandi avanzati, consulta README.md nel repository VNDK Definition Tool.

VNDK

Il sottocomando vndk carica le librerie condivise e gli eseguibili dalla partizione di sistema e del fornitore, poi risolve il modulo per determinare le librerie che devono essere copiate /system/lib[64]/vndk-sp-${VER} e /vendor/lib[64]. Le opzioni per il sottocomando vndk includono:

Opzione	Descrizione
`--system`	Punta a una directory contenente i file che risiedono nel sistema della partizione di testo.
`--vendor`	Posiziona il puntatore del mouse su una directory contenente i file che risiedono in un fornitore della partizione di testo.
`--aosp-system`	Posiziona il puntatore del mouse su una directory contenente i file che risiedono nella cartella l'immagine di sistema (GSI).
`--load-extra-deps`	Posiziona il puntatore del mouse su un file che descriva le dipendenze implicite, ad esempio `dlopen()`.

Ad esempio, per calcolare i set di librerie VNDK, esegui questo comando Sottocomando 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

Specifica dipendenze aggiuntive con un formato file semplice. Ogni riga rappresenta un relazione, con il file prima dei due punti a seconda del file dopo I due punti. Ad esempio:

/system/lib/libart.so: /system/lib/libart-compiler.so

Questa riga indica allo strumento di definizione VNDK che libart.so dipende da libart-compiler.so.

Destinazione di installazione

Lo strumento di definizione VNDK elenca le librerie e le directory di installazione corrispondenti per le seguenti categorie:

Categoria	Directory
vndk_sp	Da installare in `/system/lib[64]/vndk-sp-${VER}`
Estensione_vndk_sp	Da installare in `/vendor/lib[64]/vndk-sp`
fornitori_aggiuntivi_libr	Da installare in `/vendor/lib[64]`

Crea modelli di sistema

Dopo aver raccolto gli output dallo strumento di definizione VNDK, un fornitore può creare Android.mk e compila VNDK_SP_LIBRARIES, VNDK_SP_EXT_LIBRARIES e EXTRA_VENDOR_LIBRARIES per automatizzare il processo per copiare le librerie nell'installazione designata destinazione.

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)),)

parte di assegno

Il sottocomando check-dep analizza i moduli del fornitore e ne controlla delle dipendenze. Se rileva violazioni, visualizza la dipendenza usi di librerie e simboli:

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

Ad esempio, il seguente output di esempio mostra una dipendenza in violazione da Da 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

Le opzioni per il sottocomando check-dep includono:

Opzione	Descrizione
`--tag-file`	Deve fare riferimento a un file di tag della libreria idoneo (descritto di seguito), che è un Foglio di lavoro fornito da Google che descrive le categorie di framework condivisi librerie.
`--module-info`	Punta al `module-info.json` generato dalla build Android di un sistema operativo completo. Consente allo strumento di definizione di VNDK di associare i moduli binari al codice sorgente. le API nel tuo codice.

File di tag della libreria idoneo

Google fornisce un foglio di lavoro VNDK idoneo (ad es. eligible-list.csv) che codifica le librerie condivise del framework che può essere utilizzato dai moduli dei fornitori:

Tagga	Descrizione
LL-NDK	Librerie condivise con ABI/API stabili che possono essere utilizzate da entrambi framework e moduli del fornitore.
LL-NDK-Privato	Dipendenze private delle librerie LL-NDK. I moduli dei fornitori non devono accedere direttamente dalle librerie.
VNDK-SP	Dipendenze delle librerie condivise del framework SP-HAL.
VNDK-SP-privata	Dipendenze VNDK-SP che non sono accessibili direttamente a tutti i fornitori moduli.
VNDK	Librerie condivise di framework disponibili per i moduli del fornitore (ad eccezione SP-HAL e SP-HAL-Dep).
VNDK-privata	Dipendenze VNDK che non sono accessibili direttamente a tutti i fornitori moduli.
SOLO FWK	Librerie condivise solo con framework a cui il fornitore non deve accedere (né direttamente né indirettamente).
SOLO FWK-RS	Librerie condivise solo con framework a cui il fornitore non deve accedere (ad eccezione degli utilizzi RS).

La tabella seguente descrive i tag utilizzati per le librerie condivise del fornitore:

Tagga	Descrizione
SP-HAL	Librerie condivise di implementazione HAL con la stessa procedura.
SP-HAL-Dep	Dipendenze delle librerie condivise del fornitore SP-HAL (chiamate anche dipendenze SP-HAL esclusi LL-NDK e VNDK-SP).
SOLO VND	Librerie condivise invisibili tramite framework a cui non devono accedere i moduli del framework. Le librerie VNDK estese copiate sono contrassegnate come SOLO VND.

Relazioni tra i tag:

Figura 1. Relazioni tra i tag.

deps

Per eseguire il debug delle dipendenze della libreria, il sottocomando deps visualizza le dipendenze del modulo:

./vndk_definition_tool.py deps \
    --system ${ANDROID_PRODUCT_OUT}/system \
    --vendor ${ANDROID_PRODUCT_OUT}/vendor

L'output è costituito da più righe. La riga senza carattere di tabulazione inizia una nuova sezione. La riga con il carattere di tabulazione dipende dalla sequenza . Ad esempio:

/system/lib/ld-android.so
/system/lib/libc.so
        /system/lib/libdl.so

Questo output mostra che ld-android.so non ha una dipendenza e libc.so dipende da libdl.so.

Quando specifichi l'opzione --revert, deps il sottocomando stampa gli utilizzi delle librerie (invertito delle dipendenze):

./vndk_definition_tool.py deps \
    --revert \
    --system ${ANDROID_PRODUCT_OUT}/system \
    --vendor ${ANDROID_PRODUCT_OUT}/vendor

Ad esempio:

/system/lib/ld-android.so
        /system/lib/libdl.so

Questo output mostra che ld-android.so è utilizzato da libdl.so, ovvero libdl.so dipende da ld-android.so. Inoltre, questo output mostra che libdl.so è l'unico utente di ld-android.so.

Quando specifichi l'opzione --symbol, l'elemento deps stampa i simboli utilizzati:

./vndk_definition_tool.py deps \
    --symbol \
    --system ${ANDROID_PRODUCT_OUT}/system \
    --vendor ${ANDROID_PRODUCT_OUT}/vendor

Ad esempio:

/system/lib/libc.so
        /system/lib/libdl.so
                android_get_application_target_sdk_version
                dl_unwind_find_exidx
                dlclose
                dlerror
                dlopen
                dlsym

Questo output mostra che libc.so dipende da sei funzioni esportate da libdl.so. Se sia l'opzione --symbol che Vengono specificate l'opzione --revert, i simboli utilizzati dall'utente vengono stampati.