Visão geral da flag de lançamento de recurso

Ao adicionar código ao AOSP, use flags de lançamento de recursos para isolar códigos não testados de códigos testados. Ative as flags de lançamento de recursos para executar e testar seu código. Também é possível desativar as flags de lançamento de recursos para garantir que códigos não testados não sejam executados.

As flags de lançamento de recursos são usadas de duas maneiras principais:

• Se você estiver contribuindo para o AOSP, o revisor da sua mudança poderá solicitar que você implemente uma flag de lançamento para que o recurso seja testado corretamente. Para saber mais sobre ramificações, consulte Ciclo de vida do lançamento.
• O Google usa flags de lançamento de recursos para garantir que as ramificações de desenvolvimento externo (principal) e a de lançamento fiquem estáveis para todos. Se a empresa usa um espelho do AOSP, use as flags de lançamento de recursos para manter o código do espelho estável para a equipe de desenvolvimento.

Estas são as etapas de alto nível para implementar flags de lançamento de recursos:

1. Para uma determinada mudança no código, defina se você precisa de uma flag e, caso necessário, o tipo.
2. Declare a flag.
3. Una sua mudança de código na flag.
4. Defina o valor da flag.
5. Crie e teste seu código.
6. Mude os valores da flag durante a execução.
7. Teste o código que usa flags de lançamento de recursos.

As páginas nesta seção ensinam a realizar cada uma dessas etapas.