İçeriğe geç
Teknoaktif
Son haberler
Genel

Uygulama Boyutu Optimizasyonu: ProGuard, R8 Kod Karıştırma ve Dinamik Özellik Modülleri (Dynamic Delivery)

Yayın:

Bölüm 1: Bu Nedir ve Neden Hayati Önem Taşır?

Hayalinize bir valiz koyun. Içine gideceginiz yerin hava durumuna gore ceket, sandalet, bot, şapka, hatta “belki lazım olur” diye getirdiginiz o eski kablolar kutusu… Hepsini sığdırdınız ama valiz artık havada kalıyor, havaalanında size “fazla bagaj ücreti” kesiyorlar. İşte mobil uygulamalarınız da aynen bu valiz gibidir. Kullanıcınızın telefonu o valiz, uygulamanız (APK/AAB) ise içine doldurduğunuz eşyalar.

Uygulama boyutu optimizasyonu, bu valizin içini “akıllı bir şekilde” düzenlemek, gereksizleri atıp, gerekli olanları sıkıştırıp, hatta “belki lazım olur” eşyaları evde bırakıp (veya yolda alıp) yolculuğu rahatlatmaktır. Neden mi hayati? Çünkü her 6 MB’lık artış, kurulum oranınızı %1 düşürür. Kullanıcı “Yükle” butonuna bastığında progress bar dolmazsa, saniyeler içinde vazgeçer. ProGuard, R8 ve Dynamic Delivery; bu valizi hafifletip, organize eden ve zamanında teslim eden üç ustadır.

Bölüm 2: Perde Arkası: Sistem Nasıl Çalışıyor?

Düşünün ki projeniz dev bir kütüphane. Binlerce dosya, milyonlarca satır kod. Derleme anında (build time), R8 (eski adıyla ProGuard) bu kütüphaneye girer, “Kim kimleri kullanıyor?” diye sorar. Kullanılmayan sınıfları, metotları, değişkenleri “ölü kod” (dead code) ilan edip çöpe atar (Shrinking). Sonra kalan kitapların kapaklarını, sayfa numaralarını, yazar isimlerini silip sadece “A, B, C…” diye numaralandırır (Obfuscation/Karıştırma). Böylece hırsız (reverse engineer) girse bile hangi kitap ne anlatıyor anlayamaz.

Dynamic Delivery (Dinamik Özellik Modülleri) ise farklı bir oyundur. Uygulamanızı tek bir dev paket yerine, “Ana Modül” (base) ve “İsteğe Bağlı Modüller” (dynamic feature) olarak kesersiniz. Kullanıcı sadece “Profil” sayfasını açacaksa, “Ödeme” modülünü indirmez. Play Store arka planda “Şimdi bu modül lazım” der ve sadece o parçayı telefonunuza pusu gibi indirir. Bu, “İndir ve Kur” anını saniyelere indirir, depolama alanını korur.

Uygulama Boyutu Optimizasyonu: ProGuard, R8 Kod Karıştırma ve Dinamik Özellik Modülleri (Dynamic Delivery) Görsel İncelemesi
R8 derleyicisi kodunuzu bir orman gibi tarar: Kuru dalları (kullanılmayan kod) keser, sağlıklı ağaçları (gerekli kod) korur ve onlara anlamsız isimler (a, b, c) vererek haritayı karıştırır. Dynamic Delivery ise ormanın sadece ziyaret edilecek bölümünün haritasını kullanıcıya sunar.

Bölüm 3: Bilim Dünyası ve Uzmanlar Nasıl İnceliyor?

Google’ın Android ekibi ve performans mühendisleri bu konuyu “İndirme boyutu vs. Cihaz üstü boyut” ikilemi üzerinden çözerler. Akademik literatürde “Code Shrinking” ve “Modularization” başlıkları altında incelenir ama pratikte mühendisler “Mapping dosyası kayboldu, crash logunu çözemiyorum” derken, product manager’lar “Uygulama 150 MB geçti, App Store reddetti” diye panikler.

Uzmanların ortak noktası: Erken başla, sürekli ölç. “Son haftalarda optimize ederiz” demek, evin temel atıldıktan sonra “oda genişletsin” demek gibidir. Google I/O sunumlarında sürekli vurgulanan nokta: R8’in ProGuard’dan %10-15 daha hızlı ve etkili olması. Ayrıca “App Bundle” (AAB) formatı zorunlu hale getirildiği için, Dynamic Delivery artık bir “özellik” değil, “standart”tır. Uzmanlar, modül bazlı mimariye (Modular Architecture) geçmenin sadece boyut için değil, derleme hızları (build speed) ve takım çalışması (team autonomy) için de şart olduğunu söyler.

