ААПТ2

AAPT2 (Android Asset Packaging Tool) — это инструмент сборки, который Android Studio и плагин Android Gradle используют для компиляции и упаковки ресурсов вашего приложения. AAPT2 анализирует, индексирует и компилирует ресурсы в двоичный формат, оптимизированный для платформы Android.

Плагин Android Gradle 3.0.0 и выше по умолчанию включает AAPT2. Обычно вам не нужно самостоятельно вызывать aapt2 . Однако если вы предпочитаете использовать свой терминал и собственную систему сборки вместо Android Studio, вы можете использовать AAPT2 из командной строки. Вы также можете отладить ошибки сборки, связанные с AAPT2, из командной строки. Для этого найдите AAPT2 как отдельный инструмент в Android SDK Build Tools 26.0.2 и более поздних версиях.

Чтобы загрузить инструменты сборки Android SDK из командной строки, используйте sdkmanager и выполните следующую команду:

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

Загрузив инструменты сборки SDK, найдите AAPT2 в android_sdk /build-tools/ version / .

Поскольку версии инструментов сборки Android SDK выпускаются нечасто, версия AAPT2, включенная в ваши инструменты сборки SDK, может быть не последней. Чтобы получить последнюю версию AAPT2, загрузите AAPT2 из Google Maven .

Чтобы использовать AAPT2 из командной строки в Linux или Mac, выполните команду aapt2 . В Windows запустите команду aapt2.exe .

AAPT2 поддерживает более быструю компиляцию ресурсов за счет инкрементной компиляции. Для выполнения инкрементной компиляции обработка ресурсов разделена на два этапа:

• Компилировать : компилирует файлы ресурсов в двоичные форматы.
• Ссылка : объединяет все скомпилированные файлы и упаковывает их в один пакет.

Такое разделение помогает повысить производительность инкрементных сборок. Например, если есть изменения в одном файле, вам нужно перекомпилировать только этот файл.

Загрузите AAPT2 из Google Maven

Чтобы получить новейшую версию AAPT2, не включенную в инструменты сборки, загрузите AAPT2 из репозитория Google Maven следующим образом:

1. В индексе репозитория перейдите к com.android.tools.build > aapt2 .
2. Скопируйте имя последней версии AAPT2.

3. Вставьте имя версии, которое вы скопировали, в следующий URL-адрес и укажите целевую операционную систему: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/aapt2-version / aapt2-version aapt2-version . aapt2-version - [windows | linux | osx] .jar

   Например, чтобы загрузить версию 3.2.0-alpha18-4804415 для Windows, используйте: 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-адресу в браузере. Загрузка AAPT2 начнется в ближайшее время.

5. Распакуйте только что скачанный JAR-файл.

   Файл JAR должен содержать исполняемый файл aapt2 и некоторые библиотеки, от которых зависит этот исполняемый файл.

Скомпилировать

AAPT2 поддерживает компиляцию всех типов ресурсов Android , таких как графические объекты и XML-файлы. Когда вы вызываете AAPT2 для компиляции, передайте один файл ресурсов в качестве входных данных для каждого вызова. Затем AAPT2 анализирует файл и генерирует промежуточный двоичный файл с расширением .flat .

При передаче целых каталогов AAPT2 перекомпилирует все файлы в каталоге, даже если изменился только один ресурс. Хотя вы можете передавать в AAPT2 каталоги ресурсов, содержащие более одного файла ресурсов, с помощью флага --dir , таким образом вы не получите преимуществ от инкрементной компиляции ресурсов.

Типы выходных файлов могут различаться в зависимости от входных данных, которые вы предоставляете для компиляции, как показано в следующей таблице:

Таблица 1. Типы входных и выходных файлов для компиляции

Выходные файлы AAPT2 не являются исполняемыми, и вам придется позже включить эти двоичные файлы в качестве входных данных на этапе компоновки для создания APK. Однако сгенерированный APK-файл не является исполняемым файлом, который можно сразу развернуть на устройстве Android, поскольку он не содержит файлов DEX и не подписан.

Синтаксис компиляции

Общий синтаксис использования compile следующий:

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

В следующем примере AAPT2 компилирует файлы ресурсов с values.xml и 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, имя выходного файла зависит от имени входного файла и имени его родительского каталога.

В предыдущем примере с файлом strings.xml в качестве входных данных aapt2 автоматически присваивает выходному файлу имя values-en_strings.arsc.flat . Flat . Однако скомпилированный файл с возможностью рисования, хранящийся в каталоге с возможностью рисования, называется drawable_img.png.flat .

Варианты компиляции

Есть несколько опций, которые вы можете использовать с командой compile , как показано в таблице 2:

Таблица 2. Параметры команды компиляции

Связь

На этапе компоновки AAPT2 объединяет все промежуточные файлы, созданные на этапе компиляции, такие как таблицы ресурсов, двоичные файлы XML и обработанные файлы PNG, а затем упаковывает файлы в один APK. Кроме того, на этом этапе можно создать другие вспомогательные файлы, такие как файлы правил R.java и ProGuard. Однако сгенерированный APK не содержит байт-кода DEX и не имеет знака. Вы не можете развернуть этот APK на устройстве.

Если вы не используете плагин Android Gradle для создания приложения из командной строки , вы можете использовать другие инструменты командной строки, такие как d8 для компиляции байт-кода Java в байт-код DEX и apksigner для подписи вашего APK.

Синтаксис ссылки

Общий синтаксис использования link следующий:

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

В следующем примере AAPT2 объединяет два промежуточных файла: drawable_Image.flat и values_values.arsc.flat Flat, а также файл AndroidManifest.xml . AAPT2 связывает результат с файлом android.jar , который содержит ресурсы, определенные в пакете 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

