Daha akıllı saklama kuralları sunma: Kitaplık sağlayıcılar, uygulama düzeyinde DEX kodu optimizasyonunun engellemesini nasıl kaldırabilir?
Okuma süresi: 6 dk.
Android uygulama ve kitaplık geliştiricileri olarak hepimiz aynı hedef için çalışıyoruz: Sorunsuz bir kullanıcı deneyimi sunan yüksek performanslı uygulamalar. Bunun önemli bir kısmı, Android'in uygulama optimize edicisi olan R8 ile ilgilidir. R8, kullanılmayan kodları kaldırıp geri kalanını optimize ederek ve gizleyerek uygulama performansını artırır.
Google Play, uygulamalar ve oyunlar için yeni DEX kod optimizasyonu eşiklerini kısa süre önce duyurdu. Bu eşikler, başlatma sürelerini iyileştirmeye, bellekte kaplanan yeri azaltmaya ve Android'in, kullanıcı deneyimini aşırı bellek kullanan uygulamalardan koruma taahhüdüne uymaya yardımcı olur. Bu eşikler uygulamalar ve oyunlar için geçerli olsa da bunları karşılamak ekosistem genelinde ortak bir sorumluluktur. R8, bir uygulamayı yalnızca kendisine verilen parametreler dahilinde optimize edebilir. Bu parametreler arasında, uygulamanın bağlı olduğu kitaplıklar tarafından paketlenen saklama kuralları da yer alır.
R8 Yapılandırma Analiz Aracı, Google Play'in teknik koşullarının temelini oluşturan uygulama optimizasyonu, küçültme ve kod karartma yüzdelerini değerlendirmek için mükemmel bir araçtır. R8 Configuration Analyzer, bu yüzdeleri izlemenin yanı sıra yalnızca uygulamalardan değil, uygulamaların bağlı olduğu kitaplıklarda paketlenmiş tüketici saklama kurallarından kaynaklanan verimsiz saklama kurallarını da gösterir.
Bu kılavuzda, kitaplık sağlayıcıların en sık karşılaştığı zorluklardan bazılarını nasıl çözebileceğiniz ve müşterilerinizin Google Play teknik koşullarını karşılamasına yardımcı olmak için dar kapsamlı, yüksek performanslı kuralları nasıl sunabileceğiniz açıklanmaktadır.
Tüketici saklama kuralları nedir?
Tüketici saklama kuralları, Android veya JAR kitaplığında paketlenmiş talimatlardır. Bu talimatlar, R8'e kitaplık kodunun hangi bölümlerinin uygulama düzeyinde derleme işlemi sırasında optimize edilemeyeceğini bildirir. Uygulama veya kitaplık tarafından yazılan ve yapı sadeleştirmesinde kullanılan standart saklama kurallarının aksine, tüketici saklama kuralları kitaplıklara yerleştirilir ve tüm uygulama optimizasyonu sırasında kitaplığın nasıl sadeleştirileceğini etkiler. Böylece, uygulama geliştiricinin manuel olarak tanımlamasına gerek kalmadan dahili yansıma hedefleri ve yerel arayüzler bozulmadan kalır.
Kasıtlı, dar kapsamlı tüketici saklama kuralları, hem kitaplığa hem de kitaplığı kullanan uygulamalara fayda sağlayan kritik bir en iyi uygulamadır. Aşırı geniş kapsamlı tüketici saklama kuralları, kullanılmayan kodları korur ve sonuç olarak uygulamanın optimizasyonunu ve performansını etkiler. Play Console'a eklenen DEX kodu optimizasyonu analizleri sayesinde uygulama geliştiriciler, hem uygulamanın hem de entegre kitaplıklarının kurallarının birleşik etkisini gösteren metrikleri görebilir.
Kararlılık ve performans arasında denge kurma
Kitaplık sağlayıcılar, geniş kapsamlı tüketici saklama kuralları sunarken genellikle iyi niyetlidir. Hiç kimse SDK'sının, yansıma sırasında sınıfın kaldırılması nedeniyle kilitlenmeye neden olmasını istemez.
Ancak paket genelinde veya başka bir şekilde geniş kapsamlı saklama kuralları, R8'in tüm program uygulama optimizasyonu potansiyelini ciddi şekilde sınırladığından kilitlenmeyi önleme konusunda uzun vadeli bir çözüm olarak önerilmez. Kararlılıktan ödün vermeden dar kapsamlı ve yüksek performanslı kurallar oluşturmanıza yardımcı olacak bazı stratejiler şunlardır:
1. Dar kapsamlı kuralları test etme ve kullanıma sunma
Dar kapsamlı kuralları güvenle yayınlamanıza yardımcı olacak aşağıdaki en iyi uygulamalardan yararlanabilirsiniz:
- Örnek uygulamada test etme: Optimizasyonunuzu test etme bölümündeki yerel test kılavuzu, örnek uygulamalar için de geçerlidir. R8'i etkinleştirdikten sonra, işlevlerin beklendiği gibi çalıştığından emin olmak için kritik kullanıcı yolculuklarını test edin.
- Uygulama geliştiricilerin R8 yapılandırmalarını denetlerken ne gördüklerini öğrenmek için örnek uygulamanızda R8 Yapılandırma Analiz Aracı'nı çalıştırın. Saklama kurallarınızın alt uygulamalar üzerindeki etkilerini kolayca görselleştirmenize olanak tanır.
- Korunan yöntemler, sınıflar ve alanlar dahil olmak üzere AAR veya JAR’ınızın optimizasyonunu değerlendirmek için Android KSA'daki analiz komutunu kullanın. Gerilemeleri izlemek için bu sayıları sürümler arasında karşılaştırabilirsiniz.
- Google Play SDK Console'da kitaplık sürümü kullanımını ve kilitlenmeleri izleyin.
- En iyi uygulamalar için Kitaplık yazarları için optimizasyon kılavuzuna ve R8 belgelerine bakın.
2. Geniş kapsamlı saklama kuralları olmadan yansıma ve JNI hedeflerini koruma
Geniş veya paket genelinde saklama kuralları olan bir kitaplık göndermek yalnızca SDK'nızı etkilemez. Aynı zamanda geliştiricileri, uygulama başlatma süresini yavaşlatan ve uygulama indirme boyutunu, bellek kullanımını ve ANR oranlarını artıran kod şişkinliğini kabul etmeye zorlar. Performans odaklı uygulamaların kitaplığınızla birlikte gelen kuralların yerine geçecek özel kurallar yazması da mümkündür. Bu durum, söz konusu uygulamaların riski azaltmak için gelecekteki kitaplık güncellemelerini benimsemesini de engeller.
SDK'nız oyunlar veya fotoğraf ve video düzenleyicilerdeki gibi yerel kodu hedefliyorsa JNI kullanan tüm sınıflar için kurallar sağlayın. Çoğu oyun, oyunu yerel koda derleyen Unity ve Unreal gibi oyun motorları üzerinde çalışır. Oyunun yerel kodu ve eklentiniz, JNI çağrıları aracılığıyla Android çerçevesiyle iletişim kurar.
Şu anda alfa sürümünde olan Jetpack Keep ek açıklamaları, yansıma kullanımına ek açıklama eklemenize olanak tanıyarak yansıma için gereken bakımı azaltmanıza yardımcı olabilir. Bu ek açıklamalar daha sonra derleme sırasında saklama kuralları oluşturmak için kullanılabilir.
Yansıma yerine kod oluşturmayı tercih edin
Yansıma nedeniyle kilitlenmeleri önlemek için en önemli ipucumuz, yansımadan kaçınmak ve mümkün olduğunda kod oluşturma özelliğini kullanmaktır.
Çalışma zamanı yansıması, derleme sırasında kod kullanımını R8'den gizler. Bu nedenle, kilitlenmeleri önlemek için saklama kuralları gerekir. Kod oluşturma özelliğini kullanırsanız kod, derleme işlemi sırasında optimize edilir. Böylece R8, minimum düzeyde saklama kuralıyla kodu güvenli bir şekilde optimize etmek için gerekli görünürlüğe sahip olur. Kod oluşturmanın mükemmel bir seçenek olduğu yaygın senaryolar arasında serileştirme ve serileştirmeyi kaldırma ile bağımlılık ekleme (Hilt, kod oluşturmayı kullanan bir kitaplık örneğidir) yer alır.
Ancak kod oluşturma her senaryo için doğru seçim değildir. İsteğe bağlı bağımlılıklar gibi kalıplar için yansıma hâlâ gereklidir. Yansımayı, İsteğe bağlı bağımlılıkları desteklemek için yansıma ile ilgili kılavuzda açıklandığı gibi yalnızca gerekli giriş noktalarını koruyan dar kapsamlı saklama kurallarıyla eşlemenizi öneririz.
Önceden optimize edilmiş kitaplık derlemeleri için bile kuralları dar kapsamlı tutun
Yansımadan kaçınmak mümkün değilse tüketici saklama kurallarınızın yalnızca kitaplığınızın yansıttığı öğeleri belirttiğinden emin olun. Kitaplığınız bir sınıfa veya yönteme dinamik olarak eriştiğinde yalnızca giriş noktasını belirtmeniz yeterlidir. Geri kalanını R8 halleder. R8, referans verilen kodun grafiğini oluşturmak ve referans verilmeyen sınıfları, yöntemleri ve alanları kaldırmak için giriş noktalarını kullanır.
Bu durum, kitaplık derlemenizi optimize ettiyseniz veya gizlediyseniz de geçerlidir. Bu, performanslı ve hafif bir SDK sağlamak için mükemmel bir yöntemdir. Kurallarınız uygulamanın derleme adımında uygulandığından R8, kitaplığınızı alt uygulamada kullanılan gerçek sınıflara ve yöntemlere göre daha da optimize edebilir. Android KSA analiz komutu, engellenen optimizasyona katkıda bulunan hem kullanılan hem de kullanılmayan paket genelindeki saklama kurallarını proaktif olarak gösterir.
Üçüncü taraf bağımlılıkları için saklama kurallarını dar kapsamlı tutun
Bu, sık karşılaştığımız bir durumdur:
-keep public class com.google.android.gms.** { *; }SDK'nızı entegre eden bir uygulama başka bir GMS kitaplığı da kullanıyorsa ve saklanan kod miktarını sınırlamak için bir saklama kuralı içeriyorsa bu geniş kural, saklama kuralının yerini alarak uygulamanın gereksiz yere şişmesine neden olur.
Harici kitaplıkları çağırırken, kitaplığınızın yalnızca yansıma yoluyla eriştiği belirli öğeleri kesinlikle koruyan saklama kuralları tasarlamanız gerekir. Ayrıca, GMS dahil olmak üzere birçok kitaplık kendi tüketici saklama kurallarını zaten gönderir. Paket genelinde bir saklama kuralı eklemek, alt kitaplıktaki dikkatlice yazılmış, dar kapsamlı tüketici kurallarını da kapsayabilir.
Reklam uyumlulaştırma bağdaştırıcıları için koşullu saklama kurallarını kullanma
Reklam kitaplığınız uyumlulaştırma bağdaştırıcıları kullanılarak yükleniyorsa dar kapsamlı saklama kuralları hâlâ bir seçenektir. Bu senaryoda, uygulama ilgili bağdaştırıcıyı içeriyorsa yalnızca belirli özellikleri veya biçimleri korumak için koşullu saklama kurallarını kullanmanızı öneririz. Bu sayede R8, uygulamanın kullanmadığı özellikleri küçültmeye devam edebilir. Başka bir seçenek olarak, karmaşık kuralları manuel olarak yazmak yerine Jetpack Keep ek açıklamalarını kullanarak yansıtıcı çağrılarınıza doğrudan kaynak kodunda ek açıklama ekleyebilir ve isteğe bağlı eklenti modülleri de dahil olmak üzere koşullu tüketici saklama kurallarını otomatik olarak oluşturabilirsiniz.
Kuralları belgelerde değil, tüketici kurallarında yayınlayın
Tüketici kurallarını kitaplığınızla birlikte göndererek R8 özellikli derlemeye sahip uygulamaların kitaplığınızı kullanıma hazır şekilde kullanabilmesini ve maksimum optimizasyondan yararlanmasını sağlarsınız.
Dokümanlarınızda kuralları belirtmek, manuel kurulum zorluğu ekler (özellikle de paket halinde sunulan tüketici saklama kuralları yıllardır AAR'lerde ve JAR'larda desteklendiğinden) ve sürekli bakım yükü oluşturur. Kitaplığınızı güncellediğinizde (yeniden düzenleme, sınıfları yeniden adlandırma ve yansıtmanın kullanım şeklini değiştirme dahil) dokümanları güncellemeyi, uygulamalar da yeni kuralları kontrol etmeyi unutmamalıdır. Zaman içinde uygulamalar, kitaplığınızın birden fazla sürümüne yükseltildikçe artık ihtiyaç duyulmayan eski saklama kuralları birikebilir ve bu da uygulamanın gereksiz yere şişmesine neden olabilir.
3. Sürüm yığın izlemeleri okunuyor
Kodun gizlenmesi nedeniyle okunamaz bir yığın izleme (stack trace) ile karşılaşmış olabilirsiniz. Kritik analizlerin engellenmesini önlemek için keepnames kullanmak cazip gelebilir. Bu seçenek küçültmeye izin verir ancak tüketen uygulamada yeniden adlandırma gibi ek optimizasyonları engeller. Bu optimizasyonlar, yığın izleme (stack trace) hata ayıklaması yaparken ihtiyaç duyduğunuz değerlerdir.
Okunabilir yığın izlemeleri (stack trace) elde etmek için ek optimizasyonları engellemeniz gerekmez.
Firebase Crashlytics, Google Play Console ve Android Studio'daki Logcat, uygulama geliştiriciler için yığın izlemelerin kodunu çözer. Bu sayede, bir uygulama geliştirici sizinle yığın izleme (stack trace) paylaştığında bunu okuyabilmek için kod karartmayı engellemeniz gerekmez.
Eşleme dosyanızı SDK Console'a yüklerseniz SDK Console'da kodu görünen yığın izlemeleri görebilirsiniz.
Optimizasyon sürecinde tahminlere dayalı kararlar almaktan kaçının
Kitaplığınızı optimize etmek deneme yanılma oyunu gibi hissettirmemeli.
Kitaplık sağlayıcılar, tüketici saklama kurallarını uygulayarak ekosistemdeki uygulamaların optimizasyonunun engellenmemesini sağlayabilir.
Kitaplıklar daha iyi kurallar sunduğunda uygulamalar daha küçük ve daha hızlı hale gelir. Kitaplığınıza bağlı uygulamaların en iyi performansı göstermesine yardımcı olmak için tüketici saklama kurallarınızı denetlemeye hemen başlayın.
-
"Nasıl yapılır?" rehberleriProfil Destekli Optimizasyon, Jetpack Compose performans iyileştirmeleri ve kamera arkasında çalışmayla ilgili dikkat edilmesi gereken noktaları ele alıyoruz.
Ben Weiss, Breana Tate, Jossi Wolf • Okuma süresi: 8 dk. -
"Nasıl yapılır?" rehberleriTemel bir Android uygulamasını kişiselleştirilmiş, akıllı ve temsilci tabanlı bir deneyime dönüştürdüğünüz "Akıllı Android uygulamaları geliştirme" blog yayını serisine tekrar hoş geldiniz. Önceki yayınımızda, AppFunctions'ı kullanarak akıllı sisteme nasıl bağlanacağınızı öğrenmiştiniz.
Jolanda Verhoef • Okuma süresi: 9 dk. -
"Nasıl yapılır?" rehberleriMedia3 1.11 kullanıma sunuldu. En popüler Android medya uygulamalarının büyük çoğunluğunu destekleyen bu sürüm; oynatma, düzenleme ve kullanıcı arayüzü bileşenlerinde yeni özellikler, hata düzeltmeleri ve iyileştirmeler sunuyor.
Toni Heidenreich • Okuma süresi: 3 dk.
Android geliştiriciliğiyle ilgili en son analizleri haftalık olarak gelen kutunuza alın.