İşaret kullanımını ve türünü belirleme

Ö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şaretlemeyi uygulamadan önce, değişikliğiniz için işaretleme gerekip gerekmediğini belirleyin. Ayrıca, işaret gerekiyorsa kullanılacak işaret türünü belirlemeniz gerekir.

İş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 yapıyorsanız (ör. yorumları değiştirmek) özellik lansmanı işareti kullanmanız gerekmez.

İşaret türünü belirleme

İki tür işaret vardır: aconfig işaretleri ve derleme işaretleri.

Aconfig işaretleri

Yapılandırma işaretleri, test ve sürüm oluşturma işlemi sırasında yayınlanmamış kodun yürütülmesini yayınlanmış koddan ayırmak için kullanılır. Aconfig işaretleri salt okunur veya salt yazılabilir olabilir:

  • Okuma/yazma aconfig işaretleri, çalışma zamanında etkinleştirebileceğiniz (true olarak ayarlanır) veya devre dışı bırakabileceğiniz (false olarak ayarlanır) boole değişkenleridir. 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, salt okunur bir işaret kullanıldığında yürütülmeyen kod derlemeden hariç tutulabilir. Bu nedenle, bir sürüme dahil edilmeye hazır olmayan kodları gizlemek için salt okuma işaretlerini kullanabilirsiniz.

İşaret oluşturma

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.
  • Sistemde değişiklik yapmak istiyorsunuz.
  • Kod boyutunu yönetmek için bağımlılıkların etrafına işaretler koymak istiyorsunuz.