R8: nedir, özellikleri ve ProGuard ile karşılaştırması

R8 nedir?

R8, Android ekosisteminde ProGuard'ın yerini alması için Google tarafından geliştirilen bir bayt kodu işleme ve dönüştürme programıdır. class dosyası aşamasında ayrı bir araç olarak çalışan ProGuard'ın aksine, R8 doğrudan DEX derleyicisine (D8/R8) entegre edilmiştir. Bu, R8'in harici araçların erişemeyeceği daha derin bir düzeyde analiz ve optimizasyon yapmasına olanak tanır.

R8 mimarisi

R8, girdi olarak class dosyaları veya JAR arşivleri biçiminde Java bayt kodu alır ve bunu tek bir geçişte optimize edilmiş DEX koduna dönüştürür. Yerleşik R8 optimize edici, basit (sabitlerin inline edilmesi)ten karmaşığa (alan düzeyinde hassasiyetle tip erişilebilirlik analizi) kadar 50'den fazla farklı dönüştürme türü gerçekleştirir. Google'a göre, R8 mimarisi özellikle çok iş parçacıklı çalışma için tasarlanmıştır ve yüksek derleme hızı sağlar.

Geliştirme geçmişi

R8, Google I/O 2018'de duyurulmuş ve ilk olarak Android Gradle Plugin 3.4'te (2019) ProGuard'ın isteğe bağlı bir alternatifi olarak yer almıştır. AGP 7.0'da R8 tüm projeler için varsayılan araç haline gelmiş ve AGP 8.0'da (2023) ProGuard desteği eklentiden tamamen kaldırılmıştır. 2025 itibarıyla R8, Google tarafından önerilen Android için tek resmi karıştırma ve optimizasyon aracıdır.

R8'in temel özellikleri

R8, geliştiricilere verimlilikte ProGuard'ı önemli ölçüde geride bırakan güçlü yetenekler sunar. Başlıcalarına bakalım.

Küçültme ve kod sıkıştırma

R8, uygulama kodunun ve tüm bağımlılıklarının küresel bir analizini yaparak giriş noktalarından çağrı grafiği aracılığıyla erişilebilir sınıfları ve metotları belirler. R8'in analizi, kodun DEX temsiline erişim sayesinde ProGuard'dan daha doğrudur. R8, yalnızca tüm sınıfları ve metotları değil, aynı zamanda hiç kullanılmayan bireysel alanları da kaldırabilir. Google'ın testlerine göre R8, aynı projelerde ProGuard'dan ortalama %15 daha fazla kod kaldırır.

Java 8+ desugaring

Yerleşik desugaring, ProGuard'da bulunmayan R8'e özgü bir özelliktir. R8, lambda ifadelerini, metot referanslarını, varsayılan metotlara sahip arayüzleri ve Java 8+ try-with-resources yapılarını otomatik olarak tüm Android API seviyelerinde çalışan geriye uyumlu koda dönüştürür. Bu, geliştiricinin ayrı bir desugar_jdk_libs kütüphanesi ekleme ve desugaring'i manuel olarak yapılandırma ihtiyacını ortadan kaldırır.

DEX düzeyinde optimizasyon

R8 nihai DEX biçimini gördüğü için ProGuard için imkansız olan optimizasyonları gerçekleştirebilir. R8, aynı dize sabitlerini birleştirir, kullanılmayan istisnaları kaldırır, switch yapılarını optimize eder ve çağrı grafiğini yeniden yazarak agresif inline işlemi yapar. Bu optimizasyonlar yalnızca APK boyutunu azaltmakla kalmaz, aynı zamanda ART üzerinde kod yürütme performansını da iyileştirir.

// build.gradle'da R8'i açıkça etkinleştirme (AGP 8.0+'da isteğe bağlı)
android {
    compileSdk 34
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile(
                'proguard-android-optimize.txt'
            ), 'proguard-rules.pro'
        }
    }
}

// gradle.properties — R8'i zorla etkinleştir
android.enableR8.fullMode=true

R8 ve ProGuard karşılaştırması

R8 ve ProGuard arasındaki seçim yalnızca AGP 8.0'den eski sürümleri kullanan projeler için geçerlidir. Mimari farklılıkları anlamak için temel parametrelere göre karşılaştırmaya bakalım.

Nihai APK boyutu

Google'ın 100 popüler Play Store uygulaması üzerinde yaptığı testler, R8'in APK boyutunu ProGuard'a kıyasla ortalama %18 azalttığını göstermiştir. Java 8+ sözdizimini ve üçüncü taraf kütüphaneleri yoğun kullanan bazı projelerde fark %28'e ulaşmıştır. 40 MB'lık bir uygulama için bu, 5 ila 11 MB arasında tasarruf anlamına gelir ve bu, sınırlı bant genişliğine sahip kullanıcılar için kritiktir.

Kotlin uyumluluğu

