宣告及使用建構旗標

建構標記是建構時間常數，無法在執行階段變更。這些旗標可用於無法使用 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。將 LAUNCH 用於從 false 進展至 true 的布林值旗標，類似於功能啟動旗標。將 PREBUILT 用於設定版本的標記，通常是預先建構的版本。
   • containers 您要編寫的程式碼類型，例如供應商代碼的「供應商」或產品代碼的「產品」。如果您不確定要使用的值，請使用前述範例中顯示的所有四種容器類型。

在 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 變數。以下是存取名為 RELEASED_PACKAGE_NFC_STCK 的建構標記的範例 makefile：

# 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 欄位，在 RELEASE_PACKAGE_NFC_STACK.textproto 中設為 PREBUILT，字串值為 com.android.nfcservices RELEASE_PACKAGE_NFC_STACK.textproto trunk_staging 開發設定的旗標值檔案。