Варианты ссылок

С командой link вы можете использовать следующие параметры:

Таблица 3. Параметры команды Link

Свалка

dump используется для печати информации об APK, созданном вами с помощью команды link .

Синтаксис дампа

Общий синтаксис использования dump следующий:

aapt2 dump sub-command filename.apk [options]

В следующем примере выводится содержимое из таблицы ресурсов указанного APK:

aapt2 dump resources output.apk

Подкоманды дампа

Вместе с командой dump укажите одну из следующих подкоманд:

Таблица 4. Подкоманды дампа

Параметры дампа

Используйте следующие параметры с dump :

Таблица 5. Параметры дампа

Разница

Используйте diff для сравнения двух APK и выявления различий между ними.

Синтаксис различий

Общий синтаксис использования diff следующий:

aapt2 diff first.apk second.apk

Для команды diff нет опций.

Оптимизировать

optimize используется для оптимизации объединенных ресурсов и resources.arsc перед их упаковкой в ​​APK. Эта оптимизация может уменьшить размер APK примерно на 1–3 %, в зависимости от размера и количества используемых ресурсов.

Оптимизировать синтаксис

Общий синтаксис использования optimize следующий:

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

В следующем примере ресурсы в input.apk оптимизируются, а в output.apk создается новый оптимизированный APK. Он заменяет обычное представление плоской таблицы более компактным двоичным деревом поиска, в результате чего APK становится меньше за счет производительности поиска:

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

Оптимизировать параметры

С optimize вы можете использовать следующие параметры:

Таблица 6. Варианты оптимизации

Конвертировать

По умолчанию команда compile AAPT компилирует ресурсы в двоичный формат, подходящий для APK. Также можно указать формат protobuf, подходящий для AAB, указав --proto-format . Команда convert преобразует APK-файлы между двумя форматами.

Преобразование синтаксиса

Общий синтаксис convert выглядит следующим образом:

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

В следующем примере ресурсы в input.apk преобразуются и создается новый APK в output.apk , содержащий ресурсы формата protobuf. Он заменяет обычное представление плоской таблицы более компактным двоичным деревом поиска, в результате чего APK становится меньше за счет производительности поиска:

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

Конвертировать параметры

Используйте следующие параметры с convert :

Таблица 7. Параметры конвертации

Режим демона

В AAPT версии 2.19 введен режим демона для выдачи команд. Режим демона позволяет вводить несколько команд за один сеанс AAPT.

Синтаксис демона

Запустите режим демона с помощью следующей команды:

aapt2 daemon

После запуска режима демона вы можете вводить команды. Каждый аргумент команды должен находиться на отдельной строке с пустой строкой в ​​конце команды. Выйдите из режима демона, нажав Control+D.

Рассмотрим следующие отдельные команды 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/

Эти команды можно ввести в режиме демона следующим образом:

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

Параметры режима демона

Единственный параметр для режима демона — это --trace-folder folder , который генерирует фрагмент трассировки JSON systrace для указанной folder .

Версия

Определите версию AAPT2, которую вы используете, с помощью команды version :

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

Поведение меняется при использовании AAPT2

До AAPT2 AAPT был версией по умолчанию инструмента упаковки ресурсов Android, который сейчас устарел. Хотя AAPT2 должен сразу работать со старыми проектами, в этом разделе описаны некоторые изменения в поведении, о которых вам следует знать.

Иерархии элементов в манифесте Android

В предыдущих версиях AAPT элементы, вложенные в неправильные узлы файла AndroidManifest.xml , либо игнорировались, либо вызывали предупреждение. Например, рассмотрим следующий пример:

<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 просто игнорировали неуместный тег <action> .

При использовании AAPT2 вы получаете следующую ошибку:

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

Чтобы решить эту проблему, убедитесь, что элементы манифеста вложены правильно. Для получения дополнительной информации прочтите обзор манифеста приложения .

Декларация ресурсов

Вы больше не можете указать тип ресурса из атрибута name . В следующем примере неправильно объявляется элемент ресурса attr :

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

Такое объявление типа ресурса приводит к следующей ошибке сборки:

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

Чтобы устранить эту ошибку, явно объявите тип, используя type="attr" :

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

Кроме того, при объявлении элемента <style> его родительский элемент также должен быть типом ресурса стиля. В противном случае вы получите сообщение об ошибке, подобное следующему:

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

Неправильное использование символов ссылки на ресурс @.

AAPT2 выдает ошибки сборки, если вы опускаете или неправильно размещаете символы ссылки на ресурсы ( @ ). Например, если вы опустите символ при указании атрибута стиля:

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

При сборке модуля AAPT2 выдает следующую ошибку сборки:

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

Кроме того, если вы неправильно включили этот символ при доступе к ресурсу из пространства имен android :

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

При сборке модуля AAPT2 выдает следующую ошибку сборки:

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

Неправильная настройка библиотек

Если ваше приложение зависит от сторонней библиотеки, созданной с использованием более старых версий Android SDK Build Tools , ваше приложение может аварийно завершить работу во время выполнения без отображения каких-либо ошибок или предупреждений. Этот сбой может произойти из-за того, что во время создания библиотеки поля R.java объявляются final . В результате все идентификаторы ресурсов встроены в классы библиотеки.

AAPT2 опирается на возможность переназначать идентификаторы ресурсам библиотеки при создании приложения. Если библиотека предполагает, что идентификаторы являются final , и встраивает их в библиотеку DEX, возникает несоответствие времени выполнения.

Чтобы устранить эту ошибку, обратитесь к автору библиотеки, чтобы он пересобрал ее с помощью последней версии инструментов сборки Android SDK и повторно опубликовал библиотеку.