Her iki araç da Kotlin kodunu doğru şekilde işler, ancak R8 Kotlin'e özgü yapıları (lambda'lar, inline fonksiyonlar, coroutine'ler ve null-güvenli tipler) daha iyi optimize eder. R8, Kotlin meta veri anlam bilimini anlar ve gereksiz null kontrollerini güvenle kaldırabilir ve inline fonksiyonları gömebilir. Kotlin projeleri için R8, Google'ın önerdiği araçtır.

Bir Android projesinde R8 kurulumu

R8 kurulumu, derleme yapılandırmasında minimum değişiklik gerektirir, çünkü AGP 8.0+ araç varsayılan olarak kullanılır. Temel yapılandırma yönlerine bakalım.

R8 tam modu

R8 tam modu (android.enableR8.fullMode=true), APK boyutunda ek %5-10 azalma sağlayan daha agresif optimizasyonları etkinleştirir. Bu modda R8, ProGuard'ın erişilebilir olarak kabul edeceği sınıfları ve metotları kaldırarak daha derin kod analizi yapar. Tam mod, yansıma kullanan kütüphaneler için ek -keep kuralları gerektirebilir.

# gradle.properties — R8 tam modunu etkinleştir
android.enableR8.fullMode=true

# Tam mod için ek kurallar
-keep class com.example.reflection.** { *; }
-keep class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator *;
}

R8 sorunlarını hata ayıklama

R8 ile bir sürüm derlemesinde hatalar oluştuğunda Google şunları önerir: yığın izini karıştırmayı çözmek için eşleme dosyasını kontrol edin, sorunu izole etmek için geçici olarak fullMode'u devre dışı bırakın, bir sınıfın neden kaldırılmadığını anlamak için -whyareyoukeeping ekleyin ve ayrıntılı R8 işleme günlüğü almak için --info Gradle bayrağını kullanın.

CI/CD entegrasyonu

CI/CD'de R8 ile derlemeleri otomatikleştirmek için eşleme dosyalarını derleme yapıtları olarak kaydetmek önemlidir. Her eşleme dosyası, sürüm numarasına ve derleme varyantına bağlanmalıdır. Google, APK/AAB ile birlikte build/outputs/mapping/ dosyasını yapı yönetim sisteminde arşivlemeyi önerir. Bu, uygulamanın herhangi bir sürümündeki çökmeleri karıştırmayı çözme yeteneğini sağlayacaktır.

R8 ile en iyi uygulamalar

Android topluluğunda R8 kullanımındaki yılların deneyimi, tipik sorunlardan kaçınmaya ve araçtan maksimum fayda sağlamaya yardımcı olan kanıtlanmış uygulamalar oluşturmuştur.

Aşamalı geçiş

ProGuard'dan R8'e geçerken, R8'in varsayılan olarak etkin olduğu ancak fullMode'un devre dışı olduğu AGP 7.x ile başlanması önerilir. Tam bir cihaz ve senaryo setinde derleme kararlılığı doğrulandıktan sonra fullMode etkinleştirilebilir. Her aşama, farklı Android sürümlerine sahip fiziksel cihazlarda sürüm derlemesinin test edilmesini gerektirir.

Eşleme dosyası izleme

R8 eşleme dosyaları ProGuard ile aynı biçime sahiptir ancak daha ayrıntılı analiz sayesinde daha fazla bilgi içerir. Google şunları önerir: eşleme dosyalarını süresiz olarak saklayın — eski sürümlerin çökmelerini çözmek için gereklidirler; otomatik yükleme yoluyla eşleme dosyalarını Firebase Crashlytics ile entegre edin; Firebase konsolunda karıştırma çözmenin sınıf adlarını doğru şekilde geri yüklediğini düzenli olarak doğrulayın.

R8 tam modu ile test etme

R8 tam modu, standart modda erişilebilir kabul edilen kodu kaldırabilir. Test için kritik alanlar: WebView içeren ekranlar (R8, köprü arayüz sınıflarını kaldırabilir), classLoader aracılığıyla eklenti içeren uygulamalar, analitik ve çökme raporlama kütüphaneleri ve inflate yoluyla oluşturulan düzen dosyalarındaki özel görünümler.

Derleme boyutu izleme

Google, her derlemede R8'i uyguladıktan sonra APK boyutunu izlemeyi önerir. Bireysel bileşenlerin boyutunu karşılaştırmak için Android Studio'da APK Analyzer'ı kullanın: classes.dex, resources.arsc ve yerel kod kütüphaneleri. R8, DEX dosya boyutunu doğrusal olmayan şekilde etkileyebilir — bazen agresif optimizasyon, inline nedeniyle boyut artışına yol açar. Düzenli izleme, anomalileri zamanında tespit etmeye ve karıştırma kurallarını ayarlamaya yardımcı olur.

// Firebase Crashlytics için korunan sınıf örneği
@Keep
class CrashLogger {
    fun logException(e: Throwable) {
        FirebaseCrashlytics.getInstance().recordException(e)
    }
}

// rules.pro — @Keep ile tüm sınıfları koru
// -keep @androidx.annotation.Keep class * { *; }