Impostare i valori del flag di lancio della funzionalità

Per impostazione predefinita, tutti i flag di lancio delle funzionalità sono READ_WRITE e impostati su DISABLED. Prima di poter testare una funzionalità, devi sostituire il valore predefinito utilizzato nella build creando un file di valori dei flag per il flag. In un file di valori dei flag, imposti lo stato di un singolo flag (ENABLED o DISABLED) e l'autorizzazione (READ_WRITE o READ_ONLY).

Una configurazione della release è una directory che contiene tutti i file di valori dei flag per una build specifica di Android (con determinate funzionalità attivate e disattivate).

AOSP viene fornito con alcune configurazioni della release, ad esempio trunk_staging. Le directory di configurazione della release si trovano in WORKING_DIRECTORY/build/release/aconfig/.

Quando utilizzi il comando lunch per scegliere una destinazione, imposti anche la configurazione della release per la destinazione. Ad esempio, di seguito è riportata una destinazione trunk_staging:

lunch aosp_cf_x86_64_only_phone-trunk_staging-userdebug

La trunk staging è una configurazione della release di sviluppo perché Google la utilizza per testare le funzionalità prima della release generale. Questa configurazione utilizza principalmente flag READ_WRITE che ti consentono di testare il codice con le funzionalità attivate o disattivate in fase di runtime.

Nella release generale, utilizza una configurazione della release di rilascio. Una configurazione della release di rilascio utilizza principalmente flag READ_ONLY e riflette tutto il codice abilitato per quella release.

Aggiungere un flag alla configurazione della release trunk_staging

Per testare un nuovo flag, aggiungilo alla configurazione della release trunk_staging nel seguente modo:

1. Vai a WORKING_DIRECTORY/build/release/aconfig/trunk_staging/
2. Crea una directory con lo stesso nome del pacchetto del flag, ad esempio com.example.android.aconfig.demo.flags mostrato in Dichiarare un flag aconfig per Java.
3. Vai alla nuova directory.
4. Nella directory, crea un file di valori dei flag che combini il nome utilizzato nel file di dichiarazione del flag (.aconfig), ad esempio my_static_flag mostrato in Dichiarare un flag aconfig per Java con _flag_values.textproto. Il nome del file risultante è my_static_flag_flag_values.textproto.

5. Modifica il file e aggiungi un flag_value simile al seguente:

   flag_value {
     package: "com.example.android.aconfig.demo.flags"
     name: "my_static_flag"
     state: DISABLED
     Permission: READ_WRITE
   }
   

   Dove:

   • package contiene lo stesso nome del pacchetto utilizzato nella dichiarazione.
   • name contiene lo stesso nome utilizzato nella dichiarazione.
   • state è ENABLED o DISABLED.
   • permission è READ_WRITE o READ_ONLY. In genere, permission è impostato su READ_ONLY per i file di valori dei flag che fanno parte di una configurazione della release.

6. Salva il file ed esci dall'editor.

7. Nella stessa directory del file di valori dei flag, crea un file di build denominato Android.bp. Questo file viene utilizzato per includere il file di valori dei flag nella build.

8. Nel file Android.bp, crea una sezione aconfig_values simile a:

   aconfig_values {
     name: "aconfig-values-platform_build_release-trunk-staging-com.example.android.aconfig.demo.flags-all",
     package: "com.example.android.aconfig.demo.flags",
     srcs: [
       "*_flag_values.textproto",
     ]
   }
   

   Dove:

   • name è il nome univoco del modulo di build Soong. Google utilizza la convenzione di aconfig-values-platform_PATH_TO_RELEASE_CONFIG_DIR-CONFIG_NAME-package.name-all. Questo nome deve corrispondere al nome generato automaticamente da Soong in base alla dichiarazione aconfig_value_set nel file Android.bp della directory principale. Tieni presente che PATH_TO_RELEASE_CONFIG_DIR è build_release.
   • package contiene lo stesso nome del pacchetto utilizzato nella dichiarazione.
   • srcs è un elenco di tutti i file di valori dei flag.

9. Salva il file ed esci dall'editor.

10. Vai alla directory sopra la directory corrente (cd ..)

11. Crea Android ed esegui il nuovo codice per verificare che sia abilitato in base all'impostazione nel file di valori dei flag.