Mithilfe von Flags für die Einführung von Funktionen sorgt Google für stabile Codezweige. Diese Flags sind auch für bestimmte Arten von Beiträgen zum AOSP erforderlich. Bevor Sie Markierungen für die Einführung von Funktionen implementieren, sollten Sie prüfen, ob für Ihre Änderung eine Markierung erforderlich ist. Falls ein Flag erforderlich ist, sollten Sie auch den zu verwendenden Flag-Typ festlegen.
Verwendung von Flags ermitteln
Beachten Sie die folgenden Richtlinien, um zu entscheiden, wann Sie ein Flag für die Einführung einer Funktion verwenden sollten:
Wenn Sie eine Änderung vornehmen, die dazu führen kann, dass die AOSP-Codebasis instabil wird, z. B. durch das Hinzufügen einer neuen Funktion oder das Beheben eines besonders komplexen Fehlers, verwenden Sie ein Flag für die Einführung einer Funktion.
Wenn Sie hingegen eine Codeänderung vornehmen, die die Codebasis nicht instabil machen kann, z. B. das Ändern von Kommentaren, müssen Sie kein Flag für die Einführung einer Funktion verwenden.
Flag-Typ ermitteln
Es gibt zwei Arten von Flags: aconfig-Flags und Build-Flags.
Aconfig-Flags
Mit Aconfig-Flags wird die Ausführung von nicht veröffentlichtem Code während des Test- und Release-Prozesses von der Ausführung von veröffentlichtem Code getrennt. Aconfig-Flags können Lese-/Schreibzugriff oder Lesezugriff haben:
Lese-/Schreib-aconfig-Flags sind boolesche Variablen, die Sie zur Laufzeit aktivieren (auf
truesetzen) oder deaktivieren (auffalsesetzen) können. Verwenden Sie ein Lese-/Schreib-Flag, um Änderungen zu testen und freizugeben, ohne die Stabilität eines Haupt-Branches zu beeinträchtigen.Schreibgeschützte aconfig-Flags sind boolesche Konstanten, die während der Laufzeit nicht geändert werden können. Sie können Lese-/Schreib-Aconfig-Flags in Lesezugriffs-Aconfig-Flags für Code konvertieren, der stabil und zur Veröffentlichung bereit ist.
Außerdem wird der Code, der nicht ausgeführt wird, je nach verwendetem Compiler möglicherweise vom Build ausgeschlossen, wenn ein schreibgeschütztes Flag verwendet wird. Daher können Sie mit Lesezugriffsflags Code ausblenden, der noch nicht für eine Veröffentlichung bereit ist.
Build-Flags
Build-Flags sind Konstanten (Strings) zur Buildzeit und können während der Laufzeit nicht geändert werden. Verwenden Sie diese Flags in Fällen, in denen Sie keine aconfig-Flags verwenden können, z. B.:
- Sie haben einen vorkompilierten oder vorkonfigurierten Code, den Sie in den Build einbinden möchten.
- Sie möchten Änderungen am Build-System selbst vornehmen.
- Sie möchten Abhängigkeiten mit Flags versehen, um die Codegröße zu verwalten.