AAPT2

AAPT2 (Android Asset Packaging Tool) to narzędzie do tworzenia kompilacji, Używanie wtyczki Androida do kompilowania i pakowania resources. analiza, indeksy i indeksy AAPT2, i kompiluje zasoby do formatu binarnego zoptymalizowanego pod kątem Platforma Androida.

Wtyczka Androida do obsługi Gradle w wersji 3.0.0 lub nowszej włącza domyślnie protokół AAPT2. Ty zwykle nie trzeba wywoływać metody aapt2 samodzielnie. Jeśli jednak wolisz używać terminala i własnego systemu kompilacji, a nie Android Studio, AAPT2 z wiersza poleceń. Możesz też debugować błędy kompilacji związane z AAPT2 w wierszu poleceń. Aby to zrobić, znajdź AAPT2 jako samodzielne narzędzie w Android SDK Build Tools w wersji 26.0.2 lub nowszej.

Aby pobrać narzędzia Android SDK Build Tools z wiersza poleceń, użyj polecenia sdkmanager i uruchom to polecenie:

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

Po pobraniu SDK Build Tools znajdź narzędzie AAPT2 w android_sdk/build-tools/version/

Ponieważ wersje Android SDK Build Tools nie są publikowane często wersja AAPT2 zawarta w narzędziu SDK Build Tools może nie być najnowszego. Aby pobrać najnowszą wersję AAPT2, Pobierz pakiet AAPT2 z Google Maven.

Aby użyć dodatku AAPT2 z poziomu wiersza poleceń w systemie Linux lub na Macu, uruchom polecenie aapt2. W systemie Windows uruchom polecenie aapt2.exe.

AAPT2 umożliwia szybszą kompilację zasobów przez włączenie przyrostowego kompilację danych. Do przeprowadzenia kompilacji przyrostowej wymagane jest przetwarzanie zasobów w 2 etapach:

• Kompilowanie: kompiluje pliki zasobów do formatów binarnych.
• Link: łączy wszystkie skompilowane pliki i pakuje je w jeden plik. pakietu SDK.

Taki podział pomaga zwiększyć wydajność kompilacji przyrostowych. Przykład: Jeśli jeden plik zawiera zmiany, musisz ponownie skompilować tylko ten plik.

Pobierz plik AAPT2 z Google Maven

Aby pobrać najnowszą wersję AAPT2, której nie ma w narzędziach do kompilacji, Pobierz plik AAPT2 z repozytorium Google Maven w ten sposób:

1. W indeksie repozytorium przejdź do obszaru do com.android.tools.build > aapt2.
2. Skopiuj nazwę najnowszej wersji AAPT2.

3. Wstaw skopiowaną nazwę wersji do poniższego adresu URL i określ docelowy system operacyjny: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar

   Aby np. pobrać wersję 3.2.0-alfa18-4804415 na system Windows, użyj kodu: 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. Otwórz adres URL w przeglądarce. Pobieranie pliku AAPT2 wkrótce się rozpocznie.

5. Rozpakuj pobrany przed chwilą plik JAR.

   Plik JAR powinien zawierać plik wykonywalny aapt2 i kilka bibliotek, zależy od pliku wykonywalnego.

Kompilacja

AAPT2 obsługuje kompilację wszystkich Typy zasobów Androida: obiektów rysowalnych i plików XML. Po wywołaniu pakietu AAPT2 na potrzeby kompilacji pojedynczy plik zasobów jako dane wejściowe na wywołanie. AAPT2 analizuje plik. i generuje pośredni plik binarny z rozszerzeniem .flat.

Podczas przekazywania całych katalogów AAPT2 ponownie kompiluje wszystkie pliki w katalogu nawet jeśli zmienił się tylko jeden zasób. Mimo że można przekazać zasób katalogów zawierających więcej niż 1 plik zasobów do AAPT2 przy użyciu interfejsu --dir nie zyskuje się w ten sposób korzyści przyrostowej kompilacji zasobów.

Typy plików wyjściowych mogą się różnić w zależności od danych wejściowych podanych na potrzeby kompilacji, zgodnie z poniższą tabelą:

Tabela 1. Plik wejściowy i wyjściowy typy do kompilacji

Pliki wyjściowe AAPT2 nie są plikami wykonywalnymi i musisz później uwzględnić te pliki plików binarnych jako danych wejściowych na etapie łączenia, by wygenerować pakiet APK. Jednak wygenerowany plik APK nie jest plikiem wykonywalnym, który można wdrożyć na urządzeniu z Androidem. ponieważ nie zawiera plików DEX i jest nie podpisano.

