aapt - manual de referencia, opciones, ejemplos de comandos


NOMBRE

aapt - Herramienta de empaquetado de activos de Android

SINOPSIS

aapt command [ options ] files ...

DESCRIPCIÓN

La herramienta de empaquetado de activos de Android (aapt) toma los archivos de recursos de su aplicación, como el archivo AndroidManifest.xml y los archivos XML para sus actividades, y los compila. También se produce un R.java para que pueda hacer referencia a sus recursos desde su código Java.

OPCIONES

Un resumen de las opciones se incluye a continuación.

-a

imprimir datos específicos de Android (recursos, manifiesto) al enumerar

-c

especificar qué configuraciones incluir. El valor predeterminado es todas las configuraciones. El valor del parámetro debe ser una lista de valores de configuración separados por comas. Las configuraciones regionales se deben especificar como un idioma o como un par de idioma y región. Algunos ejemplos: en port,en port,land,en_US

Si coloca la configuración regional especial, zz_ZZ en la lista, realizará una pseudolocalización en la configuración regional predeterminada, modificando todas las cadenas para que pueda buscar cadenas que no pasaron por el proceso de internacionalización. Por ejemplo: puerto,tierra,zz_ZZ

-d

uno o más activos de dispositivo para incluir, separados por comas

-f

forzar sobrescritura de archivos existentes

-g

especifique una tolerancia de píxeles para forzar las imágenes a escala de grises, por defecto 0

-j

especificar un archivo jar o zip que contenga clases para incluir

-k

ruta basura de archivo(s) agregado(s)

-m

crear directorios de paquetes en la ubicación especificada por -J

-u

actualizar paquetes existentes (agregar nuevos, reemplazar antiguos, eliminar archivos eliminados)

-v

salida detallada

-x

crear ID de recursos de extensión (que no sean de aplicación)

-z

requieren la localización de atributos de recursos marcados con localización="sugerido"

-A

directorio adicional en el que encontrar archivos de activos sin procesar

-G

Un archivo para generar opciones de proguard.

-F

especificar el archivo apk para la salida

-I

agregar un paquete existente al conjunto de inclusión base

-J

especificar dónde dar salida a las definiciones constantes de recursos de R.java

-M

especifique la ruta completa a AndroidManifest.xml para incluir en zip

-P

especificar dónde generar definiciones de recursos públicos

-S

directorio en el que encontrar recursos. Se escanearán varios directorios y tendrá prioridad la primera coincidencia que se encuentre (de izquierda a derecha).

-0

especifica una extensión adicional para la cual dichos archivos no se almacenarán comprimidos en el .apk. Una cadena vacía significa que no se comprime ningún archivo.

--debug-mode

inserta android:debuggable="true" en el nodo de la aplicación del manifiesto, lo que hace que la aplicación se pueda depurar incluso en dispositivos de producción.

--min-sdk-version

inserta android:minSdkVersion en el manifiesto. Si la versión es 7 o superior, la codificación predeterminada de los recursos será UTF-8.

--target-sdk-version

inserta android:targetSdkVersion en el manifiesto.

--max-res-version

ignora los directorios de recursos versionados por encima del valor dado.

--values

cuando se usa con "volcar recursos" también incluye valores de recursos.

--version-code

inserta android:versionCode en el manifiesto.

--version-name

inserta android:versionName en el manifiesto.

--custom-package

genera R.java en un paquete diferente.

--extra-packages

generar R.java para bibliotecas. Separe las bibliotecas con ':'.

--generate-dependencies

generar archivos de dependencia en los mismos directorios para R.java y el paquete de recursos

--auto-add-overlay

Agregue automáticamente recursos que solo están en superposiciones.

--preferred-configurations

Como la opción -c para filtrar configuraciones innecesarias, pero solo expresa una preferencia. Si no hay ningún recurso disponible con la configuración preferida, no se eliminará.

--rename-manifest-package

Vuelva a escribir el manifiesto para que su nombre de paquete sea el nombre de paquete dado aquí. Los nombres de clase relativos (por ejemplo, .Foo) se cambiarán a nombres absolutos con el paquete antiguo para que no sea necesario cambiar el código.

--rename-instrumentation-target-package

Vuelva a escribir el manifiesto para que todos sus componentes de instrumentación apunten al paquete dado. Útil cuando se usa junto con --rename-manifest-package para corregir pruebas contra un paquete que ha sido renombrado.

--product

Especifica qué variante elegir para cadenas que tienen variantes de productos

--utf16

cambia la codificación predeterminada de los recursos a UTF-16. Solo es útil cuando el nivel de API se establece en 7 o superior, donde la codificación predeterminada es UTF-8.

--non-constant-id

Haga que la identificación de los recursos no sea constante. Esto es necesario para crear una clase R java que no contenga el valor final pero se use para crear bibliotecas compiladas reutilizables que necesitan acceder a los recursos.

--error-on-failed-insert

Obliga a aapt a devolver un error si no puede insertar valores en el manifiesto con --debug-mode, --min-sdk-version, --target-sdk-version --version-code y --version-name. La inserción generalmente falla si el manifiesto ya define el atributo.

--output-text-symbols

Genera un archivo de texto que contiene los símbolos de recursos de la clase R en la carpeta especificada.

--ignore-assets

Activos a ignorar.

EJEMPLOS

Listar el contenido del archivo compatible con Zip:

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

Valores de volcado:

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

El SUJETO puede ser:

strings

Imprima el contenido del grupo de cadenas de la tabla de recursos en el APK.

badging

Imprime la etiqueta y el icono de la aplicación declarada en APK.

permissions

Imprime los permisos desde la APK.

resources

Imprime la tabla de recursos desde el APK.

configurations

Imprime las configuraciones en el APK.

xmltree

Imprima los xml compilados en los activos dados.

xmlstrings

Imprime las cadenas de los activos xml compilados dados.

Empaqueta los recursos de Android. Leerá los activos y recursos que se proporcionan con los argumentos -M -A -S o raw-files-dir. Las opciones -J -P -F y -R controlan qué archivos se envían:

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]

Eliminar archivos específicos del archivo compatible con Zip:

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

Agregue archivos específicos al archivo compatible con Zip:

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

Realice el preprocesamiento de PNG en una o varias carpetas de recursos y almacene los resultados en la carpeta de salida:

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

Realice el preprocesamiento de PNG en un solo archivo:

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

Versión del programa de impresión:

aapt v[ersion]

AUTOR

aapt fue escrito por The Android Open Source Project.