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:
- Para uma determinada mudança no código, defina se você precisa de uma flag e, caso necessário, o tipo.
- Declare a flag.
- Una sua mudança de código na flag.
- Defina o valor da flag.
- Crie e teste seu código.
- Mude os valores da flag durante a execução.
- 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.