Mendeklarasikan dan menggunakan flag build

Tanda build adalah konstanta waktu build dan tidak dapat diubah selama runtime. Tanda ini digunakan dalam situasi ketika tanda aconfig tidak dapat digunakan, seperti

• Anda memiliki bagian kode yang telah dikompilasi atau dibuat sebelumnya yang ingin Anda sertakan secara opsional dalam build.
• Anda ingin melakukan perubahan pada sistem build itu sendiri.
• Anda ingin menempatkan tanda di sekitar dependensi untuk mengelola ukuran kode.
• Anda ingin mengelola peluncuran fitur, tetapi Anda perlu memeriksa nilai tanda sebelum tanda aconfig tersedia oleh sistem.

Mendeklarasikan tanda build

Tanda build dideklarasikan dalam file textproto. Untuk mendeklarasikan tanda build:

1. Buka WORKING_DIRECTORY/build/release/flag_declarations/
2. Buat file bernama RELEASE_MY_FLAG_NAME.textproto.

3. Edit file dan tambahkan entri yang mirip dengan berikut:

   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"
   

   Dengan:

   • name berisi nama tanda yang diawali dengan RELEASE_. Hanya huruf besar dan garis bawah yang diizinkan.
   • namespace berisi namespace untuk kontribusi. Anda harus bekerja sama dengan peninjau Google yang ditetapkan untuk menentukan namespace Anda. Jika Anda menggunakan tanda peluncuran fitur untuk mempertahankan stabilitas mirror AOSP Anda sendiri, Anda dapat menggunakan namespace sesuka Anda.
   • value adalah jenis dan nilai awal untuk tanda. Jenisnya dapat berupa bool_value atau string_value. Jika jenisnya adalah string_value, nilai harus dalam tanda kutip. Jika tidak ditentukan, nilainya adalah string kosong. Nilai boolean direpresentasikan sebagai true atau string kosong untuk salah.
   • workflow adalah LAUNCH atau PREBUILT. Gunakan LAUNCH untuk tanda boolean yang maju dari false ke true, mirip dengan tanda peluncuran fitur. Gunakan PREBUILT untuk tanda yang menetapkan versi, biasanya dari versi yang telah dibuat sebelumnya.
   • containers jenis kode yang Anda tulis, seperti "vendor" untuk kode vendor atau "product" untuk kode produk. Jika Anda ragu dengan nilai yang akan digunakan, gunakan keempat jenis penampung seperti yang ditunjukkan dalam contoh sebelumnya.

Menggunakan tanda build dalam file Soong

Dalam file build dan modul tempat Anda ingin membuat kueri nilai tanda, gunakan kondisi untuk membuat cabang pada nilai tanda. Misalnya, dalam cuplikan berikut, nilai tanda RELEASE__READ_FROM_NEW_STORAGE dikueri:

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: [],
  }),
}

Jika nilai tanda ini adalah true, modul libaconfig_storage_read_api_cc akan ditautkan secara dinamis ke dalam modul cc_defaults.

Jika nilai tanda ini adalah false, tidak ada yang terjadi (default: [],).

Menggunakan tanda build dalam makefile

Dalam file make, tanda build adalah variabel make hanya baca. Contoh makefile berikut mengakses tanda build bernama 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

Deklarasi tanda ini memiliki kolom workflow yang ditetapkan ke PREBUILT di RELEASE_PACKAGE_NFC_STACK.textproto dan nilai string com.android.nfcservices RELEASE_PACKAGE_NFC_STACK.textproto file nilai tanda untuk konfigurasi pengembangan trunk_staging.