Outil de définition VNDK

L'outil de définition VNDK aide les fournisseurs à migrer leur arborescence source vers un environnement Android 8.0. Cet outil analyse les fichiers binaires dans les images du système et du fournisseur, puis résout les dépendances. Sur la base du graphique de dépendance des modules, l'outil peut également détecter les violations des concepts VNDK et fournir des informations/suggestions pour déplacer les modules entre les partitions. Si une image système générique (GSI) est spécifiée, l'outil de définition VNDK peut comparer votre image système avec la GSI et déterminer les bibliothèques étendues.

Cette section couvre trois commandes fréquemment utilisées pour l'outil de définition VNDK :

  • vndk . Calculez VNDK_SP_LIBRARIES, VNDK_SP_EXT_LIBRARIES et EXTRA_VENDOR_LIBRARIES pour contourner le système de construction dans Android 8.0 et versions ultérieures.
  • check-dep . Vérifiez les dépendances de module non conformes entre les modules de fournisseur et les bibliothèques partagées de framework non éligibles.
  • deps . Imprimez les dépendances entre les bibliothèques partagées et les exécutables.

Pour plus de détails sur l'utilisation des commandes avancées, reportez-vous au fichier README.md dans le référentiel de l'outil de définition VNDK.

vndk

La sous-commande vndk charge les bibliothèques partagées et les exécutables à partir de la partition système et des partitions du fournisseur, puis résout les dépendances de module pour déterminer les bibliothèques qui doivent être copiées dans /system/lib[64]/vndk-sp-${VER} et /vendor/lib[64] . Les options de la sous-commande vndk incluent :

Option La description
--system Pointez sur un répertoire contenant les fichiers qui résideront dans la partition système.
--vendor Pointez sur un répertoire contenant les fichiers qui résideront dans une partition fournisseur.
--aosp-system Pointez sur un répertoire contenant les fichiers qui résideront dans l'image système générique (GSI).
--load-extra-deps Pointez sur un fichier qui décrit les dépendances implicites, comme dlopen() .

Par exemple, pour calculer les ensembles de bibliothèques VNDK, exécutez la sous-commande vndk suivante :

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

Spécifiez des dépendances supplémentaires avec un format de fichier simple. Chaque ligne représente une relation, le fichier avant les deux-points dépendant du fichier après les deux-points. Par exemple:

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

Cette ligne permet à l'outil de définition VNDK de savoir que libart.so dépend de libart-compiler.so .

Lieu d'installation

L'outil de définition VNDK répertorie les bibliothèques et les répertoires d'installation correspondants pour les catégories suivantes :

Catégorie Annuaire
vndk_sp Doit être installé dans /system/lib[64]/vndk-sp-${VER}
vndk_sp_ext Doit être installé dans /vendor/lib[64]/vndk-sp
extra_vendor_libs Doit être installé dans /vendor/lib[64]

Construire des modèles de système

Après avoir collecté les sorties de l'outil de définition VNDK, un fournisseur peut créer un fichier Android.mk et remplir VNDK_SP_LIBRARIES , VNDK_SP_EXT_LIBRARIES et EXTRA_VENDOR_LIBRARIES pour automatiser le processus de copie des bibliothèques vers la destination d'installation désignée.

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-dep

La sous-commande check-dep analyse les modules du fournisseur et vérifie leurs dépendances. S'il détecte des violations, il imprime la bibliothèque dépendante et les utilisations de symboles violées :

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

Par exemple, l'exemple de sortie suivant montre une dépendance en violation de libRS_internal.so à 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

Les options de la sous-commande check-dep incluent :

Option La description
--tag-file Doit faire référence à un fichier de balises de bibliothèque éligible (décrit ci-dessous), qui est une feuille de calcul fournie par Google décrivant les catégories de bibliothèques partagées du framework.
--module-info Pointe vers le module-info.json généré par le système de construction Android. Il aide l'outil de définition VNDK à associer les modules binaires au code source.

Fichier de balises de bibliothèque éligible

Google fournit une feuille de calcul VNDK éligible (par exemple eligible-list.csv ) qui balise les bibliothèques partagées du framework pouvant être utilisées par les modules des fournisseurs :

Étiquette La description
LL-NDK Bibliothèques partagées avec des ABI/API stables pouvant être utilisées à la fois par les modules de framework et de fournisseur.
LL-NDK-Privé Dépendances privées des bibliothèques LL-NDK. Les modules du fournisseur ne doivent pas accéder directement à ces bibliothèques.
VNDK-SP Dépendances des bibliothèques partagées du framework SP-HAL.
VNDK-SP-Privé Dépendances VNDK-SP qui ne sont pas directement accessibles à tous les modules du fournisseur.
VNDKName Bibliothèques partagées du framework disponibles pour les modules du fournisseur (sauf SP-HAL et SP-HAL-Dep).
VNDK-Privé Dépendances VNDK qui ne sont pas directement accessibles à tous les modules du fournisseur.
FWK UNIQUEMENT Bibliothèques partagées uniquement du framework auxquelles les modules du fournisseur ne doivent pas accéder (ni directement ni indirectement).
FWK-UNIQUEMENT-RS Bibliothèques partagées de framework uniquement auxquelles les modules du fournisseur ne doivent pas accéder (sauf pour les utilisations RS).

Le tableau suivant décrit les balises utilisées pour les bibliothèques partagées des fournisseurs :

Étiquette La description
SP-HAL Bibliothèques partagées d'implémentation HAL à processus identique.
SP-HAL-Dép Dépendances des bibliothèques partagées du fournisseur SP-HAL (alias dépendances SP-HAL à l'exclusion de LL-NDK et VNDK-SP).
VND UNIQUEMENT Bibliothèques partagées invisibles au framework auxquelles les modules du framework ne doivent pas accéder. Les bibliothèques VNDK étendues copiées seront également marquées comme VND-ONLY.

Relations entre balises :

Figure 1. Relations entre balises.

des profondeurs

Pour déboguer les dépendances de la bibliothèque, la sous-commande deps imprime les dépendances du module :

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

La sortie se compose de plusieurs lignes. La ligne sans caractère de tabulation commence une nouvelle section. La ligne avec un caractère de tabulation dépend de la section précédente. Par exemple:

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

Cette sortie montre que ld-android.so n'a pas de dépendance et que libc.so dépend de libdl.so .

Lors de la spécification de l'option --revert , la sous-commande deps les utilisations des bibliothèques (dépendances inversées) :

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

Par exemple:

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

Cette sortie montre que ld-android.so est utilisé par libdl.so , ou en d'autres termes, libdl.so dépend de ld-android.so . De plus, cette sortie montre que libdl.so est le seul utilisateur de ld-android.so .

Lors de la spécification de l'option --symbol , la sous-commande deps imprime les symboles utilisés :

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

Par exemple:

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

Cette sortie montre que libc.so dépend de 6 fonctions exportées depuis libdl.so . Si les deux options --symbol et --revert sont spécifiées, les symboles utilisés par l'utilisateur seront imprimés.