Объявите и используйте флаг сборки

Флаги сборки являются константами времени сборки и не могут быть изменены во время выполнения. Эти флаги используются в случаях, когда флаги aconfig не могут быть использованы, например

  • У вас есть предварительно скомпилированный или предварительно собранный фрагмент кода, который вы хотите при желании включить в сборку.
  • Вы хотите внести изменения в саму сборку системы.
  • Вам нужно установить флаги вокруг зависимостей, чтобы управлять размером кода.
  • Вы хотите управлять запуском функции, но вам необходимо проверить значение флага до того, как система сделает флаги aconfig доступными.

Объявить флаг сборки

Флаги сборки объявляются в файлах textproto. Чтобы объявить флаг сборки:

  1. Перейдите в WORKING_DIRECTORY /build/release/flag_declarations/
  2. Создайте файл с именем RELEASE_ MY_FLAG_NAME .textproto .

  3. Отредактируйте файл и добавьте запись, подобную следующей:

    name: "RELEASE_MY_FLAG_NAME"
namespace: "android_UNKNOWN"
description: "Control if we should read from new storage."
workflow: LAUNCH
containers: "product"
containers: "system"
containers: "system_ext"
containers: "vendor"

    Где:

    • name содержит имя флага, которому предшествует RELEASE_ . Разрешены только заглавные буквы и подчеркивание.
    • namespace содержит пространство имен для вкладов. Вы должны работать с назначенным рецензентом Google, чтобы определить свое пространство имен. Если вы используете флаги запуска функций для поддержания стабильности вашего собственного зеркала AOSP, вы можете использовать пространство имен так, как вам нравится.
    • value — начальный тип и значение для флага. Тип может быть bool_value или string_value . Если type — string_value , то значение должно быть в кавычках. Если не указано, значение — пустая строка. Булевы значения представлены либо как true , либо как пустая строка для false.
    • workflow — LAUNCH или PREBUILT . Используйте LAUNCH для булевых флагов, которые переходят от false к true , аналогично флагам запуска функций. Используйте PREBUILT для флагов, которые устанавливают версию, обычно предварительно собранную.
    • containers тип кода, который вы пишете, например, "vendor" для кода поставщика или "product" для кода продукта. Если вы сомневаетесь в значении, которое следует использовать, используйте все четыре типа контейнеров, как показано в предыдущем примере.

Использовать флаг сборки в файле Soong

В файле сборки и модуле, где вы хотите запросить значение флага, используйте условное выражение для перехода по значению флага. Например, в следующем фрагменте запрашивается значение флага RELEASE__READ_FROM_NEW_STORAGE :

cc_defaults {
  name: "aconfig_lib_cc_shared_link.defaults",
  shared_libs: select(release_flag("RELEASE_READ_FROM_NEW_STORAGE"), {
    true: ["libaconfig_storage_read_api_cc],
    default: [],
  }),
}

Если значение этого флага равно true , модуль libaconfig_storage_read_api_cc динамически подключается к модулю cc_defaults .

Если значение этого флага равно false , ничего ( default: [], ) не происходит.

Используйте флаг сборки в makefile

В файле make флаг сборки — это переменная make, доступная только для чтения. Следующий пример файла makefile обращается к флагу сборки, называемому RELEASED_PACKAGE_NFC_STCK :

# NFC and Secure Element packages
PRODUCT_PACKAGES += \
    $(RELEASE_PACKAGE_NFC_STACK) \
    Tag \
    SecureElement \
    android.hardware.nfc-service.st \
    android.hardware.secure_element@1.0-service.st \
    NfcOverlayCoral

Для этого флага в объявлении поля workflow задано значение PREBUILT в RELEASE_PACKAGE_NFC_STACK.textproto , а строковое значение com.android.nfcservices RELEASE_PACKAGE_NFC_STACK.textproto — файл значений флагов для конфигурации разработки trunk_staging .