Bölüm 4: Önemli Parametreler ve Karşılaştırma Rehberi

Parametre Değer / Özellik Pratik Anlamı Günlük Hayata / Sisteme Etkisi
MinifyEnabled (R8/ProGuard) true / false Kod temizliği ve karıştırma aç/kapa düğmesi. Açıkken: Valizden gereksiz eşyalar çıkar, kilo düşer. Kapalıysa: Çöp de gider.
Shrinking (Kod Kırpma) Kullanılmayan kodları silme “Hiç çağrılmayan metotlar” çöpe atılır. Uygulama 20-30% incelir, başlatma hızlanır.
Obfuscation (Karıştırma) İsimleri a,b,c yapma Sınıf/metot isimleri anlamsız hale getirilir. Tersine mühendislik zorlaşır, IP koruma sağlanır.
Optimization (En iyileştirme) Kod yapısını basitleştirme if (true) { ... } -> { ... } gibi. Çalışma anı performansı (runtime) biraz artar.
Dynamic Feature Module dist:module / dist:onDemand Özellikleri ana paketten ayırma. İlk indirme 50 MB yerine 15 MB olur. Kalanı talepte iner.
Instant Experience dist:instant="true" Kurmadan deneme (Google Play Instant). Kullanıcı “Dene” der, saniyeler içinde içindedir. Kurulum yok.
App Bundle (AAB) Yayın formatı (Zorunlu) Play Store cihaza özel APK üretir. Kullanıcının telefonuna sadece onun işine yarayan kod/asset iner.
Resource Shrinking shrinkResources true Kullanılmayan resim/layout/xml silme. Drawable klasöründeki o 5 MB’lık kullanmadığınız arka plan resmi gider.
Dex Count (Metot Sayısı) 65.536 limiti (Multidex) Tek bir DEX dosyasının taşıma kapasitesi. Aşılırsa Multidex açılır, başlatma yavaşlar (eski cihazlarda). R8 bunu azaltır.
R8 Full Mode android.enableR8.fullMode=true Daha agresif optimizasyon (ProGuard uyumsuz). Daha küçük çıktı, ama bazı eski kütüphanelerde çökme riski var. Test şart.
Keep Rules (-keep) ProGuard/R8 kuralları “Buna dokunma, bu canlı kalmalı” listesi. Reflection, JNI, Gson/Serialization kullanan sınıflar için hayat kurtarıcı.
Split APKs / ABI Splits Mimariye göre bölme (arm64, x86) 32-bit kod 64-bit telefona gitmez. Cihaz mimarisine göre 10-15 MB tasarruf. AAB bunu otomatik yapar.
Play Asset Delivery (PAD) Büyük varlıklar (oyun assetleri) Modüller gibi ama oyunlar/içerikler için. 1 GB’lık oyun 50 MB indirip başlar, oynarken arka planda indirir.
Baseline Profiles baseline-prof.txt Yaygın kod yollarını derleme öncesi işaretleme. Uygulama ilk açılışta JIT derlemek yerine AOT gibi hızlanır. Boyut etkisi dolaylıdır.

Bölüm 5: Günlük Hayatta ve Doğada Nerede Karşımıza Çıkar?

Orman yangını söndüren helikopterleri düşünün. Su deposu sınırlıdır. Pilot her damlayı hesap eder. Uygulama boyutu optimizasyonu da budur: Sınırlı bant genişliği (mobil veri), sınırlı depolama (64 GB telefonun 50’si dolu), sınırlı pil. Kullanıcı metrobüste, zayıf sinyalde “Uygulama Güncelleniyor” beklerken, o 40 MB’lık gereksiz kütüphane (örneğin kullanmadığınız eski bir analiz SDK’sı veya hata ayıklama sembolleri) onun planını bozar.

Gerçek hayat örneği: Popüler bir yemek sipariş uygulaması. “Restoran Haritası” özelliği herkes tarafından kullanılmaz (sadece “Yakındaki Restoranlar” tıklayanlar). Bunu Dynamic Feature Module yaparsanız; harita SDK’sı (Haritalar, Yerler, Navigasyon = ~30 MB) ana paketten çıkar. Sadece menüden “Harita” butonuna basan kullanıcı indirir. Sonuç: Uygulama 80 MB’dan 50 MB’ye düştü, kurulum oranı %12 arttı.

