ابزار تعریف VNDK

ابزار تعریف VNDK به فروشندگان کمک می کند درخت منبع خود را به محیط اندروید 8.0 منتقل کنند. این ابزار فایل های باینری را در سیستم و تصاویر فروشنده اسکن می کند و سپس وابستگی ها را برطرف می کند. بر اساس نمودار وابستگی ماژول، این ابزار همچنین می‌تواند نقض مفاهیم VNDK را شناسایی کند و بینش/پیشنهاداتی را برای جابجایی ماژول‌ها بین پارتیشن‌ها ارائه دهد. اگر یک تصویر سیستم عمومی (GSI) مشخص شده باشد، ابزار تعریف VNDK می تواند تصویر سیستم شما را با GSI مقایسه کرده و کتابخانه های توسعه یافته را تعیین کند.

این بخش سه دستور پرکاربرد برای ابزار تعریف VNDK را پوشش می دهد:

• vndk . VNDK_SP_LIBRARIES، VNDK_SP_EXT_LIBRARIES، و EXTRA_VENDOR_LIBRARIES را برای راه‌حل سیستم ساخت در Android نسخه 8.0 و بالاتر محاسبه کنید.
• check-dep . وابستگی‌های ماژول را از ماژول‌های فروشنده به کتابخانه‌های مشترک چارچوب غیرواجد شرایط بررسی کنید.
• deps . وابستگی های بین کتابخانه های مشترک و فایل های اجرایی را چاپ کنید.

برای جزئیات بیشتر در مورد استفاده از دستور پیشرفته، به فایل README.md در مخزن VNDK Definition Tool مراجعه کنید.

vndk

دستور فرعی vndk کتابخانه ها و فایل های اجرایی به اشتراک گذاشته شده را از پارتیشن سیستم و پارتیشن فروشنده بارگیری می کند، سپس وابستگی های ماژول را برای تعیین کتابخانه هایی که باید در /system/lib[64]/vndk-sp-${VER} و /vendor/lib[64] کپی شوند، حل می کند. /vendor/lib[64] . گزینه های زیر فرمان vndk عبارتند از:

به عنوان مثال، برای محاسبه مجموعه های کتابخانه 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، یک فروشنده می‌تواند یک 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 عبارتند از:

فایل برچسب کتابخانه واجد شرایط

Google یک صفحه گسترده VNDK واجد شرایط ارائه می دهد (به عنوان مثال eligible-list.csv ) که کتابخانه های مشترک چارچوب را که می تواند توسط ماژول های فروشنده استفاده شود، برچسب گذاری می کند:

جدول زیر برچسب های مورد استفاده برای کتابخانه های مشترک فروشنده را توضیح می دهد:

روابط بین برچسب ها:

deps

برای رفع اشکال وابستگی های کتابخانه، دستور فرعی 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 به 6 تابع صادر شده از libdl.so بستگی دارد. اگر هم گزینه --symbol و هم گزینه --revert مشخص شده باشد، نمادهای استفاده شده توسط کاربر چاپ می شود.