R8: wat is het, mogelijkheden en vergelijking met ProGuard

Wat is R8?

R8 is een programma voor het verwerken en transformeren van bytecode, ontwikkeld door Google als vervanging voor ProGuard in het Android-ecosysteem. In tegenstelling tot ProGuard, dat als een aparte tool werkt in de fase van class-bestanden, is R8 direct geïntegreerd in de DEX-compiler (D8/R8). Hierdoor kan R8 analyse en optimalisatie op een dieper niveau uitvoeren, ontoegankelijk voor externe tools.

Architectuur van R8

R8 ontvangt Java-bytecode in de vorm van class-bestanden of JAR-archieven en converteert deze in één enkele doorgang naar geoptimaliseerde DEX-code. De ingebouwde R8-optimalisator voert meer dan 50 verschillende typen transformaties uit — van eenvoudig (inline van constanten) tot complex (analyse van typebereikbaarheid met precisie tot op individueel veldniveau). Volgens Google is de architectuur van R8 speciaal ontworpen voor multi-threaded werking, wat een hoge buildsnelheid garandeert.

Ontwikkelingsgeschiedenis

R8 werd aangekondigd op Google I/O 2018 en voor het eerst opgenomen in Android Gradle Plugin 3.4 (2019) als optionele vervanging voor ProGuard. In AGP 7.0 werd R8 de standaard tool voor alle projecten, en in AGP 8.0 (2023) werd de ondersteuning voor ProGuard volledig uit de plugin verwijderd. Vanaf 2025 is R8 de enige officiële obfuscatie- en optimalisatietool voor Android, aanbevolen door Google.

Belangrijkste functies van R8

R8 biedt ontwikkelaars een set krachtige mogelijkheden die ProGuard qua efficiëntie aanzienlijk overtreffen. Laten we de belangrijkste bekijken.

Minificatie en codecompressie

R8 voert een globale analyse uit van de applicatiecode en al zijn afhankelijkheden, waarbij bereikbare klassen en methoden worden bepaald via de callgraph vanaf ingangspunten. De analyse van R8 is nauwkeuriger dan die van ProGuard dankzij toegang tot de DEX-representatie van de code. R8 kan niet alleen hele klassen en methoden verwijderen, maar ook individuele velden die nooit worden gebruikt. Volgens Google-tests verwijdert R8 gemiddeld 15% meer code dan ProGuard op dezelfde projecten.

Desugaring van Java 8+

Ingebouwde desugaring — een unieke mogelijkheid van R8 die ontbreekt in ProGuard. R8 converteert automatisch lambda-expressies, methodereferenties, interfaces met default-methoden en try-with-resources van Java 8+ naar achterwaarts compatibele code die werkt op alle Android API-niveaus. Dit bevrijdt de ontwikkelaar van de noodzaak om een aparte desugar_jdk_libs-bibliotheek aan te sluiten en handmatig desugaring te configureren.

Optimalisatie op DEX-niveau

Omdat R8 de uiteindelijke DEX-indeling ziet, kan het optimalisaties uitvoeren die onmogelijk zijn voor ProGuard. R8 combineert identieke tekenreeksconstanten, verwijdert ongebruikte uitzonderingen, optimaliseert switch-constructies en voert agressieve inlining uit met herschrijving van de callgraph. Deze optimalisaties verkleinen niet alleen de APK-grootte, maar verbeteren ook de prestaties van code-uitvoering op ART.

// build.gradle expliciete inschakeling van R8 (optioneel in AGP 8.0+)
android {
    compileSdk 34
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile(
                'proguard-android-optimize.txt'
            ), 'proguard-rules.pro'
        }
    }
}

// gradle.properties — R8 geforceerd inschakelen
android.enableR8.fullMode=true

Vergelijking tussen R8 en ProGuard

De keuze tussen R8 en ProGuard is alleen relevant voor projecten die AGP ouder dan 8.0 gebruiken. Laten we voor het begrijpen van de architecturale verschillen de vergelijking op basis van belangrijke parameters bekijken.

Uiteindelijke APK-grootte

Google-tests op een steekproef van 100 populaire Play Store-apps toonden aan dat R8 de APK-grootte gemiddeld met 18% vermindert in vergelijking met ProGuard. In sommige projecten met actief gebruik van Java 8+ syntax en bibliotheken van derden bereikte het verschil 28%. Voor een app van 40 MB betekent dit een besparing van 5 tot 11 MB, wat cruciaal is voor gebruikers met beperkt dataverkeer.

Compatibiliteit met Kotlin

