此页面由 Cloud Translation API 翻译。

设置功能发布标志值

默认情况下，所有功能启动标志均为 READ_WRITE 并设置为 DISABLED。您必须先为该标志创建标志值文件，以覆盖 build 中使用的默认值，然后才能测试该功能。在标志值文件中，您可以设置各个标志的状态 (ENABLED 或 DISABLED) 和权限 (READ_WRITE 或 READ_ONLY)。

发布配置是一个目录，其中包含特定 Android build 的所有 flag 值文件（其中某些功能处于启用和停用状态）。

AOSP 附带一些发布配置，例如 trunk_staging。发布配置目录位于 WORKING_DIRECTORY/build/release/aconfig/ 下。

使用 lunch 命令选择目标时，您还会为目标设置发布配置。例如，以下是 trunk_staging 目标：

lunch aosp_cf_x86_64_phone-trunk_staging-userdebug

主干预演环境是一种开发版本配置，因为 Google 会在正式发布之前使用该环境来测试功能。此配置主要使用 READ_WRITE 标志，可让您在运行时启用或停用功能来测试代码。

在正式发布时，请使用正式版配置。版本发布配置主要使用 READ_ONLY 标志，并反映为该版本启用的所有代码。

向 trunk_staging 版本配置添加标志

如需测试新标志，请将其添加到 trunk_staging 版本配置，如下所示：

导航到WORKING_DIRECTORY/build/release/aconfig/trunk_staging/
创建一个与标志具有相同软件包名称的目录，例如为 Java 声明 aconfig 标志中所示的 com.example.android.aconfig.demo.flags。
导航到新目录。
在该目录中，创建一个标志值文件，将标志声明 (.aconfig) 文件中使用的名称（例如为 Java 声明 aconfig 标志中所示的 my_static_flag）与 _flag_values.textproto 组合在一起。生成的文件名为 my_static_flag_flag_values.textproto。
修改该文件并添加类似于以下内容的 flag_value：
```
flag_value {
  package: "com.example.android.aconfig.demo.flags"
  name: "my_static_flag"
  state: DISABLED
  Permission: READ_WRITE
}
```
其中：
- package 包含声明中使用的软件包名称。
- name 包含声明中使用的名称。
- state 是 ENABLED 或 DISABLED。
- permission 是 READ_WRITE 或 READ_ONLY。对于属于发布配置的标志值文件，通常将 permission 设置为 READ_ONLY。
保存文件并退出编辑器。
在标志值文件所在的目录中，创建一个名为 Android.bp 的 build 文件。此文件用于在 build 中添加标志值文件。
在 Android.bp 文件中，创建一个类似于以下内容的 aconfig_values 部分：
```
aconfig_values {
  name: "aconfig-values-platform_build_release-trunk-staging-com.android.aconfig.test-all",
  package: "com.android.aconfig.test",
  srcs: [
    "*_flag_values.textproto",
  ]
}
```
其中：
- name 是 Soong build 模块的唯一名称。Google 使用 aconfig-values-platform_PATH_TO_RELEASE_CONFIG_DIR-CONFIG-NAME-package.name-all 的惯例。请注意，PATH_TO_RELEASE_CONFIG_DIR 为 build/release。
- package 包含声明中使用的软件包名称。
- srcs 是所有标志值文件的列表。
保存文件并退出编辑器。
前往当前目录 (cd ..) 的上层目录
修改 Android.bp 文件。此 build 文件包含与每个 flag 值文件关联的名称 (name) 列表。将您在上一个 build 文件（第 8 步）中使用的名称添加到此列表中。
构建 Android 并运行新代码，确保其已根据标志值文件中的设置启用。