AAPT2

AAPT2 (Android Asset Packaging Tool), Android Studio ve Android Gradle eklentisinin uygulamanızın kaynaklarını derlemek ve paketlemek için kullandığı bir derleme aracıdır. AAPT2, kaynakları ayrıştırır, dizine ekler ve Android platformu için optimize edilmiş bir ikili biçimde derler.

Android Gradle eklentisinin 3.0.0 ve sonraki sürümlerinde AAPT2 varsayılan olarak etkindir. Genellikle aapt2 öğesini kendiniz çağırmanız gerekmez. Ancak Android Studio yerine terminalinizi ve kendi derleme sisteminizi kullanmayı tercih ederseniz komut satırından AAPT2'yi kullanabilirsiniz. Ayrıca, AAPT2 ile ilgili derleme hatalarında komut satırından hata ayıklayabilirsiniz. Bunu yapmak için Android SDK Derleme Araçları 26.0.2 ve sonraki sürümlerinde AAPT2'yi bağımsız bir araç olarak bulun.

Android SDK Build Tools'u komut satırından indirmek için sdkmanager'u kullanın ve aşağıdaki komutu çalıştırın:

sdkmanager "build-tools;build-tools-version"

SDK Derleme Araçları'nı indirdikten sonra AAPT2'yi android_sdk/build-tools/version/ konumunda bulun.

Android SDK Build Tools'un düzeltilmiş sürümleri sık yayınlanmadığından SDK Build Tools'unuzda bulunan AAPT2 sürümü en son sürüm olmayabilir. AAPT2'nin en yeni sürümünü edinmek için Google Maven'den AAPT2'yi indirin.

Linux veya Mac'te AAPT2'yi komut satırından kullanmak için aapt2 komutunu çalıştırın. Windows'da aapt2.exe komutunu çalıştırın.

AAPT2, artımlı derlemeyi etkinleştirerek kaynakların daha hızlı derlenmesini destekler. Artımlı derleme için kaynak işleme iki adıma ayrılır:

• Derle: Kaynak dosyalarını ikili biçimlerde derler.
• Bağlantı: Derlenen tüm dosyaları birleştirir ve tek bir pakette toplar.

Bu ayrım, artımlı derlemelerin performansını artırmaya yardımcı olur. Örneğin, tek bir dosyada değişiklik varsa yalnızca o dosyayı yeniden derlemeniz gerekir.

AAPT2'yi Google Maven'den indirme

Derleme araçlarına dahil edilmeyen en yeni AAPT2 sürümünü edinmek için AAPT2'yi Google'ın Maven deposundan aşağıdaki şekilde indirin:

1. Depo dizininde com.android.tools.build > aapt2'ye gidin.
2. AAPT2'nin en son sürümünün adını kopyalayın.

3. Kopyaladığınız sürüm adını aşağıdaki URL'ye ekleyin ve hedef işletim sisteminizi belirtin: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar

   Örneğin, Windows için 3.2.0-alpha18-4804415 sürümünü indirmek üzere şu bağlantıyı kullanın: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ 3.2.0-alpha18-4804415/aapt2-3.2.0-alpha18-4804415-windows.jar

4. URL'ye bir tarayıcıda gidin. AAPT2 kısa süre içinde indirilmeye başlayacak.

5. Yeni indirdiğiniz JAR dosyasını açın.

   JAR dosyası, aapt2 yürütülebilir dosyası ve yürütülebilir dosyanın bağlı olduğu bazı kitaplıkları içermelidir.

Derleme

AAPT2, çizilebilir öğeler ve XML dosyaları gibi tüm Android kaynak türlerinin derlenmesini destekler. Derleme için AAPT2'yi çağırdığınızda, her çağırma işleminde tek bir kaynak dosyayı giriş olarak iletin. AAPT2 daha sonra dosyayı ayrıştırır ve .flat uzantılı bir ara ikili dosya oluşturur.

AAPT2, dizinlerin tamamı iletilirken yalnızca bir kaynak değişmiş olsa bile dizindeki tüm dosyaları yeniden derler. --dir işaretini kullanarak birden fazla kaynak dosyası içeren kaynak dizinlerini AAPT2'ye iletebilseniz de bu şekilde artımlı kaynak derlemesinin avantajlarından yararlanamazsınız.