Beide tools verwerken Kotlin-code correct, maar R8 optimaliseert Kotlin-specifieke constructies beter: lambda's, inline-functies, coroutines en null-safe typen. R8 begrijpt de semantiek van Kotlin-metadata en kan veilig overbodige null-checks verwijderen en inline-functies inlijnen. Voor Kotlin-projecten is R8 de door Google aanbevolen tool.

R8 configureren in een Android-project

Het configureren van R8 vereist minimale wijzigingen in de buildconfiguratie, omdat de tool in AGP 8.0+ standaard wordt gebruikt. Laten we de belangrijkste aspecten van de configuratie bekijken.

R8 volledige modus

R8 full mode (android.enableR8.fullMode=true) activeert agressievere optimalisaties die een extra vermindering van de APK-grootte met 5-10% geven. In deze modus voert R8 een diepere analyse van de code uit, waarbij klassen en methoden worden verwijderd die ProGuard als bereikbaar zou beschouwen. De volledige modus kan aanvullende -keep-regels vereisen voor bibliotheken die reflection gebruiken.

# gradle.properties — inschakeling van R8 volledige modus
android.enableR8.fullMode=true

# Aanvullende regels voor full mode
-keep class com.example.reflection.** { *; }
-keep class * implements android.os.Parcelable {
    public static final android.os.Parcelable$Creator *;
}

Debuggen van R8-problemen

Bij fouten in de release-build met R8 raadt Google aan: controleer het mapping-bestand voor deobfuscatie van de stacktrace, schakel fullMode tijdelijk uit om het probleem te isoleren, voeg -whyareyoukeeping toe om te begrijpen waarom een klasse niet is verwijderd, en gebruik de --info-vlag van Gradle voor een gedetailleerde log van de R8-verwerking.

Integratie met CI/CD

Voor automatisering van builds met R8 in CI/CD is het belangrijk om mapping-bestanden als build-artefacten te bewaren. Elk mapping-bestand moet worden gekoppeld aan het versienummer en de buildvariant. Google raadt aan om build/outputs/mapping/ samen met APK/AAB te archiveren in een artefactbeheersysteem. Dit zorgt voor de mogelijkheid om crashes uit elke app-versie te deobfusceren.

Beste praktijken voor werken met R8

Jarenlange ervaring met het gebruik van R8 in de Android-gemeenschap heeft een reeks bewezen praktijken opgeleverd die helpen bij het vermijden van typische problemen en het maximaliseren van de voordelen van de tool.

Gefaseerde implementatie

Bij de overgang van ProGuard naar R8 wordt aanbevolen te beginnen met AGP 7.x, waar R8 standaard is ingeschakeld maar fullMode is uitgeschakeld. Na verificatie van de buildstabiliteit op een volledige set apparaten en scenario's kan fullMode worden ingeschakeld. Elke fase vereist het testen van de release-build op fysieke apparaten met verschillende Android-versies.

Monitoren van mapping-bestanden

R8-mappingbestanden hebben hetzelfde formaat als ProGuard, maar bevatten meer informatie dankzij de gedetailleerdere analyse. Google raadt aan: bewaar mapping-bestanden voor onbepaalde tijd — ze zijn nodig voor deobfuscatie van crashes van oude versies; integreer mapping-bestanden met Firebase Crashlytics via automatische upload; controleer regelmatig of deobfuscatie in de Firebase-console de klassennamen correct herstelt.

Testen met R8 full mode

De volledige modus van R8 kan code verwijderen die in de standaardmodus als bereikbaar wordt beschouwd. Kritieke gebieden om te testen: schermen met WebView (R8 kan bridge-interfaceklassen verwijderen), apps met plugins via classLoader, bibliotheken voor analyse en crashrapportage, en aangepaste views in layout-bestanden die via inflate worden gemaakt.

Monitoren van buildgrootte

Google raadt aan om de APK-grootte na toepassing van R8 in elke build te volgen. Gebruik APK Analyzer in Android Studio om de grootte van afzonderlijke componenten te vergelijken: classes.dex, resources.arsc en native code-bibliotheken. R8 kan de grootte van DEX-bestanden niet-lineair beïnvloeden — soms leidt agressieve optimalisatie tot een grotere omvang door inlining. Regelmatige monitoring helpt bij het tijdig opsporen van anomalieën en het aanpassen van obfuscatiergels.

// Voorbeeld van een klasse die wordt bewaard voor Firebase Crashlytics
@Keep
class CrashLogger {
    fun logException(e: Throwable) {
        FirebaseCrashlytics.getInstance().recordException(e)
    }
}

// rules.pro — bewaar alle klassen met @Keep
// -keep @androidx.annotation.Keep class * { *; }