Déterminer l'utilisation et le type d'indicateur

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Google utilise les indicateurs de lancement des fonctionnalités pour garantir la stabilité branches de code. Ces signalements sont également requis pour certains types de contributions à AOSP. Avant d'implémenter le signalement de lancement de fonctionnalité, déterminez si un indicateur est nécessaire pour votre modification. Et, si un indicateur est nécessaire, vous devez déterminer le type d'indicateur à utiliser.

Déterminer l'utilisation de l'indicateur

Pour déterminer quand utiliser un indicateur de lancement de fonctionnalité, suivez ces consignes:

• Si vous apportez une modification susceptible de rendre le codebase AOSP instable, par exemple en ajoutant une nouvelle fonctionnalité ou en corrigeant un bug particulièrement complexe, utilisez un indicateur de lancement de fonctionnalité.

• À l'inverse, si vous apportez une modification de code qui n'est pas susceptible de rendre le codebase instable, par exemple en modifiant des commentaires, vous n'avez pas besoin d'utiliser d'indicateur de lancement de fonctionnalité.

Déterminer le type d'indicateur

Il existe deux types d'indicateurs: les indicateurs aconfig et les indicateurs de compilation.

Options Aconfig

Les indicateurs Aconfig sont utilisés pour séparer l'exécution du code non publié de du code publié pendant le processus de test et de publication. Les options Aconfig peuvent être lecture/écriture ou lecture seule:

• Les options de configuration en lecture-écriture sont des variables booléennes que vous pouvez activer (définir sur true) ou désactiver (définir sur false) au moment de l'exécution. Utilisez un indicateur lecture-écriture pour tester et publier des modifications sans affecter la stabilité d'une branche principale.

• Les indicateurs aconfig en lecture seule sont des constantes booléennes que vous ne pouvez pas modifier de l'environnement d'exécution. Vous pouvez convertir les options aconfig en lecture-écriture en options aconfig en lecture seule pour le code stable et prêt à être publié.

  En outre, selon le compilateur que vous utilisez, lorsqu'un indicateur en lecture seule est utilisé, le code qui n'est pas exécuté peut être exclu de la compilation. Par conséquent, vous pouvez utiliser des indicateurs en lecture seule pour masquer tout code qui n'est pas prêt à faire partie d'une version.

Indicateurs de compilation

Les indicateurs de compilation sont des constantes (chaînes) de temps de compilation. Vous ne pouvez pas les modifier pendant de l'environnement d'exécution. Utilisez ces options lorsque vous ne pouvez pas utiliser d'options de configuration, par exemple :

• Vous avez un morceau de code précompilé ou prédéfini que vous souhaitez inclure dans la compilation.
• Vous souhaitez apporter des modifications pour compiler le système lui-même.
• Vous souhaitez ajouter des indicateurs autour des dépendances pour gérer la taille du code.