Özellik lansmanı işaretleri, Google tarafından kararlı kod dalları sağlamak için bir yaklaşım olarak kullanılır. Bu işaretler, AOSP'ye yapılan belirli katkı türleri için de gereklidir. Özellik lansmanı işaretlemesini uygulamadan önce, değişikliğiniz için bir işaret gerekir. Bir işaret gerekiyorsa kullanılacak işaret türünü belirler.
İşaret kullanımını belirleme
Özellik lansmanı işaretinin ne zaman kullanılacağını belirlemek için aşağıdaki yönergeleri uygulayın:
Yeni bir özellik ekleme veya özellikle karmaşık bir hatayı düzeltme gibi AOSP kod tabanının kararsız olmasına neden olabilecek bir değişiklik yapıyorsanız özellik lansmanı işaretçisi kullanın.
Buna karşılık, kod tabanının kararsız olmasına neden olmayacak bir kod değişikliği (ör. yorumları değiştirme) yapıyorsanız özellik lansmanı işareti kullanmanız gerekmez.
İşaret türünü belirleme
İki tür işaret vardır: aconfig flag'leri ve derleme işaretleri.
Aconfig işaretleri
Aconfig flag'leri, yayınlanmamış kodun yürütülmesini test ve yayınlama sürecinde serbest bırakılmış kod yazmak Aconfig flag'leri okuma-yazma veya salt okunur:
Okuma-yazma aconfig işaretleri, etkinleştirebileceğiniz boole değişkenleridir (
true
) veya çalışma zamanında devre dışı bırakın (false
olarak ayarlayın). Ana dalın kararlılığını etkilemeden değişiklikleri test etmek ve yayınlamak için bir okuma/yazma işareti kullanın.Salt okunur aconfig işaretleri, çalışma zamanında değiştiremeyeceğiniz doğru/yanlış sabitlerdir. Kararlı ve kullanıma hazır kodlar için salt okunur aconfig işaretlerini salt okunur aconfig işaretlerine dönüştürebilirsiniz.
Ayrıca, kullandığınız derleyiciye bağlı olarak bir salt okunur işaret kullanılırsa yürütülmeyen kod hariç tutulabilir seçeceğim. Bu nedenle, bir sürüme dahil edilmeye hazır olmayan kodları gizlemek için salt okuma işaretlerini kullanabilirsiniz.
Derleme işaretleri
Derleme işaretleri, derleme zamanı sabitleridir (dizelerdir) ve bunları çalışma zamanında değiştiremezsiniz. Aşağıdaki gibi yapılandırma işaretlerini kullanamadığınız durumlarda bu işaretleri kullanın:
- Derlemeye dahil etmek istediğiniz önceden derlenmiş veya önceden oluşturulmuş bir kodunuz var.
- Kendi sisteminizi derlemek için değişiklikler yapmak istiyorsunuz.
- Kod boyutunu yönetmek için bağımlılıkların etrafına işaretler koymak istiyorsunuz.