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:
- Caso você esteja contribuindo para o AOSP, confira se o código usa flags de lançamento de recursos para que ele possa ser ativado ou desativado de acordo com a necessidade do Google de testar seu código e manter a estabilidade da ramificação de desenvolvimento externo. 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 a ramificação de desenvolvimento externo (principal) e a ramificação de lançamento fiquem estáveis para todo mundo. 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.