ААПТ2

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

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

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

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

После загрузки SDK Build Tools найдите AAPT2 в android_sdk /build-tools/ version / .

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

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

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

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

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

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

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

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- 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 . Однако скомпилированный файл drawable, хранящийся в каталоге drawable, называется 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 , а также файл 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 и создаётся новый оптимизированный APK в output.apk . Он заменяет обычное представление в виде плоской таблицы более компактным, что приводит к уменьшению размера APK, потребления памяти и задержки запуска, а также к небольшому увеличению времени поиска отдельных ресурсов после запуска.

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

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

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

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

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

По умолчанию команда AAPT compile компилирует ресурсы в двоичный формат, подходящий для 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 , которая генерирует фрагмент трассировки systrace JSON для указанной folder .

Версия

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

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

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

До AAPT2 AAPT был версией Android Asset Packaging Tool по умолчанию, которая теперь устарела. Хотя 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 Build Tools, и повторно опубликуйте библиотеку.