Çıkış dosyası türleri, derleme için sağladığınız girişe göre farklılık gösterebilir. Bu durum aşağıdaki tabloda gösterilmiştir:

Tablo 1. Derleme için giriş ve çıkış dosyası türleri

AAPT2'nin çıkardığı dosyalar yürütülebilir dosyalar değildir ve APK oluşturmak için bu ikili dosyaları daha sonra bağlantı aşamasında giriş olarak eklemeniz gerekir. Ancak, oluşturulan APK dosyası DEX dosyaları içermediği ve imzalanmadığı için hemen bir Android cihaza dağıtabileceğiniz bir yürütülebilir dosya değildir.

Söz dizimini derleme

compile kullanımıyla ilgili genel söz dizimi aşağıdaki gibidir:

aapt2 compile path-to-input-files [options] -o output-directory/

Aşağıdaki örnekte AAPT2, values.xml ve myImage.png adlı kaynak dosyalarını ayrı ayrı derler:

aapt2 compile project_root/module_root/src/main/res/values-en/strings.xml -o compiled/
aapt2 compile project_root/module_root/src/main/res/drawable/myImage.png -o compiled/

Tablo 1'de gösterildiği gibi, çıkış dosyasının adı giriş dosyasının adına ve üst dizininin adına bağlıdır.

Giriş olarak strings.xml dosyasının kullanıldığı önceki örnekte, aapt2 çıkış dosyasını otomatik olarak values-en_strings.arsc.flat şeklinde adlandırır. Ancak, drawable dizininde depolanan derlenmiş drawable dosyası drawable_img.png.flat olarak adlandırılır.

Derleme seçenekleri

Tablo 2'de gösterildiği gibi, compile komutuyla kullanabileceğiniz çeşitli seçenekler vardır:

Tablo 2. Derleme komutu seçenekleri

Bağlantı

Bağlantı aşamasında AAPT2, derleme aşamasının oluşturduğu tüm ara dosyaları (ör. kaynak tabloları, ikili XML dosyaları ve işlenmiş PNG dosyaları) birleştirir ve ardından dosyaları tek bir APK'da paketler. Ayrıca bu aşamada R.java ve ProGuard kuralları dosyaları gibi diğer yardımcı dosyalar da oluşturulabilir. Ancak oluşturulan APK, DEX bayt kodu içermiyor ve imzalanmamış. Bu APK'yı bir cihaza dağıtamazsınız.

Uygulamanızı komut satırından oluşturmak için Android Gradle eklentisini kullanmıyorsanız Java bayt kodunu DEX bayt koduna derlemek için d8 ve APK'nızı imzalamak için apksigner gibi diğer komut satırı araçlarını kullanabilirsiniz.

Bağlantı söz dizimi

link kullanımıyla ilgili genel söz dizimi aşağıdaki gibidir:

aapt2 link path-to-input-files [options] -o
outputdirectory/outputfilename.apk --manifest AndroidManifest.xml

Aşağıdaki örnekte AAPT2, iki ara dosyayı (drawable_Image.flat ve values_values.arsc.flat) ve AndroidManifest.xml dosyasını birleştirir. AAPT2, sonucu android.jar dosyasına bağlar. Bu dosya, android paketinde tanımlanan kaynakları içerir:

 aapt2 link -o output.apk
 -I android_sdk/platforms/android_version/android.jar
    compiled/res/values_values.arsc.flat
    compiled/res/drawable_Image.flat --manifest /path/to/AndroidManifest.xml -v

Bağlantı seçenekleri

link komutuyla aşağıdaki seçenekleri kullanabilirsiniz:

Tablo 3. Bağlantı komutu seçenekleri

Döküm

dump, link komutunu kullanarak oluşturduğunuz APK hakkında bilgi yazdırmak için kullanılır.

Döküm söz dizimi

dump kullanımıyla ilgili genel söz dizimi aşağıdaki gibidir:

aapt2 dump sub-command filename.apk [options]

Aşağıdaki örnek, belirtilen APK'nın kaynak tablosundaki içeriği yazdırır:

aapt2 dump resources output.apk

Dump alt komutları

dump komutuyla aşağıdaki alt komutlardan birini belirtin:

Tablo 4. Dump alt komutları

Döküm seçenekleri

dump ile birlikte aşağıdaki seçenekleri kullanın:

