Система сборки поддерживает сборку двоичных файлов для двух целевых архитектур ЦП, 32-битной и 64-битной, в одной сборке. Такая двухцелевая сборка известна как сборка multilib .
Для встроенных статических библиотек и общих библиотек система сборки устанавливает правила для сборки двоичных файлов для обеих архитектур. Конфигурация продукта ( PRODUCT_PACKAGES ) вместе с графиком зависимостей определяет, какие двоичные файлы собираются и устанавливаются в образ системы.
Для исполняемых файлов и приложений система сборки по умолчанию создает только 64-разрядную версию, но вы можете переопределить эту настройку с помощью глобальной переменной BoardConfig.mk или переменной области действия модуля.
Определите вторую архитектуру ЦП и ABI
BoardConfig.mk включает в себя следующие переменные для настройки архитектуры второго ЦП и двоичного интерфейса приложения (ABI):
-
TARGET_2ND_ARCH -
TARGET_2ND_ARCH_VARIANT -
TARGET_2ND_CPU_VARIANT -
TARGET_2ND_CPU_ABI -
TARGET_2ND_CPU_ABI2
Пример make-файла, использующего эти переменные, см. build/make/target/board/generic_arm64/BoardConfig.mk .
В сборке multilib имена модулей в PRODUCT_PACKAGES охватывают как 32-битные, так и 64-битные двоичные файлы, если они определены системой сборки. Для библиотек, включенных зависимостью, 32-битная или 64-битная библиотека устанавливается только в том случае, если она требуется другой 32-битной или 64-битной библиотеке или исполняемому файлу.
Однако имена модулей в командной строке make охватывают только 64-битную версию. Например, после запуска lunch aosp_arm64-eng , make libc собирает только 64-битную libc. Чтобы собрать 32-битную libc, нужно запустить make libc_32 .
Определить архитектуру модуля в Android.mk
Вы можете использовать переменную LOCAL_MULTILIB для настройки сборки для 32- и 64-разрядной версии и переопределить глобальную переменную TARGET_PREFER_32_BIT .
Чтобы переопределить TARGET_PREFER_32_BIT , установите LOCAL_MULTILIB на одно из следующих значений:
-
bothсборки как 32-битные, так и 64-битные. -
32сборки только 32 бит. -
64собирает только 64 бит. -
firstсборки только для первой архитектуры (32-битной на 32-битных устройствах и 64-битной на 64-битных устройствах).
По умолчанию LOCAL_MULTILIB не установлен, и система сборки решает, какую архитектуру собирать, на основе класса модуля и других переменных LOCAL_ * , таких как LOCAL_MODULE_TARGET_ARCH и LOCAL_32_BIT_ONLY .
Если вы хотите создать свой модуль для определенных архитектур, используйте следующие переменные:
LOCAL_MODULE_TARGET_ARCH- Установите эту переменную в список архитектур, напримерarm x86 arm64. Если собираемая архитектура есть в этом списке, текущий модуль включается системой сборки.LOCAL_MODULE_UNSUPPORTED_TARGET_ARCH- Эта переменная противоположнаLOCAL_MODULE_TARGET_ARCH. Если собираемая архитектураnotв этом списке, текущий модуль включается системой сборки.
Существуют незначительные вариации этих двух переменных:
-
LOCAL_MODULE_TARGET_ARCH_WARN -
LOCAL_MODULE_UNSUPPORTED_TARGET_ARCH_WARN
Система сборки выдает предупреждение, если текущий модуль пропущен из-за перечисленных архитектур.
Чтобы настроить флаги сборки для конкретной архитектуры, используйте переменные LOCAL_ * специфичные для архитектуры, где * — суффикс, специфичный для архитектуры, например:
-
LOCAL_SRC_FILES_arm, LOCAL_SRC_FILES_x86, -
LOCAL_CFLAGS_arm, LOCAL_CFLAGS_arm64, -
LOCAL_LDFLAGS_arm, LOCAL_LDFLAGS_arm64,
Эти переменные применяются только в том случае, если для данной архитектуры собирается двоичный файл.
Иногда проще установить флаги в зависимости от того, собирается ли двоичный файл для 32- или 64-битной версии. Используйте переменную LOCAL_ * с суффиксом _32 или _64 , например:
-
LOCAL_SRC_FILES_32, LOCAL_SRC_FILES_64, -
LOCAL_CFLAGS_32, LOCAL_CFLAGS_64, -
LOCAL_LDFLAGS_32, LOCAL_LDFLAGS_64,
Установить путь установки библиотеки
Для сборки non-multilib можно использовать LOCAL_MODULE_PATH для установки библиотеки в место, отличное от местоположения по умолчанию. Например, LOCAL_MODULE_PATH := $(TARGET_OUT_SHARED_LIBRARIES)/hw .
Однако в сборке multilib вместо этого используйте LOCAL_MODULE_RELATIVE_PATH :
LOCAL_MODULE_RELATIVE_PATH := hw
При использовании этого формата и 64-битные, и 32-битные библиотеки устанавливаются в правильном месте.
Если вы создаете исполняемый файл как 32-разрядный и 64-разрядный, используйте одну из следующих переменных, чтобы отличить путь установки:
-
LOCAL_MODULE_STEM_32, LOCAL_MODULE_STEM_64— указывает имя установленного файла. -
LOCAL_MODULE_PATH_32, LOCAL_MODULE_PATH_64— Указывает путь установки.
Получить промежуточный каталог для исходных файлов
В сборке multilib, если вы генерируете исходные файлы в $(local-intermediates-dir) (или $(intermediates-dir-for) с явными переменными), это не будет работать надежно. Это потому, что промежуточно сгенерированные исходные файлы требуются как для 32-битной, так и для 64-битной сборки, но $(local-intermediates-dir) указывает только на один из двух промежуточных каталогов.
Система сборки предоставляет выделенный, дружественный к мультибиблиотекам, промежуточный каталог для генерации исходников. Чтобы получить путь к промежуточному каталогу, используйте макрос $(local-generated-sources-dir) или $(generated-sources-dir-for) . Использование этих макросов аналогично $(local-intermediates-dir) и $(intermediates-dir-for) .
Если исходный файл сгенерирован в этом выделенном каталоге и выбран LOCAL_GENERATED_SOURCES , он собирается как для 32-битной, так и для 64-битной версии в многобиблиотечной сборке.
Укажите архитектуру системы готовых бинарных целей
В сборке multilib нельзя использовать TARGET_ARCH или TARGET_ARCH в сочетании с TARGET_2ND_ARCH для указания системной архитектуры предварительно собранных бинарных целей. Вместо этого используйте переменные LOCAL_ * LOCAL_MODULE_TARGET_ARCH или LOCAL_MODULE_UNSUPPORTED_TARGET_ARCH .
Благодаря этим переменным система сборки может выбрать соответствующий 32-битный готовый двоичный файл, даже если она работает над 64-битной мультибиблиотечной сборкой.
Если вы хотите использовать выбранную архитектуру для вычисления исходного пути для предварительно собранного двоичного файла, вызовите $(get-prebuilt-src-arch) .
Обеспечить генерацию 32- и 64-битных файлов ODEX
Для 64-битных устройств Google по умолчанию генерирует как 32-битные, так и 64-битные файлы ODEX для загрузочного образа и любых библиотек Java. Для APK-файлов Google по умолчанию генерирует ODEX только для основной 64-битной архитектуры. Если приложение запускается как в 32-битных, так и в 64-битных процессах, используйте LOCAL_MULTILIB := both , чтобы убедиться, что генерируются как 32-битные, так и 64-битные файлы ODEX. Если приложение имеет какие-либо 32-битные или 64-битные библиотеки JNI, этот флаг также сообщает системе сборки о необходимости их включения.