Başka bir senaryo: Eski bir projeye R8 açtınız. Derleme geçti, Play Store’a yüklediniz. Sabah crash raporları doldu: ClassNotFoundException: com.eskikitaplik.OzelParser. Neden? R8 “Bu sınıfı kimse çağmıyor” diye silmiş. Ama siz Class.forName("com.eskikitaplik.OzelParser") ile reflection (yansıma) yapıyordunuz. R8 bunu statik analizle göremez. İşte bu yüzden -keep kuralları “aşçıların tarif notları” gibi hayati öneme sahiptir.

Uygulama Boyutu Optimizasyonu: ProGuard, R8 Kod Karıştırma ve Dinamik Özellik Modülleri (Dynamic Delivery) Detay Görseli
Dynamic Delivery mantığı: Kullanıcı “Market” modülünü kullanmıyorsa, o modül (içindeki resimler, kodlar, kütüphaneler) telefonuna asla inmez. İhtiyaç duyduğu an Play Store arka planda sessizce indirir. Bu, “İndir ve Unut” değil, “İhtiyaç Olunca Getir” felsefesidir.

Bölüm 6: Karşılaşılan Zorluklar ve Pratik Çözümler

Zorluk 1: “R8 açtım, uygulama çöktü.”
Çözüm: Panik yapmayın. build/outputs/mapping/release/mapping.txt dosyası sizin haritanızdır. Crash logundaki a.b.c() hatasını bu dosyayla eşleştirin (Android Studio -> Analyze -> Recompile… veya retrace.sh). Sonra proguard-rules.pro dosyasına -keep class com.sizin.paket.Sinif { *; } ekleyin. Reflection, JNI, Serialization (Gson, Moshi, Room), Annotation Processor (Dagger/Hilt, Room) kullanan her yer için keep kuralı yazın.

Zorluk 2: “Dynamic Module ekledim, derleme süresi uzadı.”
Çözüm: Modül sayısını abartmayın. Her modül ayrı bir Gradle projesidir. 50 modül = 50 kez konfigürasyon. “Feature” modüllerini mantıksal gruplarla birleştirin. buildSrc veya convention plugins ile ortak ayarları merkezi yönetin. org.gradle.parallel=true ve org.gradle.configureondemand=true gradle.properties e olmazsa olmazdır.

Zorluk 3: “Test cihazımda modül inmiyor / SplitInstallManager hata veriyor.”
Çözüm: Dahili test (Internal Test Track) kullanın. Play Console’a AAB yükleyin, dahili test grubuna ekleyin. Cihazda Play Store güncel olmalı. SplitInstallManager callback’lerinde SessionState.PENDING, DOWNLOADING, INSTALLED durumlarını loglayın. Ağ hatalarında RECOVERABLE_ERROR gelirse kullanıcıya “İndirme başarısız, tekrar dene” diyebilmek için UI hazırlayın.

Zorluk 4: “Kütüphane boyutunu nasıl küçültmem?”
Çözüm: implementation yerine api dikkatli kullanın (api transitif bağımlılığı yayar). debugImplementation ile hata ayıklama kütüphanelerini (LeakCanary, Chucker) release build’den ayırın. resConfigs "tr", "en" ile desteklemediğiniz dillerin string/resource’larını derleme anında atın. webp formatına geçin, vector drawable kullanın.

Bölüm 7: Gelecek Perspektifi ve Yeni Gelişmeler

Gelecek “Modüler” ve “Akıllı” olacak. Google App Bundle‘ın ötesine geçiyor: SDK Runtime (Gizlilik Korumalı Alanlar). Üçüncü taraf SDK’lar (Reklam, Analitik) artık uygulamanızın içinde değil, ayrı bir sandbox’ta çalışacak. Bu, uygulamanızın boyutunu ve sorumluluğunu ciddi oranda düşürecek.

R8 her sürümde daha agresif hale geliyor. fullMode varsayılan olacak. Baseline Profiles (Referans Profiller) artık boyut optimizasyonu değil, başlatma hızı optimizasyonunun kralı. Uygulamanızın hangi kod yollarını ilk saniyede çalıştırdığını biliyorsanız, Play Store o kodları cihaza özel derleyip (AOT) size “hazır” sunuyor.