Tablo 5. Döküm seçenekleri

Fark

İki APK'yı karşılaştırmak ve aralarındaki farkları belirlemek için diff simgesini kullanın.

Fark söz dizimi

diff kullanımıyla ilgili genel söz dizimi aşağıdaki gibidir:

aapt2 diff first.apk second.apk

diff komutu için seçenek yoktur.

Optimizasyon yapın

optimize, birleştirilmiş kaynaklarda optimizasyon çalıştırmak ve resources.arsc için kullanılır. Bu optimizasyon, kullanılan kaynakların boyutuna ve sayısına bağlı olarak APK boyutunu yaklaşık %1-3 oranında küçültebilir.

Söz dizimini optimize etme

optimize kullanımıyla ilgili genel söz dizimi aşağıdaki gibidir:

aapt2 optimize options file[,file[..]]

Aşağıdaki örnekte, input.apk içindeki kaynaklar optimize edilir ve output.apk içinde yeni, optimize edilmiş bir APK oluşturulur. Bu özellik, normal düz tablo gösteriminin yerini daha kompakt bir gösterimle alır. Bu sayede APK boyutu, bellek kullanımı ve başlatma gecikmesi azalır. Başlatma işleminden sonra kaynak arama süresinde ise küçük bir artış olur.

aapt2 optimize -o output.apk --enable-sparse-encoding input.apk

Optimizasyon seçenekleri

optimize ile aşağıdaki seçenekleri kullanabilirsiniz:

Tablo 6. Optimizasyon seçenekleri

Dönüştürme

Varsayılan olarak AAPT compile komutu, kaynakları APK'lar için uygun olan ikili biçimde derler. --proto-format belirterek AAB'ler için uygun olan protobuf biçimini de belirtebilirsiniz. convert komutu, APK'ları iki biçim arasında dönüştürür.

Söz dizimini dönüştürme

convert için genel söz dizimi aşağıdaki gibidir:

aapt2 convert -o output-file options file[,file[..]]

Aşağıdaki örnek, input.apk içindeki kaynakları dönüştürür ve output.apk içinde protobuf biçimli kaynakları içeren yeni bir APK oluşturur. Normal düz tablo gösteriminin yerini daha kompakt bir gösterim alarak APK boyutunda, bellek kullanımında ve başlatma gecikmesinde azalmaya, ayrıca küçük bir artışa neden olur.

aapt2 convert -o output.apk --output-format proto --enable-sparse-encoding input.apk

Dönüştürme Seçenekleri

convert ile birlikte aşağıdaki seçenekleri kullanın:

Tablo 7. Dönüştürme seçenekleri

Arka plan programı modu

AAPT 2.19 sürümünde komut verme için daemon modu kullanıma sunuldu. Arka plan programı modu, tek bir AAPT oturumunda birden fazla komut girmenize olanak tanır.

Arka plan programı söz dizimi

Aşağıdaki komutla arka plan programı modunu başlatın:

aapt2 daemon

Daemon modu çalıştıktan sonra komut girebilirsiniz. Komutun her bağımsız değişkeni ayrı bir satırda olmalı ve komutun sonunda boş bir satır bulunmalıdır. Control+D yazarak daemon modundan çıkın.

Aşağıdaki bağımsız compile komutlarını göz önünde bulundurun:

aapt2 compile project_root/module_root/src/main/res/values-en/strings.xml -o compiled/
aapt2 compile project_root/module_root/src/main/res/drawable/myImage.png -o compiled/

Bu komutlar, arka plan programı modunda şu şekilde girilebilir:

aapt2 daemon
Ready
compile
project_root/module_root/src/main/res/values-en/strings.xml
-o
compiled/

Done
compile
project_root/module_root/src/main/res/drawable/myImage.png
-o
compiled/

Done
^D
Exiting daemon

Arka plan programı modu seçenekleri

Daemon modu için tek seçenek --trace-folder folder'dir. Bu seçenek, belirtilen folder için systrace JSON izleme parçası oluşturur.

Sürüm

version komutunu kullanarak kullandığınız AAPT2 sürümünü belirleyin:

aapt2 version
Android Asset Packaging Tool (aapt) 2.19-8678579

AAPT2 kullanılırken davranış değişiklikleri

