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

Google, kararlı kod dalları sağlamak için özellik lansmanı işaretlerini kullanır. Bu işaretler, AOSP'ye yapılan belirli katkı türleri için de gereklidir. Özellik başlatma işaretlemeyi uygulamadan önce değişikliğiniz için işaret gerekip gerekmediğini belirleyin. Ayrıca, işaret gerekliyse kullanılacak işaretin türünü belirlemeniz gerekir.

İşaret kullanımını belirleme

Bir özelliği kullanıma sunma işaretinin ne zaman kullanılacağını belirlemek için aşağıdaki yönergeleri uygulayın:

  • AOSP kod tabanının kararsız olmasına neden olabilecek bir değişiklik yapıyorsanız (ör. yeni bir özellik ekleme veya özellikle karmaşık bir hatayı düzeltme) özellik lansmanı işareti kullanın.

  • Aksine, kod tabanının kararsız olmasına neden olmayacak bir kod değişikliği yapıyorsanız (ör. yorumları değiştiriyorsanız) özellik lansmanı işareti kullanmanız gerekmez.

İşaret türünü belirleme

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

Aconfig işaretleri

Yapılandırma işaretleri, test ve yayın süreci sırasında yayınlanmamış kodun yürütülmesini yayınlanmış koddan ayırmak için kullanılır. Yapılandırma işaretleri okuma/yazma veya salt okunur olabilir:

  • Okuma/yazma aconfig işaretleri, çalışma zamanında etkinleştirebileceğiniz (true olarak ayarlayabileceğiniz) veya devre dışı bırakabileceğiniz (false olarak ayarlayabileceğiniz) boolean değişkenlerdir. Ana dalın kararlılığını etkilemeden değişiklikleri test etmek ve yayınlamak için okuma/yazma işareti kullanın.

  • Salt okunur aconfig işaretleri, çalışma zamanında değiştiremeyeceğiniz boolean sabitlerdir. Kararlı ve yayınlanmaya hazır kod için okuma/yazma aconfig işaretlerini salt okunur aconfig işaretlerine dönüştürebilirsiniz.

    Ayrıca, kullandığınız derleyiciye bağlı olarak, salt okunur işaret kullanıldığında yürütülmeyen kod derlemeden çıkarılabilir. Bu nedenle, yayınlanmaya hazır olmayan kodları gizlemek için salt okunur işaretleri kullanabilirsiniz.

İşaret oluşturma

Derleme işaretleri, derleme zamanı sabitleridir (dizeler) ve bunları çalışma zamanında değiştiremezsiniz. Aşağıdaki gibi aconfig işaretlerini kullanamadığınız durumlarda bu işaretleri kullanın:

  • Derlemeye dahil etmek istediğiniz önceden derlenmiş veya önceden oluşturulmuş bir kod parçanız var.
  • Derleme sisteminde değişiklik yapmak istiyorsanız.
  • Kod boyutunu yönetmek için bağımlılıkların etrafına işaretler yerleştirmek istiyorsunuz.