Play Asset Delivery (PAD) oyunlar dışına taşınıyor. Büyük ML modelleri (TensorFlow Lite), AR varlıkları, harita verileri artık “Asset Pack” olarak modüle ediliyor. Kullanıcı “Çevrimdışı Harita İndir” derse 500 MB’lık paket arka planda, WiFi bekleyerek, durdurup devam ettirilebilir şekilde iniyor. Bu, Dynamic Delivery’nin “büyük veriler” için evrimleşmiş halidir.

Bölüm 8: Merak Edilen Sorular ve Cevaplar (SSS)

Soru 1: ProGuard mı R8 mı kullanmalıyım? Fark ne?

Cevap: Kesinlikle R8. ProGuard artık “bakım modunda”, yeni özellik gelmiyor. R8, Google tarafından Kotlin ve modern Java (Lambda, Record vb.) için baştan yazıldı. ProGuard’dan daha hızlı, daha iyi “tree shaking” (ağaç sallama/ölü kod temizleme) yapıyor ve tek bir adımda hem küçültme hem karıştırma hem optimizasyon yapıyor. gradle.properties içinde android.enableR8=true (varsayılan zaten bu) olmalı.

Soru 2: Dynamic Feature Module ekledim ama kullanıcı “Aç” dediğinde uygulama çöktü. Neden?

Cevap: Modülünüz onDemand (isteğe bağlı) olarak ayarlıysa, kullanıcı o özelliği açmadan önce modül telefonunda yoktur. Kodunuz Class.forName veya startActivity ile o modüldeki bir sınıfı çağırıyorsa ClassNotFoundException veya ActivityNotFoundException alırsınız. Çözüm: Özelliğe girmeden önce SplitInstallManager ile modülü indirin, INSTALLED callback’ini bekleyin, sonra ilgili Activity’yi başlatın veya sınıfı yükleyin.

Soru 3: minifyEnabled true yapınca build ne kadar uzar?

Cevap: Proje büyüklüğüne göre %20-%50 daha uzayabilir. R8 kodu tarayıp analiz etmekte zaman harcar. Ama bu sadece release (yayın) build’inde olur. Debug build’de minifyEnabled false tutun, geliştirme hızınız düşmesin. CI/CD sunucunuzda (GitHub Actions, Bitrise, GitLab CI) cache’leme yaparak bu süreyi kısaltabilirsiniz.

Soru 4: Mapping.txt dosyasını nereye koymalıyım? Kaybolursa ne olur?

Cevap: Mutlaka saklayın! Her release için mapping.txt dosyasını (ve mapping.txt.gz varsa) güvenli bir yere (Git repo’su haricinde, örn: S3, Google Drive, JFrog Artifactory, veya Play Console’a yükleyin) koyun. Kaybolursa: Kullanıcıdan gelen java.lang.NullPointerException: at a.b.c.d formatındaki crash loglarını asla okunabilir hale getiremezsiniz. Hangi satırda hata olduğunu bilemezsiniz. Play Console “Deobfuscation files” bölümüne yükleyerek bu derdi ortadan kaldırabilirsiniz.

Soru 5: Uygulama Bundle (AAB) yükledim, test cihazıma APK nasıl kurarım?

Cevap: AAB doğrudan cihaza kurulamaz. İki yollarınız var:
1. Play Console Internal Test: AAB yükleyin, dahili test grubuna kendi mailinizi ekleyin. Telefondan Play Store -> “Uygulamalarım” -> “Teste Katıl” diyerek kurun. Bu en sağlıklısı, Dynamic Delivery test edersiniz.
2. bundletool (Komut Satırı): bundletool build-apks --bundle=app.aab --output=app.apks --ks=keystore.jks ... komutuyla cihazınıza özel “Split APK” seti (.apks aslında bir zip) üretirsiniz. Sonra bundletool install-apks --apks=app.apks ile kurarsınız.

Soru 6: shrinkResources true yapınca resimlerim bozuldu/kayboldı. Ne yapmalıyım?

Cevap: R8, koddan referans verilmeyen res/drawable, res/layout, res/values dosyalarını “kullanılmıyor” diye siler. Eğer getResources().getIdentifier("resim_adi", "drawable", packageName) gibi dinamik stringlerle resource erişiyorsanız R8 bunu göremez.
Çözüm 1 (Kolayı): res/raw/keep.xml oluşturup içinde <resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@drawable/resim_adi, @layout/layout_adi" /> yazın.
Çözüm 2 (Doğrusu): Mümkünse dinamik erişimi kaldırın, doğrudan R.drawable.resim_adi kullanın.

Bölüm 9: Bilmeniz Gereken Temel Terimler

