Genel seçenekler ekleme

R8, uygulamada R8'in optimizasyonlarını değiştiren veya her saklama (keep) kuralını etkileyen genel seçenekler sunar. Bu seçenekler, saklama kurallarıyla birlikte proguard-rules.pro dosyasında tutulur. Bu genel seçeneklerden bazıları ek optimizasyon yapılandırırken bazıları optimizasyonun belirli yönlerini devre dışı bırakır.

R8, ProGuard'dan aktarılan bazı eski seçenekleri de kabul eder ancak bunları yoksayar. Daha fazla bilgi için Eski ProGuard seçeneklerini kaldırma başlıklı makaleyi inceleyin.

Ek optimizasyon için genel seçenekler

Aşağıdaki genel seçenekler ek optimizasyon sağlar:

• -repackageclasses [<optional-package-name>]: Uygulama boyutunu küçültmek için sınıfları tek bir pakette yeniden paketler. İsteğe bağlı paket adını sağlamazsanız sınıflar adsız (varsayılan) pakete taşınır. Bu, sınıf adlarından paket önekini çıkararak daha küçük DEX dosyaları oluşturduğu için uygulamalar için önerilen ayardır. Android Gradle eklentisi (AGP) 9.1'den itibaren bu, uygulamaların varsayılan yapılandırmasıdır. Bu optimizasyonu devre dışı bırakmak için -dontrepackage simgesini kullanın.
• -allowaccessmodification: R8'in daha kapsamlı optimizasyonlar gerçekleştirmek için sınıfların, alanların ve yöntemlerin görünürlüğünü değiştirmesine (genellikle genişletmesine) olanak tanır. proguard-android-optimize.txt kullanılırken etkinleştirilir. Android Gradle eklentisi (AGP) 8.2'den itibaren, R8 ile tam optimizasyonu etkinleştirirseniz bu varsayılan yapılandırmadır.

• -processkotlinnullchecks [level]: R8'in Kotlin Intrinsics null kontrollerini yalnızca hata mesajını kaldıracak veya açık null kontrolünü tamamen kaldıracak şekilde değiştirmesine olanak tanır.

  En zayıftan en güçlüye doğru sıralanan level değerleri aşağıdaki etkiye sahiptir:

  • keep kontrolleri değiştirmez.
  • remove_message, her kontrol yöntemi çağrısını, çağrının ilk bağımsız değişkeninde getClass() çağrısı olarak yeniden yazar (null kontrolünü mesaj olmadan etkili bir şekilde korur).
  • remove, kontrolleri tamamen kaldırır.

  R8 varsayılan olarak remove_message kullanır. -processkotlinnullchecks ile ilgili tüm spesifikasyonlar bunu geçersiz kılar. Birden fazla kez belirtilirse en güçlü değer kullanılır.

  -processkotlinnullchecks, AGP 9.0.0'dan itibaren desteklenir.

Aşağıda, ek optimizasyonun etkinleştirildiği bir yapılandırma örneği verilmiştir:

-repackageclasses
-allowaccessmodification

Optimizasyonu sınırlamaya yönelik genel seçenekler

Aşağıdaki genel seçenekler, uygulama optimizasyonunun belirli yönlerini devre dışı bırakmanıza olanak tanır ve saklama kurallarınızı hassaslaştırırken veya R8'i ilk kez etkinleştirirken faydalıdır.

• -dontoptimize: Kod optimizasyonunu (ör. yöntem satır içi genişletme) önler. Bu seçenek geliştirme sırasında kullanılabilir ancak üretim derlemelerinde kullanılmamalıdır.
• -dontshrink: Referans verilmeyen kodun ve kod optimizasyonlarının kaldırılmasını önler. Bu seçenek geliştirme sırasında kullanılabilir ancak üretim derlemelerinde kullanılmamalıdır.
• -dontobfuscate: Sınıf ve yöntem adlarının kısaltılmasını önler. Yığın izlemelerinin (stack trace) daha kolay okunabilmesi için hata ayıklama sırasında kod karartmayı devre dışı bırakmak özellikle yararlı olabilir. Bu seçenek geliştirme sırasında kullanılabilir ancak üretim derlemelerinde kullanılmamalıdır.
• -keepattributes <attributes>: Korunması gereken özelliklerin virgülle ayrılmış listesini kabul eder. Varsayılan proguard-android-optimize.txt dosyasını kullanmıyorsanız R8, RuntimeVisibleAnnotations ve Signature dahil olmak üzere tüm özellikleri kaldırır. Ancak yansıtma gibi durumlarda bu özelliklere ihtiyaç duyulursa korunmaları faydalı olabilir. Belirtebileceğiniz özelliklerin listesi için Saklama özellikleri bölümünü inceleyin.

