Uygulama Boyutu Optimizasyonu: ProGuard, R8 Kod Karıştırma ve Dinamik Özellik Modülleri (Dynamic Delivery)
Bölüm 1: Bu Nedir ve Neden Hayati Önem Taşır?
Hayalinizdeki uygulamayı aylarca kodladınız, test ettiniz, son derece gurur duyduğunuz bir “APK” veya “App Bundle” dosyası çıktı. Mağaza sayfasını hazırladınız, “Yayınla” butonuna bastınız. Peki, kullanıcı “İndir” butonuna bastığında ne olur? Eğer dosyanız 150 MB civarındaysa ve kullanıcının interneti biraz yavaşsa ya da telefonunun depolama alanı doluysa… O kullanıcıyı kaybedersiniz. İşte uygulama boyutu optimizasyonu tam da bu noktada devreye girer; kullanıcının “İndir” diyip vazgeçmesi ile “Aç” diyip hayran kalması arasındaki ince çizgidir.
Bunu bir ev taşımacılığına benzetelim. ProGuard ve R8, taşımacılık firmasının “gereksiz eşyaları atıp, kutuları en az yer kaplayacak şekilde dizmesi” işlemidir. Dynamic Delivery (Dinamik Özellik Modülleri) ise “Müşteri şimdilik sadece yatak odasını istiyor, mutfak eşyalarını üç ay sonra getireceğiz” diyerek kamyonu boşaltmaktır. Kullanıcı telefonuna sadece o an ihtiyaç duyduğunu indirir, cihazı şişirmezsiniz. Bu, sadece depolama tasarrufu değil; indirme hızı, kurulum oranı (conversion rate) ve hatta Play Store sıralamanız için de gizli bir sıralama faktörüdür. Küçük dosya, büyük kazanç demektir.
Bölüm 2: Perde Arkası: Sistem Nasıl Çalışıyor?
Her şey derleme anında başlar. Siz build butonuna bastığınızda, kodunuz (Java/Kotlin) önce bayt koduna (DEX) dönüşür. İşte tam bu noktada R8 (eski adıyla ProGuard) sahneye çıkar. R8, kodunuzun üzerinden “ağır bir süpürge” gibi geçer. Üç temel işi vardır: Küçültme (Shrinking), İnceleme/Optimizasyon (Optimization) ve Karıştırma (Obfuscation).
Küçültme aşamasında, projenizde tanımlı ama hiç çağrılmayan sınıflar, metotlar, alanlar (o yazdığınız ama unuttuğunuz helper fonksiyonlar) tespit edilip silinir. Optimizasyon aşamasında ise kodunuz daha hızlı çalışacak ve daha az yer kaplayacak şekilde yeniden yazılır; örneğin bir metot sadece bir yerde çağrılıyorsa, o metot çağrısı kaldırılıp kod doğrudan oraya yerleştirilir (inlining). Son olarak karıştırma: Sınıf isimleriniz UserProfileManager olmaktan çıkıp a.b.c gibi anlamsız, kısaltılmış harflere dönüştürülür. Bu, hem boyutu düşürür hem de tersine mühendisliği (reverse engineering) zorlaştırır. Dynamic Delivery ise tamamen farklı bir mimaridir: Uygulamanızı “Ana Modül” (base module) ve “Özellik Modülleri” (feature modules) olarak böler. Play Store, kullanıcının cihazına ve isteğine göre sadece gerekli modülleri sunar.
Bölüm 3: Bilim Dunyasi ve Uzmanlar Nasil Inciler?
Mühendislik topluluğu bu konuyu “İkili Optimizasyon” (Binary Optimization) ve “Modüler Mimariler” başlıkları altında inceler. Google’ın Android ekibi, R8’ı ProGuard’ın halefi olarak konumlandırırken; “ProGuard kural dosyalarını (proguard-rules.pro) koruyan, ancak çok daha agresif ve hızlı bir grafik tabanlı analiz yapabilen” bir araç olarak tanımlar. Uzmanlar, R8’ın “Tam Program Analizi” (Whole Program Analysis) yeteneğine dikkat çeker; ProGuard sadece sınıf seviyesinde bakarken, R8 metot gövdeleri içindeki veri akışını (data flow) takip ederek çok daha cesur optimizasyonlar yapabilir.
Dynamic Delivery (şimdi Play Feature Delivery olarak biliniyor) konusunda ise odaklanılan nokta “Kurulum Zamanı” (Install-time) ile “İsteğe Bağlı” (On-demand) teslimat stratejilerinin maliyet-fayda analizidir. Araştırmacılar ve senior mimarlar, her özelliği modül yapmanın “modül sayısının patlaması” (module explosion) riskini getirdiğini, bu yüzden “Çekirdek özellikler ana modülde, niched/az kullanılan özellikler dinamik modülde” kuralını önerirler. Pratikte en büyük ders: R8’ı “Full Mode”da çalıştırmak ProGuard’dan farklı davranır; testlerinizi bu modda yapmazsanız üretimde çökme (crash) riskiniz çok yüksektir.
Bölüm 4: Önemli Parametreler ve Karşılaştırma Rehberi
| Parametre | Değer / Özellik | Pratik Anlamı | Günlük Hayata / Sisteme Etkisi |
|---|---|---|---|
| R8 Full Mode | android.enableR8.fullMode=true |
ProGuard uyumluluğunu bozar, en agresif optimizasyonu açar. | Kod %10-15 daha küçülür ama reflection kullanan kütüphaneler (Gson, Room) patlar; kural yazmak zorundasınız. |
| Minify Enabled | minifyEnabled true |
Küçültme ve karıştırma motorunu (R8) aktif eder. | Release build’ınızın boyutu aniden düşer; debug build’inde kapalı tutulur ki hata ayıklama kolay olsun. |
| Shrink Resources | shrinkResources true |
Kullanılmayan drawable, layout, string kaynaklarını siler. | res klasöründeki “o eski logo” dosyaları APK’ya binmez; dosya boyutu %5-10 düşer. |
| Dynamic Feature Module | dist:module (onDemand / installTime) |
Özellikleri ana APK’dan ayırır. | Kullanıcı “Ödeme” sayfasını hiç açmazsa o kod telefonuna asla inmez; ilk indirme 50MB yerine 20MB olur. |
| App Bundle (AAB) | bundle taskı ile üretilir |
Play Store’un cihaza özel APK üretmesini sağlar. | Kullanıcı xhdpi telefonu varsa mdpi/hdpi/xhdpi/xxhdpi/xxxhdpi resimlerinin hepsini değil, sadece xhdpi’yi indirir. |
| ProGuard Rules | -keep class ... kuralları |
R8’in silmemesi/karıştırmaması gerekenleri işaretler. | Yanlış kural = hata; eksik kural = çökme; doğru kural = güvenli ve küçük uygulama. |
| Class Naming | dictionary / repackage |
Karıştırılmış isimlerin uzunluğunu ve yapısını kontrol eder. | a.a.a yerine a.b.c gibi daha da kısa isimler üretilerek DEX dosyası küçültülür. |
| Dex Count | 65.536 metot limiti (MultiDex) | R8 kullanıldığında bu limit nadiren zorlanır. | MultiDex’in getirdiği soğuk başlatma (cold start) gecikmesinden kurtulursunuz. |
| Baseline Profiles | baseline-prof.txt |
Sık kullanılan kod yollarını derleme öncesinde işaretler. | Uygulama açılışı %30 daha hızlanır; boyut optimizasyonu değil, performans optimizasyonudur ama R8 ile iç içedir. |
Bölüm 5: Günlük Hayatta ve Doğada Nerede Karşımıza Çıkar?
Günlük hayattan bir senaryo: Yemek Sipariş Uygulaması. Kullanıcı uygulamayı indirir. Ana modül: Restoran listesi, sepet, ödeme (herkes kullanır). Dinamik modüller: “Grup Siparişi” (az kullanılır), “AR Menü Görünümü” (sadece yüksek donanımlı telefonlarda ve meraklı kullanıcılarda), “Restoran Yönetim Paneli” (sadece restoran sahipleri için). Kullanıcı 30 MB indirip hemen yemek siparişi verir. “AR Menü” butonuna basarsa o an 15 MB’lık modül arka planda iner. Eğer hepsini tek pakette verseydiniz, 60 MB’lık bir dosya ile karşılaşırdı ve “Sonradan bakayım” diyip çıkabilirdi.
Başka bir örnek: Bankacılık Uygulamaları. “Yatırım”, “Kredi Başvurusu”, “Harcama Analizi” modülleri ayrıdır. Müşteriniz sadece para transferi yapıyorsa, on binlerce satır yatırım algoritması kodunu telefonuna indirmek hem onun internet kotasını yakar hem de uygulamanızın “ağır” algılanmasına neden olur. Doğadaki benzetme: Kamçılı Örümcek Ağı. Örümcek her boşluğa ayrı bir yapı kurmaz; merkezi bir noktadan (ana modül) ihtiyaç duyulan yöne (dinamik modül) ip atar. Gereksiz iplik harcamaz. Bu, doğanın en verimli “boyut optimizasyonu” stratejisidir.
Bölüm 6: Karşılaşılan Zorluklar ve Pratik Çözümler
En büyük tuzak: “R8 Full Mode açtım, uygulamam çöktü.” Genelde sebep Gson, Room, Retrofit veya Firebase gibi reflection (yansıma) kullanan kütüphanelerdir. R8, “Bu sınıfın hiçbir yerde new lenmediğini, metodu çağrılmadığını” görür ve siler. Ama kütüphane çalışma anında “Bu sınıfın ismi ne?” diye bakınca bulamaz. Çözüm: Kütüphanelerin kendi sağladığı ProGuard/R8 kural dosyalarını (consumerProguardFiles) kullanmak veya kendi proguard-rules.pro dosyanıza -keep kuralları eklemek.
İkinci sık sorun: Dynamic Delivery’de “Split APK” karmaşası. Test cihazınıza bundletool ile yüklerken “Activity not found” hatası alırsınız. Sebep: Modülü onDemand yapmışsınız ama SplitInstallManager ile indirmeden başlatmaya çalışıyorsunuz. Çözüm: installTime modülleri anında gelir, onDemand modüller için mutlaka indirme akışı (loading dialog + callback) yazılmalıdır.
Üçüncü pratik ipucu: shrinkResources true açtığınızda layoutlarınızdaki tools:keep veya tools:discard kullanmak. Bazen dinamik olarak setImageResource(R.drawable.dynamic_name) yapıyorsanız R8 o drawable’ı “kullanılmıyor” diyip siler. tools:keep="@drawable/prefix_*" ile bu desenle başlayanları koruyabilirsiniz. Son olarak: Her release’den önce Analyze APK (Android Studio -> Build -> Analyze APK) yapın. classes.dex içine bakın, a.b.c yerine hala com.sirket.uzunpaketisim görüyorsanız R8 karıştırma yapmamıştır; mapping.txt dosyasını kontrol edin.
Bölüm 7: Gelecek Perspektifi ve Yeni Gelişmeler
Gelecek, “Zero-Install” (Sıfır Kurulum) deneyimlerine doğru gidiyor. Google Play Instant ve App Clips (iOS tarafında) zaten bu yolda. Uygulama boyutu optimizasyonu artık “Play Store sıralaması için” değil, “Kullanıcı butona basmadan önce deneyimlesin” için kritik. R8 tarafında ise Kotlin’e özel optimizasyonlar (Inline classes, Coroutines state machine basitleştirme) giderek daha agresif hale geliyor. Yakında R8, Jetpack Compose’un yeniden kompozisyon (recomposition) maliyetlerini derleme anında analiz edip, gereksiz remember bloklarını veya derivedStateOf kullanımlarını optimize edebilecek seviyeye gelecek.
App Bundle standardı artık zorunlu. Yeni nesil Play Asset Delivery (PAD), büyük oyun varlıklarını (texture, ses, harita) modüllemeyi değil, doğru sıkıştırma formatını (ASTC, ETC2) ve indirme zamanını (install-time, fast-follow, on-demand) yönetiyor. Gelecekte “Boyut” kavramı tek bir sayı olmaktan çıkıp; “İlk Etkileşim İçin Gerekli Bayt Sayısı” (Bytes for First Interaction) metriğine evrilecek. Yani kullanıcı “Giriş Yap” butonunu görmek için kaç MB indirmeli? O sayıyı minimize eden kazanacak. Yapay zeka destekli “Dead Code Detection” araçları (örneğin Google’ın iç araçları veya üçüncü parti CI/CD eklentileri) artık “Bu kodu 6 aydır kimse çalıştırmadı, silinsin mi?” diye öneri getirecek.
Bölüm 8: Merak Edilen Sorular ve Cevaplar (SSS)
Soru 1: ProGuard mı R8 mi kullanmalıyım? ProGuard eskidi mi?
Cevap: Kesinlikle R8 kullanın. ProGuard artık bakım modunda (maintenance mode). R8, ProGuard’ın tüm kurallarını (proguard-rules.pro) anlar, üstünde çok daha hızlı çalışır (tek geçişte yapar) ve daha iyi optimizasyon yapar. gradle.properties dosyanıza android.enableR8=true (varsayılan açık) ve android.enableR8.fullMode=true (cesur iseniz) yazmanız yeterli.
Soru 2: R8 Full Mode açtım, uygulamam çöktü. Ne yapmalıyım?
Cevap: Panik yapmayın, bu normal. Genelde Gson, Room, Retrofit, EventBus veya reflection kullanan kodlar patlar. İlgili kütüphanenin GitHub sayfasına gidin “ProGuard/R8 rules” bölümünü bulun ve proguard-rules.pro dosyanıza yapıştırın. Kendi kodunuzda @Keep anotasyonu veya -keep class com.siz.paket.Model { *; } kurallarıyla veri modellerinizi koruyun.
Soru 3: Dynamic Feature Module (Dinamik Modül) ekledim ama boyut hiç düşmedi, hatta arttı mı?
Cevap: Eğer modülü installTime (kurulum anında) yaparsanız, kullanıcı yine o modülü indirmek zorundadır, boyut ana APK’dan modüle kayar, toplam indirme boyutu değişmez (hatta metadata eklenince biraz artar). Kazancı görmek için modülü onDemand (isteğe bağlı) yapmalı ve kullanıcı o özelliği istediğinde indirmelisiniz. Veya removable modül yapıp kullanıcı silerse alan kazandırın.
Soru 4: shrinkResources true yapınca bazı resimlerim kayboldu, neden?
Cevap: R8 kaynakları (resim, layout) statik analizle tarar. Eğer R.drawable.logo gibi bir referans kodda yoksa (örneğin sunucudan gelen bir string ile resources.getIdentifier("logo_" + id, "drawable", packageName) yapıyorsanız), R8 bunu “kullanılmıyor” sayar ve siler. Çözüm: res/raw/keep.xml dosyası oluşturup <resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@drawable/logo_*"/> yazmak.
Soru 5: App Bundle (AAB) yükledim, test cihazıma APK nasıl kurarım?
Cevap: Play Console’a “Internal Test” (Dahili Test) kanalına yükleyip oradan indirmek en sağlıklısıdır. Yerel olarak test etmek için Android Studio’nun Build > Build Bundle(s) / APK(s) > Build APK(s) seçeneği AAB üretmez, evrensel (universal) APK üretir (tüm ekran boyutları, diller, mimariler dahil = çok büyük). Gerçek cihaza özel APK üretmek için terminalde bundletool build-apks --bundle=app.aab --output=app.apks --connected-device komutunu kullanın.
Soru 6: Kod karıştırma (Obfuscation) güvenlik mi sağlar, boyut mu küçültür?
Cevap: İkisini birden. İsimleri a, b, c yaparak DEX dosyasındaki string havuzunu (string pool) küçültür, bu da boyutu düşürür. Tersine mühendisliği (reverse engineering) zorlaştırır; hırsız kodunuzu kopyalayıp markasını değiştirip yayınlamak istediğinde UserManager yerine a.b.c görür, mantığını kavramak için aylar harcar. Ancak şifreleme değildir, sadece okunmazlık kazandırır. Hassas anahtarları (API keys) kodda tutmayın yine de.
Bölüm 9: Bilmeniz Gereken Temel Terimler
R8 (Artı Sekiz): Google’ın geliştirdiği, ProGuard’ın yerini alan yeni nesil kod küçültücü, optimize edici ve karıştırıcı. ProGuard kural dosyalarıyla uyumludur ama çok daha hızlı ve agresiftir. Halk dili: “Kodunuzu temizleyen, sıkıştıran ve isimlerini değiştiren süper derleyici eklentisi.”
ProGuard Rules (ProGuard Kuralları): R8’e “Bu sınıfı silme”, “Bu metodu karıştırma”, “Bu anotasyonu koru” diye talimat verdiğimiz metin dosyası (proguard-rules.pro). Halk dili: “Derleyiciye ‘Buna dokunma, bu hassas’ diye yazdığımız uyarı listesi.”
Dead Code Elimination (Ölü Kod Eleme): Hiç çağrılmayan, erişilemeyen kod parçalarının (sınıflar, metotlar, alanlar) derleme aşamasında silinmesi. Halk dili: “Kullanmadığınız o eski fonksiyonları, yazdığınızı unuttuğunuz sınıfları çöpe atma işlemi.”
Dynamic Feature Module (Dinamik Özellik Modülü): Uygulamanın ana gövdesinden (base module) ayrılarak, kullanıcı istediğinde veya cihaz özelliklerine göre indirilebilen modüler parçalar. Halk dili: “Uygulamanın ‘ekstra bölümleri’; ana paketin içinde gelmez, lazım olunca marketten indirilir.”
App Bundle / AAB (Android App Bundle): Play Store’a yüklenen, cihaza özel optimize edilmiş APK’ları üretmek için gerekli tüm kodu ve kaynakları içeren yayın formatı. Halk dili: “Play Store’un ‘Bu telefona sadece onun için kesilmiş özel bir paket hazırla’ diyebilmesi için verdiğimiz ana hamur.”
Split APKs (Bölünmüş APK’lar): AAB’dan Play Store tarafından üretilen, cihazın mimarisine (arm64, x86), ekran yoğunluğuna (hdpi, xhdpi) ve diline (tr, en) göre özel olarak kesilmiş küçük APK dosyaları. Halk dili: “Kullanıcının telefonuna tam uyan, fazladan hiçbir şey içermeyen ince ince paketler.”
Minify / Shrinking (Küçültme): Kod ve kaynak seviyesinde kullanılmayan öğelerin silinmesi işlemi. minifyEnabled true ve shrinkResources true ile aktif edilir. Halk dili: “Valizden giymediğiniz kıyafetleri çıkarıp sadece girecekleri koyma sanatı.”
Obfuscation / Name Mangling (İsim Karıştırma / Değiştirme): Anlamlı sınıf/metot/değişken isimlerinin (getUserProfile) anlamsız tek harflere (a, b) dönüştürülmesi. Halk dili: “Kodunuzun haritasını yakan, hırsızların yolu kaybetmesi için sokak isimlerini ‘Sokak 1, Sokak 2’ yapma işlemi.”
Bölüm 10: Ozet ve Cikarilmasi Gereken Dersler
Uygulama boyutu optimizasyonu, “şirket politikası” değil, kullanıcı saygısı ve pazarlama stratejisidir. Bu yazıdan çıkarmanız gereken altın kurallar şunlardır:
- R8’ı Full Mode’da Çalıştırın (Dikkatli Olmak Kaydıyla):
android.enableR8.fullMode=truemodern standarttır. Kütüphane kurallarını (consumerProguardFiles) güncelleyin, kendi modelleriniz için-keepyazın. Bu, en büyük boyut düşüşünü verir. - App Bundle (AAB) Zorunludur: APK yüklemeyin. Play Store’un
Split APKüretmesine izin verin. Kullanıcı sadece ihtiyaç duyduğu mimari, dil ve ekran kaynağını indirsin. - Modüler Düşünün, Ama Abartmayın: Her ekranı modül yapmayın. “Herkes kullanır” (Giriş, Ana Sayfa, Profil) -> Base Module. “Az kullanılır / Büyük boyutlu” (AR, Video Sohbet, PDF Görüntüleyici, Yatırım) -> Dynamic Feature Module (onDemand).
- Kaynakları Da Küçültün:
shrinkResources trueaçın.tools:keepile dinamik referans verdiğiniz drawable’ları koruyun. Vektör drawable (VectorDrawable) kullanın, PNG/JPG’leri minimumda tutun. - Analiz Etmeyi Unutmayın: Her release candidate’ta
Build > Analyze APKyapın.classes.dexboyutuna,resboyutuna,resources.arscboyutuna bakın. “Neden bu kadar büyük?” diye sorun.mapping.txtdosyasını versiyon kontrolüne (Git) koyun, crash loglarını (Play Console / Firebase Crashlytics) okumak için şarttır.
Son Söz: Küçük bir dosya, hızlı bir indirme demektir. Hızlı indirme, daha fazla kurulum demektir. Daha fazla kurulum, daha fazla kullanıcı demektir. Matematik basit: Boyutu küçültün, büyüyin.