Tree Shaking (Ağaç Sallama / Ölü Kod Temizliği): Kodunuzun içinde “kimse kullanmıyor” diye duran, dallar budaklar gibi uzanan ama kökten kopmuş dalları tespit edip kesme işlemidir. R8 bunu yaparken “Bu metot kim tarafından çağrılıyor?” diye geriye doğru yürür (Graph Traversal). Ulaşamadığı her şey çöpe gider.

Obfuscation (Kod Karıştırma / Anlamsızlaştırma): Sınıf, metot, alan isimlerinizi UserManager, getUserList, apiKey yerine a, b, c yapmaktır. Mantık değişmez, sadece insan okumaz hale getirir. “Haritanın üzerindeki yer isimlerini silip sadece koordinat bırakmak” gibidir. Güvenlik için değil, tam tersine mühendisliği (reverse engineering) zorlaştırmak ve boyut kazanmak içindir.

Dynamic Feature Module (Dinamik Özellik Modülü): Uygulamanızın “Ana Gövdesi”nden (base module) koparıp, “İsteğe Bağlı Ek Parçalar” haline getirdiğiniz modüllerdir. Kullanıcı o özelliği kullanana kadar indirilmezler. “Valizde taşıdığınız ama yolda ihtiyacınız olunca satın aldığınız/kira ettiğiniz çadır” gibidir.

App Bundle (AAB – Android App Bundle): Play Store’a yüklediğiniz yeni yayın formatı. Eski .apk dosyası “herkese her şeyi” içeren tek bir dosyaydı. AAB ise “Parça parçadır”. Play Store indiren kullanıcının cihazına (ekran boyutu, işlemci mimarisi, dil, texture compression formatı) özel optimize edilmiş .apk setini (Split APKs) anında üretir ve sunar. Siz tek dosya yüklersiniz, kullanıcı sadece kendine gerekeni indirir.

Split Install API (SplitInstallManager): Dynamic Feature Modüllerini çalışma anında (runtime) yönetmek için kullandığınız Android kütüphanesidir. “Modülü indir”, “İlerlemeyi dinle”, “Kurulduğunda beni haberdar et”, “Hata olursa kullanıcıyı yönlendir” komutlarını verirsiniz. Bu, “Kargo takip numarası ve teslimat koordinatörü”nün kod karşılığıdır.

Baseline Profile (Referans Profili / Benchmark Profili): Uygulamanızın “En kritik yollarını” (Startup, Scroll, Navigation) işaretleyen bir metin dosyasıdır (baseline-prof.txt). Bunu modülünüze koyarsınız. Play Store bunu okuyup, kullanıcı uygulamayı indirirken bu yolları önceden derlenmiş (AOT) makine koduna çevirir. Uygulama ilk açılışta yorumlayıcı (Interpreter) veya JIT derleyici beklemez, doğrudan koşmaya başlar.

Bölüm 10: Ozet ve Cikarilmasi Gereken Dersler

Uygulama boyutu optimizasyonu bir “son dakika temizliği” değil, mimari bir karardır.

  1. R8’i Dost Edinin: minifyEnabled true ve shrinkResources true varsayılanınız olsun. proguard-rules.pro dosyanızı projeniz büyüdükçe güncelleyin. Mapping dosyalarını kutsayın.
  2. Modüler Düşünün: “Her şey ana modülde” deyinmezseniz Dynamic Delivery size kolay gelsin. Hangi özellik herkes tarafından kullanılmıyorsa (Ödeme, Harita, AR, Profil Düzenleme, Ayarlar), o bir Dynamic Feature Module adayıdır.
  3. AAB Zorunluluğu Bir Şans: Play Store size “Cihaza özel paketleme” hediyesi veriyor. resConfigs, abi splitleri manuel yapmaya gerek kalmadı. AAB yüklüyorsunuz, Google sizin yerinize en iyisini yapıyor.
  4. Test Etmeden Yüklemeyin: R8 açtığınızda veya modül ayırdığınızda Internal Test Track mutlaka kullanın. Gerçek cihazda, gerçek Play Store ortamında test edin. Emülatörde Dynamic Delivery çalışmaz (Play Store yok).
  5. Boyut Sadece İndirme Değil, Güvendir: Küçük uygulama = “Bu geliştiriciler işini biliyor, telefonumu

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir

Ağ Bağlantıları:İşlemci • Donanım Forumu • Bilim Haberleri • Oyun İnceleme • Donanım Rehberi
\n\n