Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

Инструмент определения VNDK

Инструмент определения VNDK помогает поставщикам переносить свое исходное дерево в среду Android 8.0. Этот инструмент сканирует двоичные файлы в системе и образах поставщиков, а затем разрешает зависимости. На основе графика зависимости модулей инструмент также может обнаруживать нарушения концепций VNDK и предоставлять информацию/предложения по перемещению модулей между разделами. Если указан Generic System Image (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 загружает общие библиотеки и исполняемые файлы из системного раздела и разделов поставщика, затем разрешает зависимости модулей для определения библиотек, которые необходимо скопировать в /system/lib[64]/vndk-sp-${VER} и /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`	Указывает на `module-info.json` сгенерированный системой сборки Android. Он помогает инструменту определения VNDK связать бинарные модули с исходным кодом.

Соответствующий файл библиотечного тега

Google предоставляет подходящую электронную таблицу VNDK (например, eligible-list.csv ), в которой размечаются общие библиотеки фреймворка, которые могут использоваться модулями поставщика:

Ярлык	Описание
LL-NDK	Общие библиотеки со стабильными ABI/API, которые могут использоваться как фреймворками, так и модулями поставщиков.
LL-NDK-Частный	Частные зависимости библиотек LL-NDK. Модули поставщика не должны обращаться к этим библиотекам напрямую.
ВНДК-СП	Зависимости общих библиотек фреймворка SP-HAL.
VNDK-SP-Частный	Зависимости VNDK-SP, которые не имеют прямого доступа ко всем модулям поставщика.
ВНДК	Общие библиотеки фреймворка, доступные для модулей поставщика (кроме SP-HAL и SP-HAL-Dep).
VNDK-Частный	Зависимости VNDK, которые не доступны напрямую всем модулям поставщика.
ТОЛЬКО FWK	Общие библиотеки, доступные только фреймворку, к которым не должны обращаться модули поставщика (ни напрямую, ни косвенно).
FWK-ONLY-RS	Общие библиотеки, доступные только фреймворку, к которым не должны иметь доступа модули поставщика (за исключением использования RS).

В следующей таблице описаны теги, используемые для общих библиотек поставщиков:

Ярлык	Описание
SP-HAL	Общие библиотеки реализации HAL в одном и том же процессе.
SP-HAL-деп	Зависимости общих библиотек поставщика SP-HAL (также называемые зависимостями SP-HAL, за исключением LL-NDK и VNDK-SP).
ТОЛЬКО ДЛЯ VND	Невидимые для фреймворка общие библиотеки, к которым не должны иметь доступ модули фреймворка. Скопированные расширенные библиотеки VNDK также помечены как VND-ONLY.

Связи между тегами:

Рисунок 1. Взаимосвязи между тегами.

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