本頁面由 Cloud Translation API 翻譯而成。

宣告 aconfig 標記

您可以在 Java、C、C++ 和 Rust 程式碼中使用設定旗標。Android 開放原始碼計畫建構系統會啟動一項名為「設定」的工具，用於產生特定語言的方法程式庫，方便您存取每個標記的值。產生程式庫之前，您必須先宣告標記並將其新增至建構作業。

宣告 Java 的 aconfig 標記

如要為 Java 宣告 aconfig 標記，請按照下列步驟操作：

在含有新程式碼的目錄中，建立擴充功能為 .aconfig 的檔案，例如 my_new_aconfig_flag_declarations.aconfig。aconfig 檔案是遵循標準結構定義的文字檔案。
新增類似下列的標記宣告：
```
package: "com.example.android.aconfig.demo.flags"
container: "system"

flag {
    name: "my_new_flag"
    namespace: "aconfig_demo_namespace"
    description: "This flag controls untested code"
    bug: "<none>"
}
```
地點：
- package 與標記名稱搭配使用時，可提供專屬索引鍵。在 Java 中，將 package 設為 foo.bar 會產生名為 foo.bar.Flags 的自動產生類別。在 C++ 中，標記存取子方法的名稱為 foo::bar::"flagname"。同一個宣告檔案中的標記屬於同一個套件，但多個宣告檔案可以為同一個套件提供標記。
- container 定義一組程式碼，這些程式碼會以二進位檔的形式一併建構及發布。有效容器包括 system、vendor、system_ext、product、name.of.apex 和 name.of.apk。
- name 包含旗標名稱，僅含小寫英文字母、底線和數字。
- namespace 包含貢獻內容的命名空間。您必須與指派的 Google 審查員合作，才能決定命名空間。如果您使用功能啟動旗標來維持自家 AOSP 鏡像的穩定性，可以隨意使用命名空間。
- description 包含標記功能或變更的簡短說明。
- bug 是與新程式碼貢獻相關的錯誤編號。您必須與指派的 Google 審查員合作，才能確定您的 bug。如果您使用功能發布旗標來維持自有 AOSP 鏡像的穩定性，可以使用錯誤追蹤號碼或 <none>。
注意：在未使用 APEX 或系統分區建構的 APK 中使用標記是不支援的。
儲存檔案並結束編輯器。

設定版本

宣告旗標後，請設定建構作業，以便產生用於存取旗標值的程式庫程式碼。

在 Android.bp 建構檔案中，新增與下列內容類似的 aconfig_declarations 區段：
```
aconfig_declarations {
  name: "aconfig_demo_flags",
  package: "com.example.android.aconfig.demo.flags",
  srcs: [
    "my_new_aconfig_flag_declarations.aconfig"
  ],
}
```
地點：
- name 包含宣告的名稱，僅可使用小寫英文字母、底線和數字。
- package 包含宣告中使用的套件名稱。
- srcs 包含宣告標記的 .aconfig 檔案名稱。
儲存檔案並結束編輯器。

為 C 和 C++ 宣告 aconfig 標記

如要為 C 和 C++ 宣告 aconfig 標記，請按照下列步驟操作：

在含有新程式碼的目錄中，建立擴充功能為 .aconfig 的檔案，例如 my_new_aconfig_flag_declarations.aconfig。aconfig 檔案是遵循標準結構定義的文字檔案。
新增類似下列的標記宣告：
```
package: "com.example.android.aconfig.demo.flags"
container: "system"

flag {
    name: "my_new_flag"
    namespace: "aconfig_demo_namespace"
    description: "This flag controls untested code"
    bug: "<none>"
}
```
地點：
- package 與標記名稱搭配使用時，可提供專屬索引鍵。在 Java 中，將 package 設為 foo.bar 會產生名為 foo.bar.Flags 的自動產生類別。在 C++ 中，標記存取子方法的名稱為 foo::bar::"flagname"。同一個宣告檔案中的標記屬於同一個套件，但多個宣告檔案可以為同一個套件提供標記。
- container 定義一組程式碼，這些程式碼會以二進位檔的形式一併建構及發布。有效容器包括 system、vendor、system_ext、product、name.of.apex 和 name.of.apk。
- name 包含旗標名稱，僅含小寫英文字母、底線和數字。
- namespace 包含貢獻內容的命名空間。您必須與指派的 Google 審查員合作，才能決定命名空間。如果您使用功能啟動旗標來維持自家 AOSP 鏡像的穩定性，可以隨意使用命名空間。
- description 包含標記功能或變更的簡短說明。
- bug 是與新程式碼貢獻相關的錯誤編號。您必須與指派的 Google 審查員合作，才能確定您的 bug。如果您使用功能發布旗標來維持自有 AOSP 鏡像的穩定性，可以使用錯誤追蹤號碼或 <none>。
注意：在未使用 APEX 或系統分區建構的 APK 中使用標記是不支援的。
儲存檔案並結束編輯器。

設定版本

宣告旗標後，請設定建構作業，以便產生用於存取旗標值的程式庫程式碼。

在 Android.bp 建構檔案中，新增類似以下的 aconfig_declarations 區段：
```
aconfig_declarations {
  name: "aconfig_demo_flags",
  package: "com.example.android.aconfig.demo.flags",
  srcs: [
    "my_new_aconfig_flag_declarations.aconfig"
  ],
}
```
地點：
- name 包含宣告的名稱，僅可使用小寫英文字母、底線和數字。
- package 包含宣告中使用的套件名稱。
- srcs 包含宣告標記的 aconfig 檔案名稱。
在同一個檔案中，建立類似下列內容的 cc_aconfig_library 目標：
```
cc_aconfig_library {
    name: "aconfig_demo_flags_c_lib",
    aconfig_declarations: "aconfig_demo_flags",
}
```
地點：
- name 包含僅包含小寫英文字母、底線和數字的程式庫名稱。
- aconfig_declarations 包含宣告中使用的 name。
cc_aconfig_library 建構目標會叫用 C 或 C++ Codegen，在建構期間使用產生的程式碼建立程式庫。

