Установите значения флага запуска функции

По умолчанию все флаги запуска функций имеют READ_WRITE и значение DISABLED . Перед тестированием функции необходимо переопределить значение по умолчанию, используемое в сборке, создав файл значений флагов . В файле значений флагов задаются состояние ( ENABLED или DISABLED ) и разрешение ( READ_WRITE или READ_ONLY ).

Конфигурация выпуска — это каталог, содержащий все файлы значений флагов для конкретной сборки Android (с определенными включенными и отключенными функциями).

AOSP поставляется с несколькими конфигурациями релиза, такими как trunk_staging . Каталоги конфигураций релиза находятся в WORKING_DIRECTORY /build/release/aconfig/ .

Используя команду lunch для выбора цели , вы также настраиваете конфигурацию выпуска для неё. Например, ниже приведен пример цели trunk_staging :

lunch aosp_cf_x86_64_only_phone-trunk_staging-userdebug

Trunk Staging — это конфигурация выпуска для разработки , используемая Google для тестирования функций перед общим выпуском. Эта конфигурация использует в основном флаги READ_WRITE , которые позволяют тестировать код с включёнными или отключенными функциями во время выполнения.

При общем выпуске используйте конфигурацию выпуска . Конфигурация выпуска обычно использует флаги READ_ONLY и отражает весь код, включённый для этого выпуска.

Добавьте флаг в конфигурацию выпуска trunk_staging

Чтобы протестировать новый флаг, добавьте его в конфигурацию выпуска trunk_staging следующим образом:

1. Перейдите в WORKING_DIRECTORY /build/release/aconfig/trunk_staging/
2. Создайте каталог с тем же именем пакета, что и у вашего флага, например, com.example.android.aconfig.demo.flags , как показано в разделе Объявление флага aconfig для Java .
3. Перейдите в новый каталог.
4. В этом каталоге создайте файл значений флагов, который будет содержать имя, используемое в файле объявления флагов ( .aconfig ), например my_static_flag , показанное в разделе Объявление флага aconfig для Java с помощью _flag_values.textproto . В результате файл получит имя my_static_flag_flag_values.textproto .

5. Отредактируйте файл и добавьте 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

6. Сохраните файл и выйдите из редактора.

7. В том же каталоге, где находится файл значений флагов, создайте файл сборки с именем Android.bp . Этот файл используется для включения файла значений флагов в сборку.

8. В файле 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. Google использует формат aconfig-values-platform_ PATH_TO_RELEASE_CONFIG_DIR - CONFIG-NAME - package.name -all . Обратите внимание, что PATH_TO_RELEASE_CONFIG_DIR — это build/release .
   • package содержит то же имя пакета, которое использовалось в объявлении.
   • srcs — это список всех ваших файлов значений флагов.

9. Сохраните файл и выйдите из редактора.

10. Перейдите в каталог, расположенный выше текущего каталога ( cd .. )

11. Отредактируйте файл Android.bp . Этот файл сборки содержит список имён ( name ), связанных с каждым файлом значений флагов. Добавьте в этот список имя, которое вы использовали в предыдущем файле сборки (шаг 8).

12. Соберите Android и запустите новый код, чтобы убедиться, что он включен в соответствии с настройками в файле значений флагов.