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

Özellik lansmanı işaretleri, Google tarafından kararlı kod dalları sağlamak için kullanılı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ü belirlemelisiniz.

İşaret kullanımını belirleme

Bir özellik yayınlama 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ınlama sürecinde 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 yapılandırma 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.