AAPT2

AAPT2 (Android Öğe Paketleme Aracı), Android Studio ve Android Gradle Eklentisi, uygulamanızın kaynaklar. AAPT2; Search Ads 360'taki kaynaklar için optimize edilmiş ikili bir biçimde derler ve Android platformu.

Android Gradle Eklentisi 3.0.0 ve sonraki sürümler AAPT2'yi varsayılan olarak etkinleştirir. Siz genellikle aapt2 öğesini kendiniz çağırmanız gerekmez. Ancak isterseniz terminalinizi ve kendi derleme sisteminizi kullanıyorsanız, AAPT2 yazın. AAPT2 ile ilgili derleme hatalarını da ayıklayabilirsiniz komutunu çalıştırın. Bunun için, Android SDK Derleme Araçları 26.0.2 ve sonraki sürümler.

Android SDK Build Tools'u komut satırından indirmek için şunu kullanın: sdkmanager adresine gidin 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/

Android SDK Derleme Araçları'nın düzeltmeleri yayınlanmadığı için genellikle SDK Derleme Araçlarınızda yer alan AAPT2 sürümü en son AAPT2'nin son sürümünü edinmek için Google Maven'den AAPT2 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, artan verimlilik sayesinde kaynakların daha hızlı derlenmesini destekler derlememiz var. Artımlı derleme yapmak 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 dosyada paketler paketinden yararlanın.

Bu ayırma, artımlı derlemelerin performansını iyileştirmeye yardımcı olur. Örneğin, tek bir dosyada değişiklikler varsa yalnızca o dosyayı yeniden derlemeniz gerekir.

Google Maven'den AAPT2 indir

AAPT2'nin derleme araçlarında bulunmayan en yeni sürümünü edinmek için AAPT2'yi Google'ın Maven deposundan aşağıdaki şekilde indirin:

1. Depo dizininde şu konuma gidin: adresine com.android.tools.build > aapt2 olarak değiştirin.
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 sistemi: 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 şunu kullanın: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ 3.2.0-alpha18-4804415/aapt2-3.2.0-alpha18-4804415pencereler.jar

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

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

   JAR dosyası bir aapt2 yürütülebilir dosyası ve biraz da yürütülebilir.

Derle

AAPT2 tüm videoların derlenmesini destekler Örneğin, Android kaynak türleri çekilebilir ve XML dosyası oluşturabilir. Derleme için AAPT2'yi çağırdığınızda tek bir kaynak dosyası yükleyebilirsiniz. AAPT2, daha sonra dosyayı ayrıştırarak ve .flat uzantılı bir ara ikili dosya oluşturur.

AAPT2, dizinlerin tamamını iletirken dizindeki tüm dosyaları yeniden derler. tek bir kaynak değişse bile. Her ne kadar birden fazla kaynak dosyası içeren dizinleri --dir kullanarak AAPT2'ye bu şekilde artımlı kaynak derlemenin avantajlarından yararlanamazsınız.

Çıkış dosyası türleri, derleme için sağladığınız girişe bağlı olarak farklılık gösterebilir. aşağıdaki tabloda gösterildiği gibi):

Tablo 1. Giriş ve çıkış dosyası derleme türleri

AAPT2 çıkışları yürütülebilir dosyalar değildir ve daha sonra şunları eklemeniz gerekir: ikili program dosyalarını bağlantı aşamasında girdi olarak kullanır. Ancak oluşturulan APK dosyası, Android cihazlara dağıtabileceğiniz yürütülebilir bir dosya değil hemen kullanabilirsiniz, çünkü DEX dosyaları içermez ve imzalanmadı.

Söz dizimini derle

compile kullanımına ilişkin 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 Tek tek myImage.png:

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/

1. tabloda gösterildiği gibi, çıkış dosyasının adı girişe bağlıdır dosya adı ve üst dizininin adı.

Giriş olarak strings.xml dosyasının kullanıldığı önceki örnek için aapt2 otomatik olarak çıkış dosyasını values-en_strings.arsc.flat olarak adlandırır. Ancak derlenen çekilebilir dizinde saklanan çekilebilir dosyanın adı drawable_img.png.flat'dir.

Derleme seçenekleri