Składnia kompilacji

Ogólna składnia elementu compile jest taka:

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

W poniższym przykładzie AAPT2 kompiluje pliki zasobów o nazwach values.xml i myImage.png pojedynczo:

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/

Jak widać w tabeli 1, nazwa pliku wyjściowego zależy od danych wejściowych nazwa pliku i nazwa jego katalogu nadrzędnego.

W poprzednim przykładzie z danymi wejściowymi pliku strings.xml: aapt2 automatycznie nadaje plikowi wyjściowemu nazwę values-en_strings.arsc.flat. Skompilowany plik plik rysowalny zapisany w katalogu z obiektem ma nazwę drawable_img.png.flat.

Opcje kompilacji

Polecenie compile udostępnia kilka opcji, jak pokazano na ilustracji w tabeli 2:

Tabela 2. Opcje polecenia kompilacji

Link

Na etapie połączenia AAPT2 scala wszystkie pliki pośrednie, które kompiluje kompilacja generowanie, takie jak tabele zasobów, binarne pliki XML i przetworzone pliki PNG a potem spakuj je do jednego pliku APK. Dodatkowo inne pliki pomocnicze, np. R.java i pliki z regułami ProGuard, można generować; podczas tej fazy. Wygenerowany plik APK nie zawiera jednak kodu bajtowego DEX ani jest bez podpisu. Nie możesz wdrożyć tego pliku APK na urządzeniu.

Jeśli nie używasz wtyczki Androida do obsługi Gradle do stworzyć aplikację z poziomu wiersza poleceń, używać innych narzędzi wiersza poleceń, np. d8, Kod bajtowy Java do kodu bajtowego DEX i tagu apksigner aby podpisać pakiet APK.

Składnia linku

Ogólna składnia elementu link jest taka:

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

W poniższym przykładzie AAPT2 scala 2 pliki pośrednie: drawable_Image.flat i values_values.arsc.flat oraz AndroidManifest.xml. Kod AAPT2 łączy wynik z parametrem android.jar który zawiera zasoby zdefiniowane w pakiecie 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

Opcje połączenia

W poleceniu link możesz używać tych opcji:

Tabela 3. Opcje poleceń dotyczących linku

Zrzuć

dump służy do drukowania informacji o pliku APK wygenerowanym za pomocą link.

Składnia zrzutu

Ogólna składnia elementu dump jest taka:

aapt2 dump sub-command filename.apk [options]

Poniższy przykład pokazuje treść z tabeli zasobów określonego typu Plik APK:

aapt2 dump resources output.apk

Zrzuć podrzędne polecenia

Za pomocą polecenia dump określ jedno z tych poleceń podrzędnych:

Tabela 4. Zrzuć podrzędne polecenia

Opcje zrzutu

W połączeniu z usługą dump możesz używać tych opcji:

Tabela 5. Opcje zrzutu

Różnice

Użyj narzędzia diff, aby porównać 2 pakiety APK i znaleźć różnice między nimi.

Składnia różnic

Ogólna składnia elementu diff jest taka:

aapt2 diff first.apk second.apk

Polecenie diff nie ma żadnych opcji.

Optymalizuj

optimize służy do uruchamiania optymalizacji scalonych zasobów oraz resources.arsc. Ta optymalizacja może zmniejszyć rozmiar pliku APK o około 1-3%, w zależności od w których używa się różnych zasobów.

Optymalizuj składnię

Ogólna składnia elementu optimize jest taka:

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

Poniższy przykład optymalizuje zasoby w input.apk i tworzy nowy, zoptymalizowany plik APK w aplikacji output.apk. Zastępuje ona zwykłą tabelę kartotekową z bardziej kompaktowym drzewem wyszukiwania binarnego, dzięki czemu plik APK na koszt pobierania danych:

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

Opcje optymalizacji

W połączeniu z usługą optimize możesz używać tych opcji:

Tabela 6. Opcje optymalizacji

Pozyskiwanie

Domyślnie polecenie AAPT compile kompiluje zasoby do formatu binarnego która jest odpowiednia dla plików APK. Możesz też określić format protokołu. który jest odpowiedni dla pakietów aplikacji na Androida, określając --proto-format. convert konwertuje pliki APK między tymi dwoma formatami.

Konwertuj składnię

Ogólna składnia słowa convert jest taka:

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

