Strumento di definizione VNDK

Lo strumento di definizione VNDK aiuta i fornitori a migrare il proprio albero di origine in un ambiente Android 8.0. Questo strumento esegue la scansione dei file binari nel sistema e delle immagini del fornitore, quindi risolve le dipendenze. In base al grafico delle dipendenze dei moduli, lo strumento può anche rilevare violazioni dei concetti VNDK e fornire informazioni/suggerimenti per lo spostamento dei moduli tra le partizioni. Se viene specificata un'immagine di sistema generica (GSI), lo strumento di definizione VNDK può confrontare l'immagine del sistema con GSI e determinare le librerie estese.

Questa sezione copre tre comandi utilizzati di frequente per lo strumento di definizione VNDK:

• vndk . Calcola VNDK_SP_LIBRARIES, VNDK_SP_EXT_LIBRARIES e EXTRA_VENDOR_LIBRARIES per una soluzione alternativa al sistema di compilazione in Android 8.0 e versioni successive.
• check-dep . Controllare le dipendenze dei moduli in violazione dai moduli del fornitore alle librerie condivise del framework non idonee.
• deps . Stampa le dipendenze tra le librerie condivise e gli eseguibili.

Per ulteriori dettagli sull'utilizzo avanzato dei comandi, fare riferimento al file README.md nel repository VNDK Definition Tool.

vndk

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

Ad esempio, per calcolare i set di librerie VNDK, eseguire il seguente 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 extra con un formato file semplice. Ogni riga rappresenta una relazione, con il file prima dei due punti che dipende dal file dopo i due punti. Per esempio:

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

Questa riga consente allo strumento di definizione VNDK di sapere 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:

Costruisci modelli di sistema

Dopo aver raccolto gli output dallo strumento di definizione VNDK, un fornitore può creare un Android.mk e compilare VNDK_SP_LIBRARIES , VNDK_SP_EXT_LIBRARIES e EXTRA_VENDOR_LIBRARIES per automatizzare il processo di copia delle librerie nella destinazione di installazione designata.

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

check-dip

Il sottocomando check-dep analizza i moduli del fornitore e controlla le loro dipendenze. Se rileva violazioni, stampa la libreria dipendente in violazione e gli usi dei 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 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:

File di tag della libreria idoneo

Google fornisce un foglio di calcolo VNDK idoneo (ad esempio eligible-list.csv ) che contrassegna le librerie condivise del framework che possono essere utilizzate dai moduli del fornitore:

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

Relazioni tra i tag:

dipende

Per eseguire il debug delle dipendenze della libreria, il sottocomando deps stampa 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 un carattere di tabulazione dipende dalla sezione precedente. Per 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 si specifica l'opzione --revert , il sottocomando deps stampa gli utilizzi delle librerie (dipendenze invertite):

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

Per esempio:

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

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

Quando si specifica l'opzione --symbol , il sottocomando deps stampa i simboli utilizzati:

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

Per 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 6 funzioni esportate da libdl.so . Se vengono specificate sia l'opzione --symbol che l'opzione --revert , verranno stampati i simboli utilizzati dall'utente.