Aşağıda gösterildiği gibi, compile komutuyla kullanabileceğiniz birkaç seçenek bulunmaktadır. (tablo 2'de):

Tablo 2. Komut seçeneklerini derle

Bağlantı

Bağlantı aşamasında, AAPT2 derlemenin oluşturduğunuz tüm ara dosyaları aşamasında (kaynak tablolar, ikili XML dosyaları ve işlenmiş PNG gibi) ve ardından dosyaları tek bir APK halinde paketler. Ayrıca, R.java ve ProGuard kural dosyaları gibi yardımcı dosyalar oluşturulabilir destekleyici materyalleri inceleyeceksiniz. Ancak oluşturulan APK DEX bayt kodunu içermiyor ve imzasız. Bu APK'yı bir cihaza dağıtamazsınız.

Şu işlemler için Android Gradle eklentisini kullanmıyorsanız: uygulamanızı komut satırından derlerseniz, derlemek için d8 gibi diğer komut satırı araçlarını kullanın Java bayt kodunu DEX bayt koduna ve apksigner’a dönüştürme kullanın.

Bağlantı söz dizimi

link kullanımına ilişkin 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ı birleştirir: drawable_Image.flat ve values_values.arsc.flat ve AndroidManifest.xml dosyası. AAPT2, sonucu android.jar ile bağlar dosyasını içeren bir dosyayı yükleyin:android

 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 komutudur.

Döküm söz dizimi

dump kullanımına ilişkin genel söz dizimi aşağıdaki gibidir:

aapt2 dump sub-command filename.apk [options]

Aşağıdaki örnekte, APK:

aapt2 dump resources output.apk

Alt komutların dökümünü al

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

Tablo 4. Alt komutların dökümünü al

Döküm seçenekleri

dump ile 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 uygulamasını kullanın.

Fark söz dizimi

diff kullanımına ilişkin 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 optimizasyonları çalıştırmak için kullanılır ve resources.arsc APK'ya paketlenmeden önce. Bu optimizasyon boyutu ve sayısına bağlı olarak APK boyutunu yaklaşık %1-3 oranında azaltabilir. için iyi bir fırsattır.

Söz dizimini optimize et

optimize kullanımına ilişkin genel söz dizimi aşağıdaki gibidir:

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

Aşağıdaki örnek, input.apk kaynağındaki kaynakları optimize eder ve yeni bir, output.apk içinde optimize edilmiş APK. Normal düz tablo temsilinin yerini alır daha küçük bir ikili arama ağacı sunar. Böylece alma performansı maliyeti:

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

İzleyicileri üyelere dönüştürün

AAPT compile komutu, varsayılan olarak kaynakları ikili biçimde derler bir uygulamadır. Protobuf biçimi de belirtilebilir --proto-format belirterek AAB'lere uygun olan bir metin girin. convert komutu, iki biçim arasında APK'ları dönüştürür.

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

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 kaynağındaki kaynakları dönüştürür ve yeni bir, output.apk sürümündeki APK, protobuf biçimindeki kaynaklar içeriyor. Her zamankinin yerini alıyor daha küçük boyutlu bir ikili arama ağacıyla düz tablo gösterimi alma performansı pahasına daha küçük bir APK'da kullanılır:

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

Dönüştürme Seçenekleri

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

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

Arka plan programı modu

AAPT sürüm 2.19'da, komut vermek için arka plan programı modu kullanıma sunulmuştur. Arka plan programı modu, tek bir AAPT oturumunda birden fazla komut girersiniz.

Arka plan programı söz dizimi

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

aapt2 daemon

Arka plan programı modu çalışmaya başladıktan sonra komut girebilirsiniz. komutu, ayrı bir satırda olmalı ve komutun sonunda boş bir satır içermelidir. Control+D tuşlarına basarak arka plan programı modundan çıkın.

Aşağıdaki compile komutlarını ayrı ayrı kullanabilirsiniz:

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

Arka plan programı modu için tek seçenek systrace JSON oluşturan --trace-folder folder iz parçası, belirtilen folder ile aynı olmalıdır.

Sürüm

version komutuyla 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şir

AAPT2'den önce Android Öğe Paketleme Aracı'nın varsayılan sürümü AAPT idi. Bu özellik artık kullanımdan kaldırıldı. AAPT2 her ne kadar bu bölümde, yapmanız gereken bazı davranış değişiklikleri bilgi sahibidir.

Android manifestindeki öğe hiyerarşileri

AAPT'nin önceki sürümlerinde, AndroidManifest.xml dosya yoksayıldı veya uyarı aldı. Örneğin, aşağıdaki örneği ele alalım:

<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 yoksayar.

AAPT2 ile aşağıdaki hatayı alırsınız:

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

Sorunu çözmek için manifest öğelerinizin doğru şekilde iç içe yerleştirilmiş olduğundan emin olun. Daha fazla bilgi için Uygulama manifestine genel bakış.

Kaynak beyanı

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

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

Bu şekilde bir kaynak türünün tanımlanması, aşağıdaki derleme hatasıyla sonuçlanır:

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

Bu hatayı düzeltmek 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 belirtilirken üst öğesi de bir olmalıdır. stil kaynak tü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ı

Kaynağı atladığınızda veya yanlış yerleştirdiğinizde AAPT2 yapı hataları bildirir referans sembolleri (@). Örneğin, bir stil özelliği belirterek:

<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ştururken AAPT2 aşağıdaki derleme hatasını verir:

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

Ayrıca, bir android ad alanındaki kaynak:

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

Modülü oluştururken AAPT2 aşağıdaki derleme hatasını verir:

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

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

Uygulamanızın, eski dosya adıyla oluşturulmuş üçüncü taraf kitaplığına bağımlılığı varsa Android SDK Derleme Araçları'nın diğer sürümlerini kullanıyorsanız, uygulama çalışma zamanında herhangi bir hata veya uyarı görüntülemeden kilitlenebilir. Bu kilitlenme kitaplığın oluşturulması sırasında R.java alanlarının şunu açıkladı: final. Sonuç olarak, tüm kaynak kimlikleri derslere katılmıştım.

AAPT2, oluşturma sırasında kimlikleri kitaplık kaynaklarına yeniden atayabilmeye dayanır en iyi şekilde yararlanabilirsiniz. Kitaplık, kimliklerin final olduğunu varsayar ve bunları bir çalışma zamanı uyuşmazlığı vardır.

Bu hatayı gidermek için kitaplığın yazarıyla iletişime geçerek kitaplığı yeniden oluşturun sürümünü kullanarak Android SDK Derleme Araçları'nın en son sürümünü kullanmalı ve kitaplığını açar.