声明和使用构建标志

构建标志是构建时常量，无法在运行时更改。在无法使用 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。如果类型是 string_value，则值必须用引号引起来。如果未指定，则值为空字符串。布尔值表示为 true 或表示 false 的空字符串。
    • workflow 是 LAUNCH 或 PREBUILT。对于从 false 变为 true 的布尔标志，请使用 LAUNCH，类似于功能启动标志。对于设置版本（通常是预构建版本）的标志，请使用 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 开发配置的标志值文件。