AAPT2'den önce AAPT, Android Asset Packaging Tool'un varsayılan sürümüydü ve artık desteği sonlandırıldı. AAPT2 eski projelerle hemen çalışsa da bu bölümde, bilmeniz gereken bazı davranış değişiklikleri açıklanmaktadır.

Android manifest dosyasındaki öğe hiyerarşileri

AAPT'nin önceki sürümlerinde, AndroidManifest.xml dosyasındaki yanlış düğümlere yerleştirilmiş öğeler yoksayılıyordu veya uyarıya neden oluyordu. Örneğin, aşağıdaki örneği inceleyin:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.myname.myapplication">
   <application
       ...
       <activity android:name=".MainActivity">
           <intent-filter>
               <action android:name="android.intent.action.MAIN" />
               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
           <action android:name="android.intent.action.CUSTOM" />
       </activity>
   </application>
</manifest>

AAPT'nin önceki sürümleri, yanlış yerleştirilmiş <action> etiketini yok sayıyordu.

AAPT2 ile şu hatayı alırsınız:

AndroidManifest.xml:15: error: unknown element <action> found.

Sorunu çözmek için bildirim öğelerinizin doğru şekilde iç içe yerleştirildiğinden emin olun. Daha fazla bilgi için Uygulama manifestine genel bakış başlıklı makaleyi inceleyin.

Kaynak beyanı

Artık name özelliğinden kaynak türünü belirtemezsiniz. Aşağıdaki örnekte, attr kaynak öğesi yanlış şekilde bildirilmektedir:

<style name="childStyle" parent="parentStyle">
    <item name="attr/my_attr">@color/pink</item>
</style>

Bir kaynak türünü bu şekilde bildirmek aşağıdaki derleme hatasına neden olur:

Error: style attribute 'attr/attr/my_attr (aka my.package:attr/attr/my_attr)'
not found.

Bu hatayı çözmek için type="attr" kullanarak türü açıkça bildirin:

<style name="childStyle" parent="parentStyle">
  <item type="attr" name="my_attr">@color/pink</item>
</style>

Ayrıca, bir <style> öğesi bildirilirken üst öğesi de bir stil kaynak türü olmalıdır. Aksi takdirde, aşağıdakine benzer bir hata alırsınız:

Error: (...) invalid resource type 'attr' for parent of style

@ kaynak referansı simgelerinin yanlış kullanımı

AAPT2, kaynak referans simgelerini (@) atladığınızda veya yanlış yerleştirdiğinizde derleme hataları verir. Örneğin, bir stil özelliğini belirtirken simgeyi atlarsanız:

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
  ...
  <!-- Note the missing '@' symbol when specifying the resource type. -->
  <item name="colorPrimary">color/colorPrimary</item>
</style>

Modül oluşturulurken AAPT2 aşağıdaki derleme hatasını veriyor:

ERROR: expected color but got (raw string) color/colorPrimary

Ayrıca, android ad alanındaki bir kaynağa erişirken simgeyi yanlışlıkla eklerseniz:

...
<!-- When referencing resources from the 'android' namespace, omit the '@' symbol. -->
<item name="@android:windowEnterAnimation"/>

Modül oluşturulurken AAPT2 aşağıdaki derleme hatasını veriyor:

Error: style attribute '@android:attr/windowEnterAnimation' not found

Kitaplıkların yanlış yapılandırılması

Uygulamanız, Android SDK Build Tools'un eski sürümleri kullanılarak oluşturulmuş bir üçüncü taraf kitaplığına bağımlıysa uygulamanız, çalışma zamanında herhangi bir hata veya uyarı göstermeden kilitlenebilir. Bu kilitlenme, kitaplık oluşturulurken R.java alanları final olarak tanımlandığı için meydana gelebilir. Sonuç olarak, tüm kaynak kimlikleri kitaplığın sınıflarına yerleştirilir.

AAPT2, uygulamanızı oluştururken kitaplık kaynaklarına kimlikleri yeniden atayabilmeye dayanır. Kitaplık, kimliklerin final olduğunu varsayıp bunları kitaplık DEX'ine yerleştirirse çalışma zamanında eşleşme olmaz.

Bu hatayı gidermek için kitaplığı Android SDK Build Tools'un en son sürümüyle yeniden oluşturması ve yeniden yayınlaması için kitaplığın yazarıyla iletişime geçin.