Saklama özellikleri

Özellikler, kodunuzun farklı bölümlerine eklenen ek bilgilerdir. Özellikler, kodunuzdaki ek açıklamalar ve genel imzalar gibi bilgileri depolar.

Belirli yansıtıcı işlemlerin başarılı bir şekilde yürütülmesi için belirli özelliklerin korunması gerekir. Örneğin:

• getEnclosingMethod() veya getDeclaredClasses() kullanarak iç veya dış sınıf yapısına erişirken EnclosingMethod ve InnerClasses özellikleri gerekir.
• getTypeParameters() kullanılarak genel imzalara erişilirken Signature özelliği gerekir.

• getAnnotation() kullanarak açıklamalara erişirken RuntimeVisibleAnnotations özelliği gerekir.

Genellikle gerekli olan özellikler

Varsayılan ProGuard dosyası (proguard-android-optimize.txt veya proguard-android.txt) kullanılırken Android Gradle eklentisi (AGP) aşağıdaki özellikleri korur. Bu özelliklerden bazıları için AGP'nin daha yeni sürümlerinin gerektiğini unutmayın:

proguard-android-optimize.txt kullanan uygulamalarda, AGP tarafından tanımlanan saklama kuralları çoğu senaryoda yeterlidir. Ancak bir kitaplık için kod yazıyorsanız bu listede tanımlanmış olsalar bile kitaplığınızın gerektirdiği tüm özellikleri tüketici saklama kurallarında belirtmeniz gerekir. Bu, geliştiriciler proguard-android-optimize.txt dosyasını dahil etmemeye karar verirse kitaplığınızın sağlam olmasını sağlar.

Ek saklama özellikleri

Saklanacak ek özellikler belirtebilirsiniz ancak bu özellikler, yansıtıcı veya JNI erişim senaryolarının büyük çoğunluğu için gerekli değildir. Ancak kitaplıklar optimize edilirken bu işlemlerden bazıları hâlâ sık sık kullanılabilir.

Eski ProGuard seçeneklerini kaldırma

R8, yalnızca ProGuard'da etkisi olan bazı seçenekleri kabul eder ancak bunları yoksayar. Bu seçenekler genellikle ProGuard'dan taşınan veya eski projelerden kopyalanan yapılandırmalarda kalır. R8 çıkışı üzerinde etkileri olmadığından, yapılandırmanızın anlaşılmasını ve sürdürülmesini kolaylaştırmak için bunları proguard-rules.pro dosyanızdan kaldırın.

R8, aşağıdaki seçenekleri uyarı vermeden yoksayar:

• -adaptkotlinmetadata
• -android
• -dontpreverify
• -dontskipnonpubliclibraryclasses
• -dontskipnonpubliclibraryclassmembers
• -dontusemixedcaseclassnames
• -forceprocessing
• -mergeinterfacesaggressively
• -optimizationpasses
• -optimizations
• -overloadaggressively
• -target
• -verbose

R8, aşağıdaki seçenekleri yoksayar ve derleme sırasında uyarı bildirir:

• -addconfigurationdebugging (destek, AGP 9.0'da kaldırıldı)
• -assumenoescapingparameters
• -assumenoexternalreturnvalues
• -assumenoexternalsideeffects
• -dump
• -useuniqueclassmembernames

R8, -skipnonpubliclibraryclasses öğesini desteklemez ve yapılandırmanızda bu öğe varsa hata bildirir.