CC aconfig 程式庫類似於 CC 程式庫目標，但提供 vendor_available、product_available、host_supported 和 vndk 等選項。如果根據此 cc_aconfig_library 的建構目標需要特定類型的變化版本，您可能也需要在 CC aconfig 程式庫的目標中新增對應的設定。舉例來說，如果父項建構目標已將 vendor_available 設為 true，您可能也想在這個 cc_aconfig_library 目標中將 vendor_available 設為 true。

新增這個建構目標後，程式碼就能存取這個程式庫。您可以使用 static_lib 或 shared_lib 語法加入這個程式庫。請注意，如果您想將這個程式庫新增為 static_lib，請在 server_configurable_flags 上新增 shared_lib 依附元件。步驟 3 說明如何將程式碼產生的旗標程式庫加入 libexample_cpp_lib。

建立使用 aconfig 標記的目標，例如下列 cc_library 範例：

cc_library {
    name: "libexample_cpp_lib",
    srcs: ["src/example_cpp_lib.cc"],
    double_loadable: true,
    cflags: [
        "-Wall",
        "-Werror",
        "-Wno-unused-function",
        "-Wno-unused-parameter",
    ],
    header_libs: [
        "jni_headers",
    ],
    shared_libs: [
        "server_configurable_flags",
    ],
    static_libs: [
        "aconfig_demo_flags_c_lib",
    ],
    export_include_dirs: ["src/include"],
}

地點：

shared_libs 包含 aconfig 旗標所需的額外依附元件。
static_libs 是版本根據步驟 2 中的 cc_aconfig_library name 欄位所建立的程式庫名稱。只要使用靜態程式庫名稱建立 cc_library 項目，即可在程式碼中使用設定旗標。

宣告 Rust 的設定旗標

如要為 Rust 宣告 aconfig 標記，請按照下列步驟操作：

在含有新程式碼的目錄中，建立擴充功能為 .aconfig 的檔案，例如 my_new_aconfig_flag_declarations.aconfig。aconfig 檔案是遵循標準結構定義的文字前置檔案。
新增類似下列的標記宣告：
```
package: "com.example.android.aconfig.demo.flags"
container: "system"

flag {
    name: "my_new_flag"
    namespace: "aconfig_demo_namespace"
    description: "This flag controls untested code"
    bug: "<none>"
}
```
地點：
- package 與標記名稱搭配使用時，可提供專屬索引鍵。在 Java 中，將 package 設為 foo.bar 會產生名為 foo.bar.Flags 的自動產生類別。在 C++ 中，標記存取子方法的名稱為 foo::bar::"flagname"。同一個宣告檔案中的標記屬於同一個套件，但多個宣告檔案可以為同一個套件提供標記。
- container 定義一組程式碼，這些程式碼會以二進位檔的形式一併建構及發布。有效容器包括 system、vendor、system_ext、product、name.of.apex 和 name.of.apk。
- name 包含旗標名稱，僅含小寫英文字母、底線和數字。
- namespace 包含貢獻內容的命名空間。您必須與指派的 Google 審查員合作，才能決定命名空間。如果您使用功能啟動旗標來維持自家 AOSP 鏡像的穩定性，可以隨意使用命名空間。
- description 包含標記功能或變更的簡短說明。
- bug 是與新程式碼貢獻相關的錯誤編號。您必須與指派的 Google 審查員合作，才能確定您的 bug。如果您使用功能發布旗標來維持自有 AOSP 鏡像的穩定性，可以使用錯誤追蹤號碼或 <none>。
注意：在未使用 APEX 或系統分區建構的 APK 中使用標記是不支援的。
儲存檔案並結束編輯器。

設定版本

宣告標記後，請設定版本，讓其產生用於存取標記值的程式庫程式碼。

在 Android.bp 建構檔案中，新增與下列內容類似的 aconfig_declarations 區段：
```
aconfig_declarations {
  name: "aconfig_demo_flags",
  package: "com.example.android.aconfig.demo.flags",
  srcs: [
    "my_new_aconfig_flag_declarations.aconfig"
  ],
}
```
地點：
- name 包含宣告的名稱，僅可使用小寫英文字母、底線和數字。
- package 包含宣告中使用的套件名稱。
- srcs 包含宣告標記的 aconfig 檔案名稱。
建立類似下方範例的 rust_aconfig_library 目標。這項目標會叫用 Rust Codegen，並在建構期間使用產生的程式碼建立 Rust 程式庫。
```
rust_aconfig_library {
  name: "libaconfig_demo_flags_rust",
  crate_name: "aconfig_demo_flags_rust",
  aconfig_declarations: "aconfig_demo_flags",
}
```
地點：
- name 包含宣告的名稱，僅可使用小寫英文字母、底線和數字。
- crate_name 包含宣告中使用的套件名稱。
- aconfig_declarations 包含宣告中使用的同一個 name。
有了這項變更，您的程式碼就能依附這個 Rust 程式庫。
在同一個檔案中，建立類似下列內容的 rust_library 項目：
```
rust_library {
  name: "libexample_lib",
  rustlibs: [
      "libaconfig_demo_flags_rust",
  ]
}
```
這個範例可讓原始碼建構目標 libexample_demo_flags_rust 納入程式碼產生的旗標程式庫。
儲存檔案並關閉編輯器。