Poniższy przykład pokazuje konwertowanie zasobów w input.apk i tworzy nowy, Plik APK w formacie output.apk zawierający zasoby formatu protobuf. Zastępuje ono standardowy tabela kartotekowa z bardziej zwartym drzewem wyszukiwania binarnego, w wyniku z mniejszym plikiem APK i kosztem wydajności pobierania:

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

Opcje konwersji

W połączeniu z usługą convert możesz używać tych opcji:

Tabela 7. Opcje konwersji

Tryb demona

W programie AAPT w wersji 2.19 wprowadzono tryb demona do wydawania poleceń. Tryb demona pozwala wpisujesz wiele poleceń w jednej sesji AAPT.

Składnia demonów

Uruchom tryb demona za pomocą tego polecenia:

aapt2 daemon

Gdy działa on w trybie demona, możesz wpisywać polecenia. Każdy argument funkcji musi znajdować się w osobnym wierszu z pustym wierszem na końcu. Wyjdź z trybu demona, naciskając Control+D.

Rozważ te indywidualne polecenia compile:

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/

Te polecenia można wprowadzić w trybie demona w ten sposób:

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

Opcje trybu demona

Jedyna opcja dla trybu demona to --trace-folder folder, który generuje plik JSON systrace fragment logu czasu do określonego folder.

Wersja

Za pomocą polecenia version określ wersję AAPT2, której używasz:

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

Działanie zmienia się po użyciu AAPT2

Przed wprowadzeniem AAPT2 domyślną wersją narzędzia Android Asset Packaging Tool był AAPT. który został już wycofany. Chociaż AAPT2 powinna od razu działać z starszych projektów, w tej sekcji opisano niektóre zmiany w zachowaniu, które o których wiadomo.

Hierarchie elementów w pliku manifestu Androida

W poprzednich wersjach AAPT elementy zagnieżdżone w nieprawidłowych węzłach AndroidManifest.xml plik został zignorowany lub spowodował ostrzeżenie. Na przykład:

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

Poprzednie wersje AAPT ignorowały po prostu nieprawidłowo umieszczony tag <action>.

W przypadku protokołu AAPT2 pojawia się następujący błąd:

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

Aby rozwiązać ten problem, sprawdź, czy elementy manifestu są prawidłowo zagnieżdżone. Aby dowiedzieć się więcej, przeczytaj Omówienie pliku manifestu aplikacji.

Deklaracja zasobów

Nie możesz już wskazywać typu zasobu za pomocą atrybutu name. Ten przykład nieprawidłowo deklaruje element zasobu attr:

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

Ten sposób zadeklarowania typu zasobu powoduje następujący błąd kompilacji:

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

Aby naprawić ten błąd, jawnie zadeklaruj typ za pomocą atrybutu type="attr":

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

Poza tym przy deklarowaniu elementu <style> jego elementem nadrzędnym musi być również typu zasobu stylu. W przeciwnym razie pojawi się błąd podobny do tego:

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

Nieprawidłowe użycie symboli odwołania do zasobu @

AAPT2 powoduje błędy kompilacji, gdy pominiesz lub nieprawidłowo umieścisz zasób symboli referencyjnych (@). Jeśli na przykład pominiesz ten symbol przy określając atrybut stylu:

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

Podczas tworzenia modułu AAPT2 zgłasza następujący błąd kompilacji:

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

Ponadto, jeśli błędnie dodasz symbol przy otwieraniu zasób z przestrzeni nazw android:

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

Podczas tworzenia modułu AAPT2 zgłasza następujący błąd kompilacji:

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

Nieprawidłowa konfiguracja bibliotek

Jeśli Twoja aplikacja zależy od biblioteki innej firmy, która została stworzona przy użyciu starszych wersji pakietów Android SDK Build Tools, aplikacja może ulec awarii w czasie działania bez wyświetlania żadnych błędów ani ostrzeżeń. Ta awaria może wystąpić, ponieważ podczas tworzenia biblioteki pola R.java są zadeklarował: final. W rezultacie wszystkie identyfikatory zasobów są w sekcji na zajęciach w bibliotece.

AAPT2 opiera się na możliwości ponownego przypisywania identyfikatorów do zasobów biblioteki podczas tworzenia do aplikacji. Jeśli biblioteka zakłada, że identyfikatory mają wartość final, i umieszcza je w elemencie pliku DEX biblioteki, występuje niezgodność środowiska wykonawczego.

Aby naprawić ten błąd, skontaktuj się z autorem biblioteki i odbuduj ją używając najnowszej wersji pakietu Android SDK Build Tools, i ponownie opublikuj kod bibliotece.