כלי ההגדרה של 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] . האפשרויות עבור פקודת המשנה 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 , הסמלים שבהם משתמש המשתמש יודפסו.