aapt - справочное руководство, опции, примеры команд


ИМЯ

aapt - Инструмент упаковки активов Android

СИНТАКСИС

aapt command [ options ] files ...

ОПИСАНИЕ

Инструмент упаковки ресурсов Android (aapt) берет файлы ресурсов вашего приложения, такие как файл AndroidManifest.xml и файлы XML для ваших действий, и компилирует их. Также создается R.java, чтобы вы могли ссылаться на свои ресурсы из кода Java.

ПАРАМЕТРЫ

Краткое изложение вариантов приведено ниже.

-a

печатать специфичные для Android данные (ресурсы, манифест) при перечислении

-c

указать, какие конфигурации включить. По умолчанию все конфигурации. Значение параметра должно быть списком значений конфигурации, разделенных запятыми. Локали должны быть указаны либо как язык, либо как пара язык-регион. Некоторые примеры: en port,en port,land,en_US.

Если вы добавите в список специальную локаль zz_ZZ, она выполнит псевдолокализацию в локали по умолчанию, изменив все строки, чтобы вы могли искать строки, пропущенные в процессе интернационализации. Например: порт,земля,zz_ZZ

-d

один или несколько активов устройства для включения, разделенных запятыми

-f

принудительно перезаписать существующие файлы

-g

укажите допуск пикселя, чтобы принудительно отображать изображения в оттенках серого, по умолчанию 0

-j

укажите файл jar или zip, содержащий классы для включения

-k

добавлен ненужный путь к файлам

-m

создавать каталоги пакетов в месте, указанном параметром -J

-u

обновить существующие пакеты (добавить новые, заменить старые, удалить удаленные файлы)

-v

подробный вывод

-x

создавать расширяющиеся (не относящиеся к приложениям) идентификаторы ресурсов

-z

требуется локализация атрибутов ресурсов, отмеченных localization="suggested"

-A

дополнительный каталог, в котором можно найти необработанные файлы активов

-G

Файл для вывода опций proguard.

-F

указать файл apk для вывода

-I

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

-J

указать, где выводить определения констант ресурсов R.java

-M

укажите полный путь к AndroidManifest.xml для включения в zip

-P

указать, где выводить определения общедоступных ресурсов

-S

каталог, в котором можно найти ресурсы. Будет просканировано несколько каталогов, и первое найденное совпадение (слева направо) будет иметь приоритет.

-0

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

--debug-mode

вставляет android:debuggable="true" в узел приложения манифеста, делая приложение доступным для отладки даже на производственных устройствах.

--min-sdk-version

вставляет android:minSdkVersion в манифест. Если версия 7 или выше, кодировка по умолчанию для ресурсов будет в UTF-8.

--target-sdk-version

вставляет android:targetSdkVersion в манифест.

--max-res-version

игнорирует каталоги ресурсов с версиями выше заданного значения.

--values

при использовании с «ресурсами дампа» также включает значения ресурсов.

--version-code

вставляет android:versionCode в манифест.

--version-name

вставляет android:versionName в файл manifest.

--custom-package

генерирует R.java в другой пакет.

--extra-packages

генерировать R.java для библиотек. Разделяйте библиотеки с помощью ':'.

--generate-dependencies

создавать файлы зависимостей в тех же каталогах для R.java и пакета ресурсов

--auto-add-overlay

Автоматически добавлять ресурсы, которые есть только в оверлеях.

--preferred-configurations

Подобно опции -c для фильтрации ненужных конфигураций, но только выражает предпочтение. Если ресурс с предпочтительной конфигурацией отсутствует, он не будет удален.

--rename-manifest-package

Перепишите манифест так, чтобы его имя пакета было именем пакета, указанным здесь. Относительные имена классов (например, .Foo) будут изменены на абсолютные имена в старом пакете, чтобы код не нужно было менять.

--rename-instrumentation-target-package

Перепишите манифест так, чтобы все его компоненты инструментирования были нацелены на данный пакет. Полезно при использовании в сочетании с --rename-manifest-package для исправления тестов для пакета, который был переименован.

--product

Указывает, какой вариант выбрать для строк с вариантами продукта.

--utf16

изменяет кодировку по умолчанию для ресурсов на UTF-16. Полезно, только если уровень API установлен на 7 или выше, где по умолчанию используется кодировка UTF-8.

--non-constant-id

Сделайте идентификатор ресурсов непостоянным. Это необходимо для создания класса R java, который не содержит конечного значения, но используется для создания повторно используемых скомпилированных библиотек, которым требуется доступ к ресурсам.

--error-on-failed-insert

Заставляет aapt возвращать ошибку, если ему не удается вставить значения в манифест с параметрами --debug-mode, --min-sdk-version, --target-sdk-version --version-code и --version-name. Вставка обычно завершается ошибкой, если атрибут уже определен в манифесте.

--output-text-symbols

Создает текстовый файл, содержащий символы ресурсов класса R в указанной папке.

--ignore-assets

Активы, которые следует игнорировать.

ПРИМЕРЫ

Список содержимого Zip-совместимого архива:

aapt l[ist] [-v] [-a] file.{zip,jar,apk}

Дамп значения:

aapt d[ump] [--values] SUBJECT file.{apk} [asset [asset ...]]

ТЕМА может быть:

strings

Распечатайте содержимое пула строк таблицы ресурсов в APK.

badging

Распечатайте этикетку и значок для приложения, заявленного в APK.

permissions

Распечатайте разрешения из APK.

resources

Распечатайте таблицу ресурсов из APK.

configurations

Распечатайте конфигурации в APK.

xmltree

Распечатайте скомпилированные XML-файлы в заданных ресурсах.

xmlstrings

Распечатайте строки данных скомпилированных ресурсов xml.

Упакуйте ресурсы Android. Он будет читать активы и ресурсы, которые предоставляются с аргументами -M -A -S или raw-files-dir. Опции -J -P -F и -R определяют, какие файлы будут выводиться:

aapt p[ackage] [-d] [-f] [-m] [-u] [-v] [-x] [-z] [-M AndroidManifest.xml] [-0 extension [-0 extension ...]] [-g tolerance] [-j jarfile] [--debug-mode] [--min-sdk-version VAL] [--target-sdk-version VAL] [--app-version VAL] [--app-version-name TEXT] [--custom-package VAL] [--rename-manifest-package PACKAGE] [--rename-instrumentation-target-package PACKAGE] [--utf16] [--auto-add-overlay] [--max-res-version VAL] [-I base-package [-I base-package ...]] [-A asset-source-dir] [-G class-list-file] [-P public-definitions-file] [-S resource-sources [-S resource-sources ...]] [-F apk-file] [-J R-file-dir] [--product product1,product2,...] [-c CONFIGS] [--preferred-configurations CONFIGS] [raw-files-dir [raw-files-dir] ...] [--output-text-symbols DIR]

Удалить указанные файлы из Zip-совместимого архива:

aapt r[emove] [-v] file.{zip,jar,apk} file1 [file2 ...] 

Добавить указанные файлы в Zip-совместимый архив:

aapt a[dd] [-v] file.{zip,jar,apk} file1 [file2 ...]

Выполните предварительную обработку PNG в одной или нескольких папках ресурсов и сохраните результаты в выходной папке:

aapt c[runch] [-v] -S resource-sources ... -C output-folder ... 

Выполните предварительную обработку PNG в одном файле:

aapt s[ingleCrunch] [-v] -i input-file -o outputfile 

Распечатать версию программы:

aapt v[ersion]

АВТОР

aapt был написан проектом Android с открытым исходным кодом.