Android Studio, derleme işlemi tamamlandıktan sonra APK'nızın veya Android App Bundle'ınızın yapısı hakkında anında bilgi sağlayan bir APK Analiz Aracı içerir.
APK Analiz Aracı'nı kullanmak, uygulamanızdaki DEX dosyaları ve kaynaklarıyla ilgili hataları ayıklamaya harcadığınız süreyi kısaltabilir ve APK boyutunu küçültmenize yardımcı olabilir. APK Analiz Aracı, apkanalyzer
ile komut satırından da kullanılabilir.
APK Analiz Aracı ile şunları yapabilirsiniz:
- Uygulamadaki DEX ve Android kaynak dosyaları gibi dosyaların mutlak ve göreli boyutunu görüntüleyin.
- DEX dosyalarının bileşimini anlama.
- Uygulamada,
AndroidManifest.xml
dosyası gibi dosyaların son sürümlerini hızlıca görüntüleyebilirsiniz. - İki APK veya uygulama paketinin yan yana karşılaştırmasını yapabilir.
Bir proje açıkken APK Analiz Aracı'na erişmenin üç yolu vardır:
- Bir APK'yı veya uygulama paketini Android Studio'nun Düzenleyici penceresine sürükleyin.
- Proje penceresinde Proje görünümüne geçin ve varsayılan
build/output/apks/
dizininde APK'yı çift tıklayın. - Menü çubuğunda Oluştur > APK'yı analiz et'i ve ardından APK'nızı veya uygulama paketinizi seçin.
Dosya ve boyut bilgilerini görüntüleme
APK'lar, ZIP dosya biçimine uyan dosyalardır. APK Analiz Aracı, her bir dosyayı veya klasörü, klasörlerde gezinmek için genişletebileceğiniz bir varlık olarak görüntüler. Varlıkların hiyerarşisi, APK dosyasındaki dosyaların ve klasörlerin yapısını yansıtır.
APK Analiz Aracı, şekil 1'de gösterildiği gibi her bir varlık için sıkıştırılmış dosya boyutunu (veya "ham dosya boyutu") ve indirme dosya boyutu değerlerini gösterir. İşlenmemiş Dosya Boyutu, varlığın toplam APK boyutuna katkısını gösterir. İndirme Boyutu, varlığın Google Play tarafından yayınlanacak olan tahmini sıkıştırılmış boyutunu temsil eder. Toplam İndirme Boyutunun Yüzdesi, varlığın temsil ettiği APK'nın toplam indirme boyutunun yüzdesini gösterir.
![](https://developer.android.com/static/studio/images/build/apk-file-sizes_2x.png?authuser=5&hl=tr)
AndroidManifest.xml dosyasını görüntüleyin
Projeniz, ürün çeşitleri gibi birden fazla AndroidManifest.xml
dosyası veya manifest dosyası sağlayan kitaplıklar içeriyorsa bu dosyalar uygulamanızda tek bir dosya halinde birleştirilir. Bu manifest dosyası, normalde APK veya uygulama paketi içinde bulunan bir ikili program dosyasıdır, ancak APK Analiz Aracı'nda seçildiğinde bu varlığın XML biçimi yeniden oluşturulur ve sunulur.
Bu görüntüleyici, derleme sırasında uygulamanızda yapılmış olabilecek
değişiklikleri anlamanıza yardımcı olur. Örneğin, uygulamanızın kullandığı bir kitaplıktaki AndroidManifest.xml
dosyasının nihai AndroidManifest.xml
dosyasıyla nasıl birleştirildiğini görebilirsiniz.
Ayrıca bu görüntüleyici bazı hata analizi özellikleri sunar. Uyarılar veya hatalar sağ üst köşede görünür. Şekil 2'de seçilen manifest dosyası için bildirilen bir hata gösterilmektedir.
![](https://developer.android.com/static/studio/images/build/apk-manifest-error_2x.png?authuser=5&hl=tr)
DEX dosyalarını görüntüle
APK Analiz Aracı'nın DEX dosyası görüntüleyicisi, uygulamanızdaki DEX dosyalarında bulunan temel bilgilere anında erişmenizi sağlar. Görüntüleyen, sınıf, paket, toplam referans ve bildirim sayılarını sağlar. Bunlar, multidex'i kullanıp kullanmayacağınıza veya 64.000 DEX sınırının altına inmek için bağımlılıkları nasıl kaldıracağınıza karar vermenize yardımcı olabilir.
Şekil 3'te 64K DEX sınırının altında olan orta boyutlu bir uygulama gösterilmektedir. DEX dosyasındaki her paket, sınıf ve yöntemin sayıları, Tanımlanan Yöntemler ve Referanslanan Yöntemler sütunlarında listelenir.
Referanslanan Yöntemler sütunu, DEX dosyasının başvuruda bulunduğu tüm yöntemleri sayar. Bu genellikle kodunuzda tanımlanan yöntemleri, bağımlılık kitaplıklarını ve kodun kullandığı standart Java ve Android paketlerinde tanımlanan yöntemleri içerir. Bunlar, her DEX dosyasında 64.000 yöntem sınırı için sayılan yöntemlerdir.
Tanımlanan Yöntemler sütunu yalnızca DEX dosyalarınızın birinde tanımlanan yöntemleri sayar. Bu nedenle bu sayı, Referans Verilen Yöntemler'in bir alt kümesidir.
![](https://developer.android.com/static/studio/images/build/apk-over-64k-limit_2x.png?authuser=5&hl=tr)
DEX dosya ağaç görünümünü filtreleme
Sınıf listesinin hemen üstünde, APK Analiz Aracı, Şekil 4'te gösterildiği gibi, seçilen DEX dosyasının içeriğini görüntülemek için filtreler sağlar.
![](https://developer.android.com/static/studio/images/build/apk-filter-tree-view_2x.png?authuser=5&hl=tr)
BuildConfig
için alanları ve yöntemleri görüntüleyecek şekilde ayarlandı.Bir sınıftaki tüm yöntemleri ve alanları görüntülemek üzere filtreleri kullanmak için aşağıdakileri yapın:
- Dosya listesinden
classes.dex
dosyasını seçin. - Sınıf listesinde, bir sınıfa gidin ve seçin.
- Seçtiğiniz sınıfı genişletin.
- Sınıf alanlarını göstermek veya gizlemek için Alanları göster
ayarını açık duruma getirin.
- Sınıf yöntemlerini göstermek veya gizlemek için Yöntemleri göster
özelliğini açın.
Başvurulan paketleri, sınıfları, yöntemleri ve alanları göstermek veya gizlemek için Başvurulan tüm yöntemleri veya alanları göster
ayarını açık duruma getirin.
Ağaç görünümünde, italik düğümler seçilen DEX dosyasında bir tanımı olmayan referanslardır. DEX dosyası, farklı bir dosyada tanımlanan yöntemlere ve alanlara referans verebilir. Örneğin
System.out.println()
, Android çerçevesindekiprintln()
yöntemine referanstır.
ProGuard eşlemelerini yükleme
Filtreleme simgelerinin yanında ProGuard eşleme simgeleri bulunur. Adların gizlemesini kaldırma (mapping.txt
), kaldırılan düğümleri gösterme (usage.txt
) ve kaldırılamayan düğümleri belirtme (seeds.txt
) gibi işlevler sağlayan bir dizi ProGuard eşleme dosyası yüklenene kadar ProGuard simgeleri devre dışı kalır.
İçe aktardığınız ProGuard eşleme dosyası, kod küçültme özelliği etkin halde DEX dosyalarını oluşturan aynı derlemeden oluşmalıdır.
![](https://developer.android.com/static/studio/images/build/apk-proguard-mappings_2x.png?authuser=5&hl=tr)
ProGuard eşleme dosyalarını yüklemek için aşağıdakileri yapın:
- ProGuard eşlemelerini yükle... seçeneğini tıklayın.
Eşleme dosyalarını içeren proje klasörüne gidin ve tüm dosyaları, tüm dosya kombinasyonlarını veya dosyaları içeren klasörü yükleyin.
Eşleme dosyaları normalde
project/app/build/outputs/mappings/release/
konumundadır. Dosya seçici, bu proje yapısını algılarsa varsayılan olarak release klasörünü ayarlar.Dosya seçici öncelikle
mapping.txt
,seeds.txt
veusage.txt
ile tam olarak eşleşen dosya adlarını kontrol eder. Ardından, dosya seçici başka bir yerdemapping
,usage
veyaseeds
metnini içeren ve.txt
ile biten dosya adlarını kontrol eder. Örneğin,release-seeds-1.10.15.txt
bir eşleşmedir.
Aşağıdaki listede eşleme dosyaları açıklanmaktadır:
seeds.txt
: ProGuard yapılandırmasının daraltma sırasında kaldırılmasını engellediği düğümler kalın karakterlerle gösterilmiştir.mapping.txt
: R8 tarafından kodu karartılan düğümlerin orijinal adlarını geri yükleyebilmeniz için Adların gizlemesini kaldırözelliğini etkinleştirir. Örneğin,
a
,b
,c
gibi karartılmış düğüm adlarınıMyClass
,MainActivity
vemyMethod()
biçimine geri yükleyebilirsiniz.usage.txt
: Daraltma sırasında R8 tarafından kaldırılan sınıfları, yöntemleri ve alanları gösterebilmeniz için Kaldırılan düğümleri gösterseçeneğini etkinleştirir. Geri yüklenen düğümler üstü çizili olarak gösterilir.
Kodunuzu karartmak ve en aza indirmek amacıyla R8'i kullanma hakkında daha fazla bilgi için Uygulamanızı küçültme, gizleme ve optimize etme bölümüne bakın.
Bayt kodunu gösterme, kullanımları bulma ve Keep kuralı oluşturma
Sınıf liste görünümündeki düğümlerde bayt kodunu görmenize, kullanımları bulmanıza ve seçili düğüm için kopyalanıp yapıştırılacak ProGuard kurallarını gösteren bir iletişim kutusu görüntülemenize olanak tanıyan aşağıdaki seçenekleri içeren bir içerik menüsü bulunur. Sınıf liste görünümünde herhangi bir düğümü sağ tıklayarak içerik menüsünü görüntüleyin.
Bayt kodunu göster: Seçilen sınıf, yöntem veya alanın derlenmesini sağlar ve küçük bayt kodu gösterimini bir iletişim kutusunda aşağıdaki gibi görüntüler:
![](https://developer.android.com/static/studio/images/build/apk-byte-code_2x.png?authuser=5&hl=tr)
init
yöntemi için DEX bayt kodu.Kullanımları bulma: Şekil 7'de gösterildiği gibi, DEX kodunun diğer hangi bölümlerinin seçili sınıfa veya yönteme referans verdiğini gösterir.
seeds.txt
yüklendiyse kalın harflerle gösterilen düğümler, ProGuard yapılandırmasının daraltma sırasında kaldırılmalarını önlediğini gösterir:
![](https://developer.android.com/static/studio/images/build/apk-references_2x.png?authuser=5&hl=tr)
MyClass
ile ilgili referanslar.
ProGuard Keep kuralı oluştur: Şekil 8'de gösterildiği gibi kopyalayıp projenizin ProGuard yapılandırma dosyasına yapıştırabileceğiniz ProGuard kurallarını gösterir. Bu, belirli bir paketin, sınıfın, yöntemin veya alanın kod daraltma aşamasında kaldırılmasını önler. Daha fazla bilgi için Hangi kodun saklanacağını özelleştirme bölümüne bakın.
![](https://developer.android.com/static/studio/images/build/apk-proguard-keep-rule_2x.png?authuser=5&hl=tr)
Kod ve kaynak varlıklarını görüntüle
Çeşitli derleme görevleri bir uygulamadaki nihai varlıkları değiştirir. Örneğin, ProGuard daraltma kuralları nihai kodunuzu değiştirebilir ve resim kaynakları, bir ürün türündeki kaynaklar tarafından geçersiz kılınabilir.
APK Analiz Aracı'nda dosyalarınızın son sürümünü görüntülemek için Şekil 9'da gösterildiği gibi metin veya resim varlığının önizlemesine tıklayın.
![](https://developer.android.com/static/studio/images/build/apk-image-preview_2x.png?authuser=5&hl=tr)
APK Analiz Aracı, çeşitli metin ve ikili dosyaları da görüntüleyebilir.
Örneğin, resources.arsc
varlık görüntüleyicisi, bir dize kaynağı için dil çevirileri gibi yapılandırmaya özgü değerleri görmenize olanak tanır. Şekil 10'da, her bir dize kaynağının çevirilerini görebilirsiniz.
![](https://developer.android.com/static/studio/images/build/apk-strings_2x.png?authuser=5&hl=tr)
Dosyaları karşılaştırma
APK Analiz Aracı, iki farklı APK veya uygulama paketi dosyasındaki varlıkların boyutunu karşılaştırabilir. Bu, uygulamanızın boyutunun önceki bir sürüme kıyasla neden arttığını anlamanız gerektiğinde faydalıdır.
Güncellenmiş bir uygulamayı yayınlamadan önce aşağıdakileri yapın:
- Yayınlamak üzere olduğunuz uygulamanın sürümünü APK Analiz Aracı'na yükleyin.
- APK Analiz Aracı'nın sağ üst köşesindeki Önceki APK ile karşılaştır...'ı tıklayın.
Seçim iletişim kutusunda kullanıcılarınıza en son yayınlanan yapıyı bulun ve Tamam'ı tıklayın.
Güncellemenin kullanıcılar üzerindeki etkisini değerlendirmenize yardımcı olmak için Şekil 11'dekine benzer bir iletişim kutusu görünür.
Şekil 11'de, belirli bir uygulamanın hata ayıklama ve sürüm derlemeleri arasındaki fark gösterilmektedir. Bu derleme türleri arasında farklı derleme seçenekleri kullanılır ve bu da temel varlıkları farklı şekilde değiştirir.
![](https://developer.android.com/static/studio/images/build/apk-compare_2x.png?authuser=5&hl=tr)