VNDK 定義工具可幫助供應商將其源代碼樹遷移到 Android 8.0 環境。該工具掃描系統和供應商映像中的二進製文件,然後解決依賴關係。基於模塊依賴圖,該工具還可以檢測違反 VNDK 概念的情況,並為在分區之間移動模塊提供洞察/建議。如果指定了通用系統映像 (GSI),則 VNDK 定義工具可以將您的系統映像與 GSI 進行比較並確定擴展庫。
本節介紹 VNDK 定義工具的三個常用命令:
-
vndk
計算 VNDK_SP_LIBRARIES、VNDK_SP_EXT_LIBRARIES 和 EXTRA_VENDOR_LIBRARIES 以在 Android 8.0 及更高版本中構建系統解決方法。 -
check-dep
。檢查從供應商模塊到不符合條件的框架共享庫的違規模塊依賴關係。 -
deps
。打印共享庫和可執行文件之間的依賴關係。
有關高級命令用法的更多詳細信息,請參閱 VNDK 定義工具存儲庫中的README.md文件。
vndk
vndk
子命令從系統分區和供應商分區加載共享庫和可執行文件,然後解析模塊依賴關係以確定必須複製到/system/lib[64]/vndk-sp-${VER}
和/vendor/lib[64]
的庫/vendor/lib[64]
。 vndk
子命令的選項包括:
選項 | 描述 |
---|---|
--system | 指向包含將駐留在系統分區中的文件的目錄。 |
--vendor | 指向包含將駐留在供應商分區中的文件的目錄。 |
--aosp-system | 指向包含將駐留在通用系統映像 (GSI) 中的文件的目錄。 |
--load-extra-deps | 指向描述隱式依賴項的文件,例如dlopen() 。 |
例如,要計算 VNDK 庫集,請運行以下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
使用簡單的文件格式指定額外的依賴項。每行代表一個關係,冒號之前的文件取決於冒號之後的文件。例如:
/system/lib/libart.so: /system/lib/libart-compiler.so
這一行讓 VNDK 定義工具知道libart.so
依賴於libart-compiler.so
。
安裝目的地
VNDK 定義工具列出了以下類別的庫和相應的安裝目錄:
類別 | 目錄 |
---|---|
vndk_sp | 必須安裝到/system/lib[64]/vndk-sp-${VER} |
vndk_sp_ext | 必須安裝到/vendor/lib[64]/vndk-sp |
extra_vendor_libs | 必須安裝到/vendor/lib[64] |
構建系統模板
從 VNDK 定義工具收集輸出後,供應商可以創建Android.mk
並填寫VNDK_SP_LIBRARIES
、 VNDK_SP_EXT_LIBRARIES
和EXTRA_VENDOR_LIBRARIES
以自動化將庫複製到指定安裝目標的過程。
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
子命令掃描供應商模塊並檢查它們的依賴關係。如果它檢測到違規,它會打印違規的依賴庫和符號用法:
./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
例如,以下示例輸出顯示了從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
check-dep
子命令的選項包括:
選項 | 描述 |
---|---|
--tag-file | 必須引用符合條件的庫標記文件(如下所述),該文件是 Google 提供的電子表格,描述了框架共享庫的類別。 |
--module-info | 指向 Android 構建系統生成的module-info.json 。它幫助 VNDK 定義工具將二進制模塊與源代碼相關聯。 |
符合條件的庫標記文件
Google 提供了一個符合條件的 VNDK 電子表格(例如eligible-list.csv
),它標記了供應商模塊可以使用的框架共享庫:
標籤 | 描述 |
---|---|
LL-NDK | 具有穩定 ABI/API 的共享庫,可供框架和供應商模塊使用。 |
LL-NDK-私人 | LL-NDK 庫的私有依賴項。供應商模塊不得直接訪問這些庫。 |
VNDK-SP | SP-HAL 框架共享庫依賴項。 |
VNDK-SP-私有 | 所有供應商模塊無法直接訪問的 VNDK-SP 依賴項。 |
越南盾 | 供應商模塊可用的框架共享庫(SP-HAL 和 SP-HAL-Dep 除外)。 |
VNDK-私人 | 並非所有供應商模塊都可以直接訪問的 VNDK 依賴項。 |
僅限 FWK | 供應商模塊(無論是直接還是間接)都不能訪問的僅限框架的共享庫。 |
FWK-ONLY-RS | 供應商模塊不得訪問的僅限框架的共享庫(RS 使用除外)。 |
下表描述了用於供應商共享庫的標籤:
標籤 | 描述 |
---|---|
SP-HAL | 同進程 HAL 實現共享庫。 |
SP-HAL-Dep | SP-HAL 供應商共享庫依賴項(也稱為 SP-HAL 依賴項,不包括 LL-NDK 和 VNDK-SP)。 |
僅限越南盾 | 框架模塊不能訪問的框架不可見的共享庫。複製的擴展 VNDK 庫也將標記為 VND-ONLY。 |
標籤之間的關係:
![](https://source.android.google.cn/devices/architecture/images/treble_vndk_design.png?authuser=19&hl=zh-tw)
部門
要調試庫依賴項, deps
子命令會打印模塊依賴項:
./vndk_definition_tool.py deps \
--system ${ANDROID_PRODUCT_OUT}/system \
--vendor ${ANDROID_PRODUCT_OUT}/vendor
輸出由多行組成。沒有製表符的行開始一個新部分。帶有製表符的行取決於前面的部分。例如:
/system/lib/ld-android.so /system/lib/libc.so /system/lib/libdl.so
此輸出顯示ld-android.so
沒有依賴關係,而libc.so
依賴於libdl.so
。
指定--revert
選項時, deps
子命令會打印庫的使用情況(反向依賴項):
./vndk_definition_tool.py deps \
--revert \
--system ${ANDROID_PRODUCT_OUT}/system \
--vendor ${ANDROID_PRODUCT_OUT}/vendor
例如:
/system/lib/ld-android.so /system/lib/libdl.so
此輸出顯示ld-android.so
被libdl.so
使用,或者換句話說, libdl.so
依賴於ld-android.so
。此外,此輸出顯示libdl.so
是ld-android.so
的唯一用戶。
當指定--symbol
選項時, deps
子命令打印正在使用的符號:
./vndk_definition_tool.py deps \
--symbol \
--system ${ANDROID_PRODUCT_OUT}/system \
--vendor ${ANDROID_PRODUCT_OUT}/vendor
例如:
/system/lib/libc.so /system/lib/libdl.so android_get_application_target_sdk_version dl_unwind_find_exidx dlclose dlerror dlopen dlsym
此輸出顯示libc.so
依賴於從libdl.so
導出的 6 個函數。如果同時指定了--symbol
選項和--revert
選項,則將打印用戶使用的符號。