Se usó la API de Cloud Translation para traducir esta página.

Reglas de Android

Informar un problema Ver fuente {/2/}}Noche {/2/}

Reglas

android_binary

aar_import

android_library

android_instrumentation_test

android_local_test

android_device

android_ndk_repository

android_sdk_repository

android_binary
Ver el código fuente de la regla
android_binary(name, deps, srcs, assets, assets_dir, compatible_with, crunch_png, custom_package, debug_key, debug_signing_keys, debug_signing_lineage_file, densities, deprecation, dex_shards, dexopts, distribs, enable_data_binding, exec_compatible_with, exec_properties, features, incremental_dexing, instruments, javacopts, key_rotation_min_sdk, licenses, main_dex_list, main_dex_list_opts, main_dex_proguard_specs, manifest, manifest_values, multidex, nocompress_extensions, package_id, plugins, proguard_apply_dictionary, proguard_apply_mapping, proguard_generate_mapping, proguard_specs, resource_configuration_filters, resource_files, restricted_to, shrink_resources, tags, target_compatible_with, testonly, visibility)

Produce archivos de paquetes de aplicaciones para Android (.apk).

Destinos de salida implícitos

name.apk: Es un archivo de paquete de aplicación para Android firmado con claves de depuración y con alineación que se puede usar para desarrollar y depurar tu aplicación. No puedes lanzar tu aplicación si la firmaste con las claves de depuración.

name_unsigned.apk: Es una versión sin firmar del archivo anterior que podría firmarse con las claves de lanzamiento antes de lanzarla al público.

name_deploy.jar: Es un archivo de Java que contiene el cierre transitivo de este destino.
El jar de implementación contiene todas las clases que encontraría un cargador de clases que buscara la ruta de clase del tiempo de ejecución de este destino de principio a fin.

name_proguard.jar: Es un archivo Java que contiene el resultado de la ejecución de ProGuard en name_deploy.jar. Este resultado solo se produce si se especifica el atributo proguard_specs.

name_proguard.map: Es un resultado de archivo de asignación que produce la ejecución de ProGuard en name_deploy.jar. Este resultado solo se produce si se especifica el atributo proguard_specs y se configura proguard_generate_mapping o shrink_resources.

Ejemplos

Puedes encontrar ejemplos de reglas de Android en el directorio examples/android del árbol de fuentes de Bazel.
Argumentos

Atributos

name
Name; obligatorio

Un nombre único para este destino.

deps
Lista de etiquetas; el valor predeterminado es []
Es la lista de otras bibliotecas que se vincularán al objetivo binario. Los tipos de bibliotecas permitidos son los siguientes: android_library, java_library con restricción android y cc_library uniendo o produciendo bibliotecas nativas .so para la plataforma de destino de Android.

srcs
Lista de etiquetas; el valor predeterminado es []
La lista de archivos de origen que se procesan para crear el destino.
Se compilaron los archivos srcs de tipo .java. Para facilitar la lectura, no es bueno poner el nombre de un archivo de origen .java generado en srcs. En su lugar, coloca el nombre de la regla dependiente en srcs, como se describe a continuación.

Se descomprimen y compilan los archivos srcs de tipo .srcjar. (esto es útil si necesitas generar un conjunto de archivos .java con una extensión genrule o de compilación).

assets
Lista de etiquetas; el valor predeterminado es []
La lista de elementos que se empaquetarán. Por lo general, es un glob de todos los archivos del directorio assets. También puedes hacer referencia a otras reglas (cualquier regla que produzca archivos) o a archivos exportados en los otros paquetes, siempre que todos esos archivos estén en el directorio assets_dir del paquete correspondiente.

assets_dir
String; el valor predeterminado es ""
Es la cadena que proporciona la ruta de acceso a los archivos en assets. Los pares assets y assets_dir describen los elementos empaquetados y se deben proporcionar ambos atributos o ninguno.

crunch_png
Booleano; el valor predeterminado es True
Haz procesamiento de PNG (o no). Esto es independiente del procesamiento de nine-patch, que siempre se realiza. Esta es una solución obsoleta para un error de aapt que se corrigió en aapt2.

custom_package
String; el valor predeterminado es ""
Es el paquete de Java para el que se generarán fuentes de Java. De forma predeterminada, el paquete se infiere del directorio en el que se encuentra el archivo BUILD que contiene la regla. Puedes especificar otro paquete, pero no es recomendable, ya que puede generar conflictos de ruta de clase con otras bibliotecas que solo se detectarán en el tiempo de ejecución.

debug_key
Etiqueta; el valor predeterminado es "@bazel_tools//tools/android:debug_keystore"
Archivo que contiene el almacén de claves de depuración que se usará para firmar el APK de depuración. Por lo general, no querrás usar una clave que no sea la predeterminada, por lo que debes omitir este atributo.
ADVERTENCIA: No uses las claves de producción, ya que deben protegerlas de manera estricta y no deben guardarse en el árbol de fuentes.

debug_signing_keys
Lista de etiquetas; el valor predeterminado es []
Lista de archivos y almacenes de claves de depuración que se usarán para firmar el APK de depuración. Por lo general, no quieres usar claves que no sean la predeterminada, por lo que debes omitir este atributo.
ADVERTENCIA: No uses las claves de producción, ya que deben protegerlas de manera estricta y no deben guardarse en el árbol de fuentes.

debug_signing_lineage_file
Etiqueta; el valor predeterminado es None
Archivo que contiene el linaje de firma de debug_signature_keys. Por lo general, no quieres usar claves que no sean la predeterminada, por lo que debes omitir este atributo.
ADVERTENCIA: No uses las claves de producción, ya que deben protegerlas de manera estricta y no deben guardarse en el árbol de fuentes.

densities
Lista de cadenas; el valor predeterminado es []
Densidades que se deben filtrar cuando se compila el APK Para reducir el tamaño del APK, se quitarán los recursos de elementos de diseño de trama que no se cargarían en un dispositivo con las densidades de pantalla especificadas. También se agregará al manifiesto una sección de pantallas compatibles correspondiente si aún no contiene una ficha de superconjunto.

dex_shards
Número entero; el valor predeterminado es 1
La cantidad de fragmentos para la conversión a DEX. Esto hace que la conversión a DEX sea mucho más rápida a expensas del tiempo de instalación y de inicio de la app. Cuanto más grande sea el objeto binario, más fragmentos se deberían usar. 25 es un buen valor para comenzar a experimentar.
Ten en cuenta que cada fragmento generará al menos un archivo DEX en la app final. Por este motivo, no se recomienda configurarlo en más de 1 para los objetos binarios de lanzamiento.

dexopts
Lista de cadenas; el valor predeterminado es []
Marcas de línea de comandos adicionales para la herramienta dx al generar classes.dex. Sujeto a la sustitución "Make variable" y a la asignación de token de shell de Bourne.

enable_data_binding
Booleano; el valor predeterminado es False
Si es verdadera, esta regla procesa expresiones de vinculación de datos en los recursos de diseño incluidos mediante el atributo resource_files. Sin esta configuración, las expresiones de vinculación de datos producen fallas de compilación.
Para compilar una app para Android con vinculación de datos, también debes hacer lo siguiente:

Establece este atributo para todas las reglas de Android que dependan de este de forma transitiva. Esto se debe a que los dependencias heredan las expresiones de vinculación de datos de la regla a través de la combinación de recursos. Por lo tanto, también deben compilar con vinculación de datos para analizar esas expresiones.
Agrega una entrada deps = para la biblioteca del entorno de ejecución de vinculación de datos a todos los destinos que establecen este atributo. La ubicación de esta biblioteca depende de la configuración de tu depósito.

incremental_dexing
Número entero; no configurable; el valor predeterminado es -1
Fuerza la compilación del destino con o sin la conversión a DEX incremental, anulando los valores predeterminados y la marca --incremental_dexing.

instruments
Etiqueta; el valor predeterminado es None

Es el objetivo android_binary que se debe instrumentar.

Si se configura este atributo, este android_binary se tratará como una aplicación de prueba para pruebas de instrumentación. Un destino android_instrumentation_test puede especificar este objetivo en su atributo test_app.

javacopts
Lista de cadenas; el valor predeterminado es []
Opciones de compilador adicionales para este destino. Sujeto a la sustitución "Make variable" y a la asignación de token de shell de Bourne.
Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.

key_rotation_min_sdk
String; el valor predeterminado es ""
Establece la versión mínima de la plataforma de Android (nivel de API) para la que se debe usar la clave de firma rotada de un APK para producir la firma del APK. La clave de firma original del APK se usará en todas las versiones anteriores de la plataforma.

main_dex_list
Etiqueta; el valor predeterminado es None
Un archivo de texto contiene una lista de nombres de archivos de clase. Las clases definidas por esos archivos de clase se colocan en el archivo classes.dex primario, p. ej.:
android/support/multidex/MultiDex$V19.class android/support/multidex/MultiDex.class android/support/multidex/MultiDexApplication.class com/google/common/base/Objects.class
Se debe usar con multidex="manual_main_dex".

main_dex_list_opts
Lista de cadenas; el valor predeterminado es []
Opciones de línea de comandos para pasar al compilador de listas dex principal. Usa esta opción para modificar las clases incluidas en la lista principal de DEX.

main_dex_proguard_specs
Lista de etiquetas; el valor predeterminado es []
Archivos que se usarán como especificaciones de ProGuard para determinar las clases que se deben mantener en el DEX principal. Solo se permite si el atributo multidex se establece en legacy.

manifest
Label; obligatorio
Es el nombre del archivo de manifiesto de Android, normalmente AndroidManifest.xml. Se debe definir si se definen recursos_archivos o recursos.

manifest_values
Diccionario: String -> String; el valor predeterminado es {}
Un diccionario de valores que se anularán en el manifiesto.
Cualquier instancia de ${name} en el manifiesto se reemplazará por el valor correspondiente al nombre en este diccionario.
applicationId, versionCode, versionName, minSdkVersion, targetSdkVersion y maxSdkVersion también anularán los atributos correspondientes del manifiesto y las etiquetas uses-sdk.
packageName se ignorará y se configurará desde applicationId si se especifica o desde el paquete en el manifiesto.
Cuando manifest_merger se configura como legacy, solo applicationId, versionCode y versionName tendrán efecto.

multidex
String; el valor predeterminado es "native"
Indica si se debe dividir el código en varios archivos dex.
Valores posibles:

native: Divide el código en varios archivos dex cuando se supera el límite del índice dex 64K. Se supone que la plataforma es compatible con la plataforma nativa para cargar clases de multidex durante el tiempo de ejecución. Solo funciona con Android L y versiones posteriores.

legacy: Divide el código en varios archivos dex cuando se supera el límite del índice dex 64K. Supone que las clases de multidex se cargan a través del código de la aplicación (es decir, sin compatibilidad con plataformas nativas).

manual_main_dex: Divide el código en varios archivos dex cuando se supera el límite del índice dex 64K. Se debe especificar el contenido del archivo dex principal proporcionando una lista de clases en un archivo de texto con el atributo main_dex_list.

off: Compila todo el código en un solo archivo dex, incluso si se excede el límite de índice.

nocompress_extensions
Lista de cadenas; el valor predeterminado es []
Una lista de extensiones de archivo que se deben dejar sin comprimir en el APK.

package_id
Número entero; el valor predeterminado es 0
El ID del paquete que se asignará a los recursos en este objeto binario.
Para obtener más información, consulta el argumento --package-id de AAPT2. Por lo general, no se puede establecer (y se debe) configurar, lo que da como resultado el valor predeterminado de 127 (0x7F).

plugins
Lista de etiquetas; el valor predeterminado es []
Complementos de compilador de Java para ejecutarse en el tiempo de compilación. Cada java_plugin especificado en el atributo de complementos se ejecutará cada vez que se compile este destino. Los recursos que genera el complemento se incluirán en el archivo jar de resultados del destino.

proguard_apply_dictionary
Etiqueta; el valor predeterminado es None
Es el archivo que se usará como asignación para ProGuard. Un archivo de "palabras" separado por líneas para extraer cuando se cambia el nombre de las clases y los miembros durante la ofuscación.

proguard_apply_mapping
Etiqueta; el valor predeterminado es None
Es el archivo que se usará como asignación para ProGuard. Un archivo de asignación generado por proguard_generate_mapping que se volverá a usar para aplicar la misma asignación a una compilación nueva.

proguard_generate_mapping
Booleano; no configurable; el valor predeterminado es False
Indica si se debe generar un archivo de asignación de ProGuard. El archivo de asignación solo se generará si se especifica proguard_specs. Este archivo mostrará la asignación entre los nombres de las clases, los métodos y los campos originales y ofuscados.
ADVERTENCIA: Si se usa este atributo, la especificación de ProGuard no debería contener -dontobfuscate ni -printmapping.

proguard_specs
Lista de etiquetas; el valor predeterminado es []
Archivos que se usarán como especificación de ProGuard. Ese archivo describirá el conjunto de especificaciones que usará ProGuard.

resource_configuration_filters
Lista de cadenas; el valor predeterminado es []
Una lista de filtros de configuración de recursos, como "en", que limitará los recursos del APK solo a los de la configuración "en". Para habilitar la pseudolocalización, incluye las pseudoconfiguraciones regionales en_XA o ar_XB.

resource_files
Lista de etiquetas; el valor predeterminado es []
La lista de recursos que se empaquetarán. Por lo general, es un glob de todos los archivos del directorio res.
Las etiquetas también pueden hacer referencia aquí a los archivos generados (desde genrules). La única restricción es que los resultados generados deben estar en el mismo directorio "res" que cualquier otro archivo de recursos incluido.

shrink_resources
Número entero; el valor predeterminado es -1
Establece si se deben reducir los recursos. Se quitarán del APK los recursos que no utilice el objeto binario. Esto solo es compatible con reglas que usan recursos locales (es decir, los atributos manifest y resource_files) y requiere ProGuard. Funciona casi de la misma manera que el reductor de recursos de Gradle (https://developer.android.com/studio/build/shrink-code.html#shrink-resources).
Diferencias destacadas:

Se quitarán los recursos en values/ y los recursos basados en archivos

usa strict mode de forma predeterminada

quitar recursos de ID sin usar solo es compatible con aapt2

Si se habilita la reducción de recursos, también se generará name_files/resource_shrinker.log, en la que se detallarán el análisis y las eliminaciones realizadas.
Valores posibles:

shrink_resources = 1: Activa la reducción de recursos de Android.

shrink_resources = 0: Desactiva la reducción de recursos de Android.

shrink_resources = -1: La reducción se controla con la marca --android_resource_shrinking.

aar_import
Ver el código fuente de la regla
aar_import(name, deps, data, aar, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, exports, features, licenses, restricted_to, srcjar, tags, target_compatible_with, testonly, visibility)

Esta regla permite el uso de archivos .aar como bibliotecas para las reglas android_library y android_binary.

Ejemplos

aar_import( name = "google-vr-sdk", aar = "gvr-android-sdk/libraries/sdk-common-1.10.0.aar", ) android_binary( name = "app", manifest = "AndroidManifest.xml", srcs = glob(["**.java"]), deps = [":google-vr-sdk"], )

Argumentos

Atributos

name
Name; obligatorio

Un nombre único para este destino.

aar
Label; obligatorio
El archivo .aar que se debe proporcionar a los destinos de Android que dependen de este.

exports
Lista de etiquetas; el valor predeterminado es []
Destinos para exportar a reglas que dependen de esta regla. Consulta java_library.exports.

srcjar
Etiqueta; el valor predeterminado es None
Un archivo JAR que contiene el código fuente para los archivos JAR compilados en el AAR.

android_library
Ver el código fuente de la regla
android_library(name, deps, srcs, data, assets, assets_dir, compatible_with, custom_package, deprecation, distribs, enable_data_binding, exec_compatible_with, exec_properties, exported_plugins, exports, exports_manifest, features, idl_import_root, idl_parcelables, idl_preprocessed, idl_srcs, javacopts, licenses, manifest, neverlink, plugins, proguard_specs, resource_files, restricted_to, tags, target_compatible_with, testonly, visibility)

Esta regla compila y archiva sus fuentes en un archivo .jar. La biblioteca android.jar de tiempo de ejecución de Android se coloca de manera implícita en la ruta de la clase de compilación.

Destinos de salida implícitos

libname.jar: Es un archivo de Java.

libname-src.jar: Es un archivo que contiene las fuentes ("jar de origen").

name.aar: Es un paquete "aar" de Android que contiene el archivo Java y los recursos de este destino. No contiene el cierre transitivo.

Ejemplos

Puedes encontrar ejemplos de reglas de Android en el directorio examples/android del árbol de fuentes de Bazel.
En el siguiente ejemplo, se muestra cómo configurar idl_import_root. Deja que //java/bazel/helloandroid/BUILD contenga lo siguiente:

android_library( name = "parcelable", srcs = ["MyParcelable.java"], # bazel.helloandroid.MyParcelable # MyParcelable.aidl will be used as import for other .aidl # files that depend on it, but will not be compiled. idl_parcelables = ["MyParcelable.aidl"] # bazel.helloandroid.MyParcelable # We don't need to specify idl_import_root since the aidl file # which declares bazel.helloandroid.MyParcelable # is present at java/bazel/helloandroid/MyParcelable.aidl # underneath a java root (java/). ) android_library( name = "foreign_parcelable", srcs = ["src/android/helloandroid/OtherParcelable.java"], # android.helloandroid.OtherParcelable idl_parcelables = [ "src/android/helloandroid/OtherParcelable.aidl" # android.helloandroid.OtherParcelable ], # We need to specify idl_import_root because the aidl file which # declares android.helloandroid.OtherParcelable is not positioned # at android/helloandroid/OtherParcelable.aidl under a normal java root. # Setting idl_import_root to "src" in //java/bazel/helloandroid # adds java/bazel/helloandroid/src to the list of roots # the aidl compiler will search for imported types. idl_import_root = "src", ) # Here, OtherInterface.aidl has an "import android.helloandroid.CallbackInterface;" statement. android_library( name = "foreign_interface", idl_srcs = [ "src/android/helloandroid/OtherInterface.aidl" # android.helloandroid.OtherInterface "src/android/helloandroid/CallbackInterface.aidl" # android.helloandroid.CallbackInterface ], # As above, idl_srcs which are not correctly positioned under a java root # must have idl_import_root set. Otherwise, OtherInterface (or any other # interface in a library which depends on this one) will not be able # to find CallbackInterface when it is imported. idl_import_root = "src", ) # MyParcelable.aidl is imported by MyInterface.aidl, so the generated # MyInterface.java requires MyParcelable.class at compile time. # Depending on :parcelable ensures that aidl compilation of MyInterface.aidl # specifies the correct import roots and can access MyParcelable.aidl, and # makes MyParcelable.class available to Java compilation of MyInterface.java # as usual. android_library( name = "idl", idl_srcs = ["MyInterface.aidl"], deps = [":parcelable"], ) # Here, ServiceParcelable uses and thus depends on ParcelableService, # when it's compiled, but ParcelableService also uses ServiceParcelable, # which creates a circular dependency. # As a result, these files must be compiled together, in the same android_library. android_library( name = "circular_dependencies", srcs = ["ServiceParcelable.java"], idl_srcs = ["ParcelableService.aidl"], idl_parcelables = ["ServiceParcelable.aidl"], )

Argumentos

Atributos

name
Name; obligatorio

Un nombre único para este destino.

deps
Lista de etiquetas; el valor predeterminado es []
Es la lista de otras bibliotecas con las que se vinculará. Los tipos de bibliotecas permitidos son los siguientes: android_library, java_library con restricción android y cc_library uniendo o produciendo bibliotecas nativas .so para la plataforma de destino de Android.

srcs
Lista de etiquetas; el valor predeterminado es []
La lista de archivos .java o .srcjar que se procesan para crear el destino.
Se compilaron los archivos srcs de tipo .java. Para facilitar la lectura, no es bueno poner el nombre de un archivo de origen .java generado en srcs. En su lugar, coloca el nombre de la regla dependiente en srcs, como se describe a continuación.

Se descomprimen y compilan los archivos srcs de tipo .srcjar. (esto es útil si necesitas generar un conjunto de archivos .java con una extensión genrule o de compilación).

Si se omite srcs, cualquier dependencia especificada en deps se exporta desde esta regla (consulta exportaciones de java_library para obtener más información sobre la exportación de dependencias). Sin embargo, este comportamiento pronto dejará de estar disponible. Intenta no confiar en él.

assets
Lista de etiquetas; el valor predeterminado es []
La lista de elementos que se empaquetarán. Por lo general, es un glob de todos los archivos del directorio assets. También puedes hacer referencia a otras reglas (cualquier regla que produzca archivos) o a archivos exportados en los otros paquetes, siempre que todos esos archivos estén en el directorio assets_dir del paquete correspondiente.

assets_dir
String; el valor predeterminado es ""
Es la cadena que proporciona la ruta de acceso a los archivos en assets. Los pares assets y assets_dir describen los elementos empaquetados y se deben proporcionar ambos atributos o ninguno.

custom_package
String; el valor predeterminado es ""
Es el paquete de Java para el que se generarán fuentes de Java. De forma predeterminada, el paquete se infiere del directorio en el que se encuentra el archivo BUILD que contiene la regla. Puedes especificar otro paquete, pero no es recomendable, ya que puede generar conflictos de ruta de clase con otras bibliotecas que solo se detectarán en el tiempo de ejecución.

enable_data_binding
Booleano; el valor predeterminado es False
Si es verdadera, esta regla procesa expresiones de vinculación de datos en los recursos de diseño incluidos mediante el atributo resource_files. Sin esta configuración, las expresiones de vinculación de datos producen fallas de compilación.
Para compilar una app para Android con vinculación de datos, también debes hacer lo siguiente:

Establece este atributo para todas las reglas de Android que dependan de este de forma transitiva. Esto se debe a que los dependencias heredan las expresiones de vinculación de datos de la regla a través de la combinación de recursos. Por lo tanto, también deben compilar con vinculación de datos para analizar esas expresiones.
Agrega una entrada deps = para la biblioteca del entorno de ejecución de vinculación de datos a todos los destinos que establecen este atributo. La ubicación de esta biblioteca depende de la configuración de tu depósito.

exported_plugins
Lista de etiquetas; el valor predeterminado es []
Es la lista de elementos java_plugin (p.ej., procesadores de anotaciones) para exportar a bibliotecas que dependen directamente de esta biblioteca.
La lista especificada de java_plugin se aplicará a cualquier biblioteca que dependa directamente de ella, como si esta hubiera declarado explícitamente estas etiquetas en plugins.

exports
Lista de etiquetas; el valor predeterminado es []
El cierre de todas las reglas a las que se llega mediante los atributos exports se considera una dependencia directa de cualquier regla que depende directamente del destino con exports.
Los exports no son dependencias directas de la regla a la que pertenecen.

exports_manifest
Número entero; el valor predeterminado es 1
Establece si se deben exportar entradas de manifiesto a destinos android_binary que dependen de este. Los atributos uses-permissions nunca se exportan.

idl_import_root
String; el valor predeterminado es ""
Es la ruta de acceso relativa del paquete a la raíz del árbol de paquetes de Java que contiene las fuentes idl incluidas en esta biblioteca.
Esta ruta se usará como raíz de importación cuando se procesen fuentes inactivas que dependan de esta biblioteca.

Cuando se especifica idl_import_root, tanto idl_parcelables como idl_srcs deben estar en la ruta especificada por el paquete Java del objeto que representan en idl_import_root. Cuando no se especifica idl_import_root, tanto idl_parcelables como idl_srcs deben estar en la ruta que especifica su paquete en una raíz de Java.

Consulta los ejemplos.

idl_parcelables
Lista de etiquetas; el valor predeterminado es []
Lista de definiciones de IDL de Android para proporcionar como importaciones. Estos archivos estarán disponibles como importaciones para cualquier destino android_library que dependa de esta biblioteca, ya sea de forma directa o a través de su cierre transitivo, pero no se traducirán a Java ni se compilarán.
Solo se deben incluir los archivos .aidl que correspondan directamente a las fuentes .java de esta biblioteca (p. ej., implementaciones personalizadas de Parcelable). De lo contrario, debe usarse idl_srcs.

Estos archivos deben estar ubicados correctamente para que el compilador Aidl los encuentre. Consulta la descripción de idl_import_root para obtener información sobre lo que esto significa.

idl_preprocessed
Lista de etiquetas; el valor predeterminado es []
Lista de definiciones de IDL de Android procesadas previamente que se proporcionarán como importaciones. Estos archivos estarán disponibles como importaciones para cualquier destino android_library que dependa de esta biblioteca, ya sea de forma directa o a través de su cierre transitivo, pero no se traducirán a Java ni se compilarán.
Solo se deben incluir los archivos .aidl preprocesados que correspondan directamente a las fuentes .java de esta biblioteca (p. ej., implementaciones personalizadas de Parcelable). De lo contrario, usa idl_srcs para las definiciones de IDL de Android que se deban traducir a interfaces Java y usa idl_parcelable para los archivos AIDL sin procesamiento previo.

idl_srcs
Lista de etiquetas; el valor predeterminado es []
Lista de definiciones de IDL de Android que se traducirán a interfaces de Java. Una vez que se generen las interfaces de Java, se compilarán junto con el contenido de srcs.
Estos archivos estarán disponibles como importaciones para cualquier destino android_library que dependa de esta biblioteca, ya sea de forma directa o a través de su cierre transitivo.

Estos archivos deben estar ubicados correctamente para que el compilador Aidl los encuentre. Consulta la descripción de idl_import_root para obtener información sobre lo que esto significa.

javacopts
Lista de cadenas; el valor predeterminado es []
Opciones de compilador adicionales para este destino. Sujeto a la sustitución "Make variable" y a la asignación de token de shell de Bourne.
Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.

manifest
Etiqueta; el valor predeterminado es None
Es el nombre del archivo de manifiesto de Android, normalmente AndroidManifest.xml. Se debe definir si se definen recursos_archivos o recursos.

neverlink
Booleano; el valor predeterminado es False
Usa esta biblioteca solo para la compilación y no durante el tiempo de ejecución. Los resultados de una regla marcada como neverlink no se usarán en la creación de .apk. Es útil si el entorno de ejecución proporcionará la biblioteca durante la ejecución.

plugins
Lista de etiquetas; el valor predeterminado es []
Complementos de compilador de Java para ejecutarse en el tiempo de compilación. Cada java_plugin especificado en el atributo de complementos se ejecutará cada vez que se compile este destino. Los recursos que genera el complemento se incluirán en el archivo jar de resultados del destino.

proguard_specs
Lista de etiquetas; el valor predeterminado es []
Archivos que se usarán como especificación de ProGuard. Describirán el conjunto de especificaciones que usará ProGuard. Si se especifican, se agregarán a cualquier destino android_binary según esta biblioteca. Los archivos incluidos aquí solo deben tener reglas idempotentes, es decir, -dontnote, -dontwarn, supongan efectos secundarios y reglas que comiencen con -keep. Otras opciones solo pueden aparecer en proguard_specs de android_binary para garantizar las combinaciones no tautológicas.

resource_files
Lista de etiquetas; el valor predeterminado es []
La lista de recursos que se empaquetarán. Por lo general, es un glob de todos los archivos del directorio res.
Las etiquetas también pueden hacer referencia aquí a los archivos generados (desde genrules). La única restricción es que los resultados generados deben estar en el mismo directorio "res" que cualquier otro archivo de recursos incluido.

android_instrumentation_test
Ver el código fuente de la regla
android_instrumentation_test(name, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, licenses, local, restricted_to, shard_count, size, support_apks, tags, target_compatible_with, target_device, test_app, testonly, timeout, toolchains, visibility)

Una regla android_instrumentation_test ejecuta pruebas de instrumentación de Android. Este iniciará un emulador, instalará la aplicación que se está probando, la aplicación de prueba y cualquier otra aplicación necesaria, y ejecutará las pruebas definidas en el paquete de prueba.

El atributo test_app especifica el android_binary que contiene la prueba. Este android_binary, a su vez, especifica la aplicación de android_binary que se está probando a través de su atributo instruments.

Ejemplo

# java/com/samples/hello_world/BUILD android_library( name = "hello_world_lib", srcs = ["Lib.java"], manifest = "LibraryManifest.xml", resource_files = glob(["res/**"]), ) # The app under test android_binary( name = "hello_world_app", manifest = "AndroidManifest.xml", deps = [":hello_world_lib"], )

# javatests/com/samples/hello_world/BUILD android_library( name = "hello_world_test_lib", srcs = ["Tests.java"], deps = [ "//java/com/samples/hello_world:hello_world_lib", ... # test dependencies such as Espresso and Mockito ], ) # The test app android_binary( name = "hello_world_test_app", instruments = "//java/com/samples/hello_world:hello_world_app", manifest = "AndroidManifest.xml", deps = [":hello_world_test_lib"], ) android_instrumentation_test( name = "hello_world_uiinstrumentation_tests", target_device = ":some_target_device", test_app = ":hello_world_test_app", )

Argumentos

Atributos

name
Name; obligatorio

Un nombre único para este destino.

support_apks
Lista de etiquetas; el valor predeterminado es []
Otros APK que se deben instalar en el dispositivo antes de comenzar la prueba de instrumentación.

target_device
Label; obligatorio

Es el elemento android_device en el que se debe ejecutar la prueba.

Para ejecutar la prueba en un emulador que ya se está ejecutando o en un dispositivo físico, usa estos argumentos: --test_output=streamed --test_arg=--device_broker_type=LOCAL_ADB_SERVER --test_arg=--device_serial_number=$device_identifier

test_app
Label; obligatorio
El objetivo android_binary que contiene las clases de prueba El destino android_binary debe especificar qué objetivo está probando mediante su atributo instruments.

android_local_test
Ver el código fuente de la regla
android_local_test(name, deps, srcs, data, args, compatible_with, custom_package, densities, deprecation, enable_data_binding, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, javacopts, jvm_flags, licenses, local, manifest, manifest_values, nocompress_extensions, plugins, resource_configuration_filters, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, shard_count, size, stamp, tags, target_compatible_with, test_class, testonly, timeout, toolchains, use_launcher, visibility)

Esta regla se usa para probar unidades de las reglas android_library de forma local (en lugar de en un dispositivo). Funciona con el framework de pruebas de Robolectric de Android. Consulta el sitio de Android Robolectric para obtener detalles sobre cómo escribir pruebas de Robolectric.

Destinos de salida implícitos

name.jar: Es un archivo Java de la prueba.

name-src.jar: Es un archivo que contiene las fuentes ("jar de origen").

name_deploy.jar: Es un archivo de implementación de Java adecuado para la implementación (solo se compila si se solicita de forma explícita).

Ejemplos

Para usar Robolectric con android_local_test, agrega el repositorio de Robolectric a tu archivo WORKSPACE:
http_archive( name = "robolectric", urls = ["https://github.com/robolectric/robolectric-bazel/archive/<COMMIT>.tar.gz"], strip_prefix = "robolectric-bazel-<COMMIT>", sha256 = "<HASH>", ) load("@robolectric//bazel:robolectric.bzl", "robolectric_repositories") robolectric_repositories()
De esta manera, se extraen las reglas maven_jar necesarias para Robolectric. Luego, cada regla android_local_test debería depender de @robolectric//bazel:robolectric. Consulta el siguiente ejemplo.

android_local_test( name = "SampleTest", srcs = [ "SampleTest.java", ], manifest = "LibManifest.xml", deps = [ ":sample_test_lib", "@robolectric//bazel:android-all", ], ) android_library( name = "sample_test_lib", srcs = [ "Lib.java", ], resource_files = glob(["res/**"]), manifest = "AndroidManifest.xml", )

Argumentos

Atributos

name
Name; obligatorio

Un nombre único para este destino.

deps
Lista de etiquetas; el valor predeterminado es []
La lista de bibliotecas que se probarán, así como las bibliotecas adicionales que se vincularán al destino. Todos los recursos, elementos y archivos de manifiesto declarados en las reglas de Android durante el cierre transitivo de este atributo quedan disponibles en la prueba.
Las listas de reglas permitidas en deps son android_library, aar_import, java_import, java_library y java_lite_proto_library.

srcs
Lista de etiquetas; el valor predeterminado es []
La lista de archivos de origen que se procesan para crear el destino. Obligatorio, excepto en el caso especial que se describe a continuación.
Se compilaron los archivos srcs de tipo .java. Para facilitar la lectura, no es bueno poner el nombre de un archivo de origen .java generado en srcs. En su lugar, coloca el nombre de la regla dependiente en srcs, como se describe a continuación.

Se descomprimen y compilan los archivos srcs de tipo .srcjar. (esto es útil si necesitas generar un conjunto de archivos .java con una extensión genrule o de compilación).

Se ignoran todos los demás archivos, siempre que haya al menos un archivo de uno de los tipos descritos anteriormente. De lo contrario, se genera un error.

El atributo srcs es obligatorio y no puede estar vacío, a menos que se especifique runtime_deps.

custom_package
String; el valor predeterminado es ""
Paquete de Java en el que se generará la clase R. De forma predeterminada, el paquete se infiere del directorio en el que se encuentra el archivo BUILD que contiene la regla. Si usas este atributo, es probable que también debas usar test_class.

densities
Lista de cadenas; el valor predeterminado es []
Densidades que se deben filtrar cuando se compila el APK También se agregará al manifiesto una sección de pantallas compatibles correspondiente si aún no contiene un superconjunto StarlarkListing.

enable_data_binding
Booleano; el valor predeterminado es False
Si es verdadera, esta regla procesa las referencias de vinculación de datos que se usan en las dependencias habilitadas para la vinculación de datos que usa esta prueba. Sin esta configuración, las dependencias de vinculación de datos no tendrán la generación de código a nivel binario necesaria y pueden producir fallas de compilación.

javacopts
Lista de cadenas; el valor predeterminado es []
Opciones de compilador adicionales para esta biblioteca. Sujeto a la sustitución "Make variable" y a la asignación de token de shell de Bourne.
Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.

jvm_flags
Lista de cadenas; el valor predeterminado es []
Una lista de marcas para incorporar en la secuencia de comandos del wrapper generada para ejecutar este objeto binario. Sujeto a la sustitución $(location) y "Make variable", y a la asignación de token de shell de Bourne.
La secuencia de comandos del wrapper para un objeto binario de Java incluye una definición de CLASSPATH (para encontrar todos los archivos jar dependientes) y, además, invoca al intérprete de Java correcto. La línea de comandos que genera la secuencia de comandos del wrapper incluye el nombre de la clase principal seguido de un "$@" para que puedas pasar otros argumentos después del nombre de clase. Sin embargo, los argumentos destinados para el análisis por parte de la JVM se deben especificar antes del nombre de clase en la línea de comandos. El contenido de jvm_flags se agrega a la secuencia de comandos del wrapper antes de que se muestre el nombre de clase.

Ten en cuenta que este atributo no tiene efecto en las salidas *_deploy.jar.

manifest
Etiqueta; el valor predeterminado es None
Es el nombre del archivo de manifiesto de Android, normalmente AndroidManifest.xml. Se debe definir si se definieron recursos_files o assets, o si alguno de los manifiestos de las bibliotecas sometidas a prueba tiene una etiqueta minSdkVersion.

manifest_values
Diccionario: String -> String; el valor predeterminado es {}
Un diccionario de valores que se anularán en el manifiesto. Cualquier instancia de ${name} en el manifiesto se reemplazará por el valor correspondiente al nombre en este diccionario. applicationId, versionCode, versionName, minSdkVersion, targetSdkVersion y maxSdkVersion también anularán los atributos correspondientes del manifiesto y de las etiquetas uses-sdk. packageName se ignorará y se configurará desde applicationId si se especifica o desde el paquete en el manifiesto. No es necesario tener un manifiesto en la regla para usar manifest_values.

nocompress_extensions
Lista de cadenas; el valor predeterminado es []
Una lista de extensiones de archivo que se deben dejar sin comprimir en el APK del recurso.

plugins
Lista de etiquetas; el valor predeterminado es []
Complementos de compilador de Java para ejecutarse en el tiempo de compilación. Cada java_plugin especificado en este atributo se ejecutará cuando se compile esta regla. Una biblioteca también puede heredar complementos de dependencias que usan exported_plugins. Los recursos que genere el complemento se incluirán en el archivo JAR resultante de esta regla.

resource_configuration_filters
Lista de cadenas; el valor predeterminado es []
Una lista de filtros de configuración de recursos, como "en", que limitará los recursos del APK solo a los de la configuración "en".

resource_jars
Lista de etiquetas; el valor predeterminado es []
Obsoleto: usa java_import and deps o runtime_deps.

resource_strip_prefix
String; el valor predeterminado es ""
El prefijo de la ruta de acceso que se quitará de los recursos de Java.
Si se especifica, este prefijo de ruta de acceso se quita de cada archivo en el atributo resources. Es un error que un archivo de recursos no esté en este directorio. Si no se especifica (el valor predeterminado), la ruta del archivo de recursos se determina según la misma lógica que el paquete de Java de los archivos fuente. Por ejemplo, un archivo de origen en stuff/java/foo/bar/a.txt se ubicará en foo/bar/a.txt.

runtime_deps
Lista de etiquetas; el valor predeterminado es []
Bibliotecas que estarán disponibles para el objeto binario final o que se prueben solo en el tiempo de ejecución. Al igual que los deps comunes, estos aparecerán en la ruta de clase del tiempo de ejecución, pero, a diferencia de ellos, no en la del tiempo de compilación. Las dependencias que se necesitan solo en el entorno de ejecución deben enumerarse aquí. Las herramientas de análisis de dependencias deben ignorar los objetivos que aparecen en runtime_deps y deps.

stamp
Número entero; el valor predeterminado es 0
Establece si se debe codificar información de compilación en el objeto binario. Valores posibles:

stamp = 1: Siempre marca la información de la compilación en el objeto binario, incluso en compilaciones de --nostamp. Se debe evitar esta configuración, ya que es posible que elimine el almacenamiento en caché remoto del objeto binario y cualquier acción descendente que dependa de él.

stamp = 0: Siempre reemplaza la información de compilación por valores constantes. Esto brinda un buen almacenamiento en caché de resultados de compilación.

stamp = -1: La marca --[no]stamp controla la incorporación de la información de compilación.

Los objetos binarios sellados no se vuelven a compilar, a menos que cambien sus dependencias.

test_class
String; el valor predeterminado es ""
La clase Java que cargará el ejecutor de pruebas.

Este atributo especifica el nombre de una clase Java que ejecutará esta prueba. No es común establecer esta configuración. Si se omite este argumento, se usará la clase Java cuyo nombre corresponde al name de esta regla android_local_test. La clase de prueba debe tener anotaciones org.junit.runner.RunWith.

use_launcher
Booleano; el valor predeterminado es True
Indica si el objeto binario debe usar un selector personalizado.
Si este atributo se establece en falso, el atributo launcher y la marca --java_launcher relacionada se ignorarán para este destino.

android_device
Ver el código fuente de la regla
android_device(name, cache, compatible_with, default_properties, deprecation, distribs, exec_compatible_with, exec_properties, features, horizontal_resolution, licenses, platform_apks, ram, restricted_to, screen_density, system_image, tags, target_compatible_with, testonly, vertical_resolution, visibility, vm_heap)

Esta regla crea un Android Emulator configurado con las especificaciones determinadas. Este emulador se puede iniciar mediante un comando de ejecución de Bazel o ejecutando directamente la secuencia de comandos generada. Se recomienda que dependas de las reglas existentes de android_device, en lugar de definir las tuyas.

Esta regla es un destino adecuado para que la marca --run_under realice pruebas de Bazel y Blaze. Inicia un emulador, copia el destino que se está probando o ejecuta en el emulador y lo prueba o lo ejecuta según corresponda.

android_device admite la creación de imágenes de KVM si la system_image subyacente se basa en X86 y está optimizada para la arquitectura de CPU I686 como máximo. Para usar KVM, agrega tags = ['requires-kvm'] a la regla android_device.

Destinos de salida implícitos

name_images/userdata.dat: Contiene instantáneas y archivos de imagen para iniciar el emulador.

name_images/emulator-meta-data.pb: Contiene información serializada necesaria para pasar al emulador para reiniciarlo.

Ejemplos

En el siguiente ejemplo, se muestra la manera de usar android_device. //java/android/helloandroid/BUILD contiene

android_device( name = "nexus_s", cache = 32, default_properties = "nexus_s.properties", horizontal_resolution = 480, ram = 512, screen_density = 233, system_image = ":emulator_images_android_16_x86", vertical_resolution = 800, vm_heap = 32, ) filegroup( name = "emulator_images_android_16_x86", srcs = glob(["androidsdk/system-images/android-16/**"]), )

//java/android/helloandroid/nexus_s.properties contiene lo siguiente:

ro.product.brand=google ro.product.device=crespo ro.product.manufacturer=samsung ro.product.model=Nexus S ro.product.name=soju

Esta regla generará imágenes y una secuencia de comandos de inicio. Puedes iniciar el emulador de forma local ejecutando bazel run :nexus_s -- --action=start. La secuencia de comandos expone las siguientes marcas:

--adb_port: Es el puerto en el que se debe exponer adb. Si deseas emitir comandos adb al emulador, este es el puerto al que se conectará adb.

--emulator_port: Es el puerto en el que se expone la consola de administración Telnet del emulador.

--enable_display: Inicia el emulador con una pantalla si es verdadero (el valor predeterminado es falso).

--action: Comienza o termina.

--apks_to_install: Una lista de APK para instalar en el emulador.

Argumentos

Atributos

name
Name; obligatorio

Un nombre único para este destino.

cache
Número entero; obligatorio
Es el tamaño en megabytes de la partición de caché del emulador. El valor mínimo es de 16 megabytes.

default_properties
Etiqueta; el valor predeterminado es None
Se debe colocar un único archivo de propiedades en /default.prop en el emulador. Esto permite que el autor de la regla configure aún más el emulador para que se vea más como un dispositivo real (en particular, controlando sus cadenas de UserAgent y otros comportamientos que podrían hacer que una aplicación o un servidor se comporten de manera diferente con un dispositivo específico). Las propiedades de este archivo anularán las propiedades de solo lectura que suele establecer el emulador, como ro.product.model.

horizontal_resolution
Número entero; obligatorio
Es la resolución horizontal de la pantalla en píxeles para emular. El valor mínimo es 240.

platform_apks
Lista de etiquetas; el valor predeterminado es []
Una lista de los APK que se instalarán en el dispositivo al momento del inicio.

ram
Número entero; obligatorio
Es la cantidad de RAM en megabytes que se emulará para el dispositivo. Esto es para todo el dispositivo, no solo para una app específica instalada en él. El valor mínimo es 64 megabytes.

screen_density
Número entero; obligatorio
Es la densidad de la pantalla emulada en píxeles por pulgada. El valor mínimo es de 30 ppp.

system_image
Label; obligatorio
Un grupo de archivos que contiene los siguientes archivos:

system.img: La partición del sistema

kernel-qemu: Es el kernel de Linux que cargará el emulador.

ramdisk.img: La imagen initrd que se usará en el inicio

userdata.img: La partición inicial userdata

source.properties: Es un archivo de propiedades que contiene información sobre las imágenes.

Estos archivos son parte del SDK de Android o los proporcionan terceros (por ejemplo, Intel proporciona imágenes x86).

vertical_resolution
Número entero; obligatorio
Es la resolución de pantalla vertical en píxeles que se emula. El valor mínimo es 240.

vm_heap
Número entero; obligatorio
Es el tamaño en megabytes del montón de máquina virtual que usará Android para cada proceso. El valor mínimo es 16 megabytes.

android_ndk_repository
Ver el código fuente de la regla
android_ndk_repository(name, api_level, path, repo_mapping)

Configura Bazel para que use un NDK de Android y admita la compilación de destinos de Android con código nativo.
Ten en cuenta que esta implementación de android_ndk_repository se reemplazará por una implementación en Starlark. Se implementará la compatibilidad con versiones futuras del NDK, incluidas la versión 25 y posteriores, en la versión de Starlark de android_ndk_repository. Consulta rules_android_ndk para la versión de Starlark.
Ten en cuenta que compilar para Android también requiere una regla android_sdk_repository en tu archivo WORKSPACE.
Para obtener más información, lee la documentación completa sobre el uso del NDK de Android con Bazel.

Ejemplos

android_ndk_repository( name = "androidndk", )

En el ejemplo anterior, se ubicará tu NDK de Android en $ANDROID_NDK_HOME y se detectará el nivel de API más alto que admite.
android_ndk_repository( name = "androidndk", path = "./android-ndk-r20", api_level = 24, )

En el ejemplo anterior, se usará el NDK de Android ubicado dentro de tu lugar de trabajo en ./android-ndk-r20. Utilizará las bibliotecas de nivel de API 24 cuando compile tu código JNI.
funciones de CPU

El NDK de Android contiene la biblioteca de cpufeatures, que se puede usar para detectar la CPU de un dispositivo durante el tiempo de ejecución. En el siguiente ejemplo, se muestra cómo usar cpufeatures con Bazel.
# jni.cc #include "ndk/sources/android/cpufeatures/cpu-features.h" ...

# BUILD cc_library( name = "jni", srcs = ["jni.cc"], deps = ["@androidndk//:cpufeatures"], )

Argumentos

Atributos

name
Name; obligatorio

Un nombre único para este destino.

api_level
Número entero; no configurable; el valor predeterminado es 0
Nivel de API de Android con el cual compilar. Si no se especifica, se usará el nivel de API más alto instalado.

path
String; no configurable; el valor predeterminado es ""
Una ruta de acceso absoluta o relativa a un NDK de Android. Se debe configurar este atributo o la variable de entorno $ANDROID_NDK_HOME.
El NDK de Android se puede descargar desde el sitio para desarrolladores de Android .

repo_mapping
Diccionario: String -> String; el valor predeterminado es {}
Un diccionario que va del nombre del repositorio local al nombre del repositorio global. Esto permite controlar la resolución de dependencias de lugares de trabajo para las dependencias de este repositorio.
Por ejemplo, una entrada "@foo": "@bar" declara que, en cualquier momento en que este repositorio dependa de "@foo" (como una dependencia de "@foo//some:target"), en realidad debería resolver esa dependencia dentro de "@bar" declarado de manera global ("@bar//some:target").

android_sdk_repository
Ver el código fuente de la regla
android_sdk_repository(name, api_level, build_tools_version, path, repo_mapping)

Configura Bazel para que use un SDK de Android local para admitir la compilación de destinos de Android.

Ejemplos
El mínimo para configurar un SDK de Android para Bazel es colocar una regla android_sdk_repository llamada "androidsdk" en el archivo WORKSPACE y establecer la variable de entorno $ANDROID_HOME en la ruta de acceso de tu SDK de Android. Bazel usará el nivel de API de Android más alto y la versión de herramientas de compilación instalada en el SDK de Android de forma predeterminada.
android_sdk_repository( name = "androidsdk", )

Para garantizar compilaciones reproducibles, se pueden establecer los atributos path, api_level y build_tools_version en valores específicos. La compilación fallará si el SDK de Android no tiene instalado el nivel de API especificado o la versión de las herramientas de compilación.
android_sdk_repository( name = "androidsdk", path = "./sdk", api_level = 19, build_tools_version = "25.0.0", )

En el ejemplo anterior, también se demuestra el uso de una ruta de acceso relativa del espacio de trabajo al SDK de Android. Esto es útil si el SDK de Android forma parte de tu lugar de trabajo de Bazel (p.ej., si está marcado en el control de versión).
Bibliotecas de compatibilidad

Las bibliotecas de compatibilidad están disponibles en SDK Manager de Android como "Repositorio de compatibilidad de Android". Este es un conjunto de versiones de bibliotecas comunes de Android, como las bibliotecas de compatibilidad y AppCompat, que se empaquetan como un repositorio local de Maven. android_sdk_repository genera destinos de Bazel para cada una de estas bibliotecas que se pueden usar en las dependencias de los destinos android_binary y android_library.
Los nombres de los destinos generados derivan de las coordenadas de Maven de las bibliotecas del repositorio de compatibilidad de Android, con el formato @androidsdk//${group}:${artifact}-${version}. En el siguiente ejemplo, se muestra cómo un android_library puede depender de la versión 25.0.0 de la biblioteca appcompat v7.
android_library( name = "lib", srcs = glob(["*.java"]), manifest = "AndroidManifest.xml", resource_files = glob(["res/**"]), deps = ["@androidsdk//com.android.support:appcompat-v7-25.0.0"], )

Argumentos

Atributos

name
Name; obligatorio

Un nombre único para este destino.

api_level
Número entero; no configurable; el valor predeterminado es 0
Es el nivel de API de Android en el que se realizará la compilación de forma predeterminada. Si no se especifica, se usará el nivel de API más alto instalado.
El nivel de API que se usa para una compilación determinada se puede anular con la marca android_sdk. android_sdk_repository crea un destino android_sdk para cada nivel de API instalado en el SDK con el nombre @androidsdk//:sdk-${level}, independientemente de si se especifica este atributo o no. Por ejemplo, para compilar con un nivel de API no predeterminado: bazel build --android_sdk=@androidsdk//:sdk-19 //java/com/example:app.
Para ver todos los destinos de android_sdk generados por android_sdk_repository, puedes ejecutar bazel query "kind(android_sdk, @androidsdk//...)".

build_tools_version
String; no configurable; el valor predeterminado es ""
Es la versión de las herramientas de compilación de Android que se usarán desde el SDK de Android. Si no se especifica, se usará la última versión instalada de las herramientas de compilación.
Bazel requiere la versión 30.0.0 o posterior de las herramientas de compilación.

path
String; no configurable; el valor predeterminado es ""
Una ruta de acceso absoluta o relativa a un SDK de Android. Se debe configurar este atributo o la variable de entorno $ANDROID_HOME.
El SDK de Android se puede descargar desde el sitio para desarrolladores de Android.

repo_mapping
Diccionario: String -> String; el valor predeterminado es {}
Un diccionario que va del nombre del repositorio local al nombre del repositorio global. Esto permite controlar la resolución de dependencias de lugares de trabajo para las dependencias de este repositorio.
Por ejemplo, una entrada "@foo": "@bar" declara que, en cualquier momento en que este repositorio dependa de "@foo" (como una dependencia de "@foo//some:target"), en realidad debería resolver esa dependencia dentro de "@bar" declarado de manera global ("@bar//some:target").

Atributos
`name`	Name; obligatorio Un nombre único para este destino.
`deps`	Lista de etiquetas; el valor predeterminado es `[]` Es la lista de otras bibliotecas que se vincularán al objetivo binario. Los tipos de bibliotecas permitidos son los siguientes: `android_library`, `java_library` con restricción `android` y `cc_library` uniendo o produciendo bibliotecas nativas `.so` para la plataforma de destino de Android.
`srcs`	Lista de etiquetas; el valor predeterminado es `[]` La lista de archivos de origen que se procesan para crear el destino. Se compilaron los archivos `srcs` de tipo `.java`. Para facilitar la lectura, no es bueno poner el nombre de un archivo de origen `.java` generado en `srcs`. En su lugar, coloca el nombre de la regla dependiente en `srcs`, como se describe a continuación. Se descomprimen y compilan los archivos `srcs` de tipo `.srcjar`. (esto es útil si necesitas generar un conjunto de archivos .java con una extensión genrule o de compilación).
`assets`	Lista de etiquetas; el valor predeterminado es `[]` La lista de elementos que se empaquetarán. Por lo general, es un `glob` de todos los archivos del directorio `assets`. También puedes hacer referencia a otras reglas (cualquier regla que produzca archivos) o a archivos exportados en los otros paquetes, siempre que todos esos archivos estén en el directorio `assets_dir` del paquete correspondiente.
`assets_dir`	String; el valor predeterminado es `""` Es la cadena que proporciona la ruta de acceso a los archivos en `assets`. Los pares `assets` y `assets_dir` describen los elementos empaquetados y se deben proporcionar ambos atributos o ninguno.
`crunch_png`	Booleano; el valor predeterminado es `True` Haz procesamiento de PNG (o no). Esto es independiente del procesamiento de nine-patch, que siempre se realiza. Esta es una solución obsoleta para un error de aapt que se corrigió en aapt2.
`custom_package`	String; el valor predeterminado es `""` Es el paquete de Java para el que se generarán fuentes de Java. De forma predeterminada, el paquete se infiere del directorio en el que se encuentra el archivo BUILD que contiene la regla. Puedes especificar otro paquete, pero no es recomendable, ya que puede generar conflictos de ruta de clase con otras bibliotecas que solo se detectarán en el tiempo de ejecución.
`debug_key`	Etiqueta; el valor predeterminado es `"@bazel_tools//tools/android:debug_keystore"` Archivo que contiene el almacén de claves de depuración que se usará para firmar el APK de depuración. Por lo general, no querrás usar una clave que no sea la predeterminada, por lo que debes omitir este atributo. ADVERTENCIA: No uses las claves de producción, ya que deben protegerlas de manera estricta y no deben guardarse en el árbol de fuentes.
`debug_signing_keys`	Lista de etiquetas; el valor predeterminado es `[]` Lista de archivos y almacenes de claves de depuración que se usarán para firmar el APK de depuración. Por lo general, no quieres usar claves que no sean la predeterminada, por lo que debes omitir este atributo. ADVERTENCIA: No uses las claves de producción, ya que deben protegerlas de manera estricta y no deben guardarse en el árbol de fuentes.
`debug_signing_lineage_file`	Etiqueta; el valor predeterminado es `None` Archivo que contiene el linaje de firma de debug_signature_keys. Por lo general, no quieres usar claves que no sean la predeterminada, por lo que debes omitir este atributo. ADVERTENCIA: No uses las claves de producción, ya que deben protegerlas de manera estricta y no deben guardarse en el árbol de fuentes.
`densities`	Lista de cadenas; el valor predeterminado es `[]` Densidades que se deben filtrar cuando se compila el APK Para reducir el tamaño del APK, se quitarán los recursos de elementos de diseño de trama que no se cargarían en un dispositivo con las densidades de pantalla especificadas. También se agregará al manifiesto una sección de pantallas compatibles correspondiente si aún no contiene una ficha de superconjunto.
`dex_shards`	Número entero; el valor predeterminado es `1` La cantidad de fragmentos para la conversión a DEX. Esto hace que la conversión a DEX sea mucho más rápida a expensas del tiempo de instalación y de inicio de la app. Cuanto más grande sea el objeto binario, más fragmentos se deberían usar. 25 es un buen valor para comenzar a experimentar. Ten en cuenta que cada fragmento generará al menos un archivo DEX en la app final. Por este motivo, no se recomienda configurarlo en más de 1 para los objetos binarios de lanzamiento.
`dexopts`	Lista de cadenas; el valor predeterminado es `[]` Marcas de línea de comandos adicionales para la herramienta dx al generar classes.dex. Sujeto a la sustitución "Make variable" y a la asignación de token de shell de Bourne.
`enable_data_binding`	Booleano; el valor predeterminado es `False` Si es verdadera, esta regla procesa expresiones de vinculación de datos en los recursos de diseño incluidos mediante el atributo resource_files. Sin esta configuración, las expresiones de vinculación de datos producen fallas de compilación. Para compilar una app para Android con vinculación de datos, también debes hacer lo siguiente: Establece este atributo para todas las reglas de Android que dependan de este de forma transitiva. Esto se debe a que los dependencias heredan las expresiones de vinculación de datos de la regla a través de la combinación de recursos. Por lo tanto, también deben compilar con vinculación de datos para analizar esas expresiones. Agrega una entrada `deps =` para la biblioteca del entorno de ejecución de vinculación de datos a todos los destinos que establecen este atributo. La ubicación de esta biblioteca depende de la configuración de tu depósito.
`incremental_dexing`	Número entero; no configurable; el valor predeterminado es `-1` Fuerza la compilación del destino con o sin la conversión a DEX incremental, anulando los valores predeterminados y la marca --incremental_dexing.
`instruments`	Etiqueta; el valor predeterminado es `None` Es el objetivo `android_binary` que se debe instrumentar. Si se configura este atributo, este `android_binary` se tratará como una aplicación de prueba para pruebas de instrumentación. Un destino `android_instrumentation_test` puede especificar este objetivo en su atributo test_app.
`javacopts`	Lista de cadenas; el valor predeterminado es `[]` Opciones de compilador adicionales para este destino. Sujeto a la sustitución "Make variable" y a la asignación de token de shell de Bourne. Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.
`key_rotation_min_sdk`	String; el valor predeterminado es `""` Establece la versión mínima de la plataforma de Android (nivel de API) para la que se debe usar la clave de firma rotada de un APK para producir la firma del APK. La clave de firma original del APK se usará en todas las versiones anteriores de la plataforma.
`main_dex_list`	Etiqueta; el valor predeterminado es `None` Un archivo de texto contiene una lista de nombres de archivos de clase. Las clases definidas por esos archivos de clase se colocan en el archivo classes.dex primario, p. ej.: android/support/multidex/MultiDex$V19.class android/support/multidex/MultiDex.class android/support/multidex/MultiDexApplication.class com/google/common/base/Objects.class Se debe usar con `multidex="manual_main_dex"`.
`main_dex_list_opts`	Lista de cadenas; el valor predeterminado es `[]` Opciones de línea de comandos para pasar al compilador de listas dex principal. Usa esta opción para modificar las clases incluidas en la lista principal de DEX.
`main_dex_proguard_specs`	Lista de etiquetas; el valor predeterminado es `[]` Archivos que se usarán como especificaciones de ProGuard para determinar las clases que se deben mantener en el DEX principal. Solo se permite si el atributo `multidex` se establece en `legacy`.
`manifest`	Label; obligatorio Es el nombre del archivo de manifiesto de Android, normalmente `AndroidManifest.xml`. Se debe definir si se definen recursos_archivos o recursos.
`manifest_values`	Diccionario: String -> String; el valor predeterminado es `{}` Un diccionario de valores que se anularán en el manifiesto. Cualquier instancia de `${name}` en el manifiesto se reemplazará por el valor correspondiente al nombre en este diccionario. `applicationId`, `versionCode`, `versionName`, `minSdkVersion`, `targetSdkVersion` y `maxSdkVersion` también anularán los atributos correspondientes del manifiesto y las etiquetas `uses-sdk`. `packageName` se ignorará y se configurará desde `applicationId` si se especifica o desde el paquete en el manifiesto. Cuando `manifest_merger` se configura como `legacy`, solo `applicationId`, `versionCode` y `versionName` tendrán efecto.
`multidex`	String; el valor predeterminado es `"native"` Indica si se debe dividir el código en varios archivos dex. Valores posibles: `native`: Divide el código en varios archivos dex cuando se supera el límite del índice dex 64K. Se supone que la plataforma es compatible con la plataforma nativa para cargar clases de multidex durante el tiempo de ejecución. Solo funciona con Android L y versiones posteriores. `legacy`: Divide el código en varios archivos dex cuando se supera el límite del índice dex 64K. Supone que las clases de multidex se cargan a través del código de la aplicación (es decir, sin compatibilidad con plataformas nativas). `manual_main_dex`: Divide el código en varios archivos dex cuando se supera el límite del índice dex 64K. Se debe especificar el contenido del archivo dex principal proporcionando una lista de clases en un archivo de texto con el atributo main_dex_list. `off`: Compila todo el código en un solo archivo dex, incluso si se excede el límite de índice.
`nocompress_extensions`	Lista de cadenas; el valor predeterminado es `[]` Una lista de extensiones de archivo que se deben dejar sin comprimir en el APK.
`package_id`	Número entero; el valor predeterminado es `0` El ID del paquete que se asignará a los recursos en este objeto binario. Para obtener más información, consulta el argumento `--package-id` de AAPT2. Por lo general, no se puede establecer (y se debe) configurar, lo que da como resultado el valor predeterminado de 127 (`0x7F`).
`plugins`	Lista de etiquetas; el valor predeterminado es `[]` Complementos de compilador de Java para ejecutarse en el tiempo de compilación. Cada `java_plugin` especificado en el atributo de complementos se ejecutará cada vez que se compile este destino. Los recursos que genera el complemento se incluirán en el archivo jar de resultados del destino.
`proguard_apply_dictionary`	Etiqueta; el valor predeterminado es `None` Es el archivo que se usará como asignación para ProGuard. Un archivo de "palabras" separado por líneas para extraer cuando se cambia el nombre de las clases y los miembros durante la ofuscación.
`proguard_apply_mapping`	Etiqueta; el valor predeterminado es `None` Es el archivo que se usará como asignación para ProGuard. Un archivo de asignación generado por `proguard_generate_mapping` que se volverá a usar para aplicar la misma asignación a una compilación nueva.
`proguard_generate_mapping`	Booleano; no configurable; el valor predeterminado es `False` Indica si se debe generar un archivo de asignación de ProGuard. El archivo de asignación solo se generará si se especifica `proguard_specs`. Este archivo mostrará la asignación entre los nombres de las clases, los métodos y los campos originales y ofuscados. ADVERTENCIA: Si se usa este atributo, la especificación de ProGuard no debería contener `-dontobfuscate` ni `-printmapping`.
`proguard_specs`	Lista de etiquetas; el valor predeterminado es `[]` Archivos que se usarán como especificación de ProGuard. Ese archivo describirá el conjunto de especificaciones que usará ProGuard.
`resource_configuration_filters`	Lista de cadenas; el valor predeterminado es `[]` Una lista de filtros de configuración de recursos, como "en", que limitará los recursos del APK solo a los de la configuración "en". Para habilitar la pseudolocalización, incluye las pseudoconfiguraciones regionales `en_XA` o `ar_XB`.
`resource_files`	Lista de etiquetas; el valor predeterminado es `[]` La lista de recursos que se empaquetarán. Por lo general, es un `glob` de todos los archivos del directorio `res`. Las etiquetas también pueden hacer referencia aquí a los archivos generados (desde genrules). La única restricción es que los resultados generados deben estar en el mismo directorio "`res`" que cualquier otro archivo de recursos incluido.
`shrink_resources`	Número entero; el valor predeterminado es `-1` Establece si se deben reducir los recursos. Se quitarán del APK los recursos que no utilice el objeto binario. Esto solo es compatible con reglas que usan recursos locales (es decir, los atributos `manifest` y `resource_files`) y requiere ProGuard. Funciona casi de la misma manera que el reductor de recursos de Gradle (https://developer.android.com/studio/build/shrink-code.html#shrink-resources). Diferencias destacadas: Se quitarán los recursos en `values/` y los recursos basados en archivos usa `strict mode` de forma predeterminada quitar recursos de ID sin usar solo es compatible con aapt2 Si se habilita la reducción de recursos, también se generará `name_files/resource_shrinker.log`, en la que se detallarán el análisis y las eliminaciones realizadas. Valores posibles: `shrink_resources = 1`: Activa la reducción de recursos de Android. `shrink_resources = 0`: Desactiva la reducción de recursos de Android. `shrink_resources = -1`: La reducción se controla con la marca --android_resource_shrinking.

Atributos
`name`	Name; obligatorio Un nombre único para este destino.
`aar`	Label; obligatorio El archivo `.aar` que se debe proporcionar a los destinos de Android que dependen de este.
`exports`	Lista de etiquetas; el valor predeterminado es `[]` Destinos para exportar a reglas que dependen de esta regla. Consulta java_library.exports.
`srcjar`	Etiqueta; el valor predeterminado es `None` Un archivo JAR que contiene el código fuente para los archivos JAR compilados en el AAR.

Atributos
`name`	Name; obligatorio Un nombre único para este destino.
`support_apks`	Lista de etiquetas; el valor predeterminado es `[]` Otros APK que se deben instalar en el dispositivo antes de comenzar la prueba de instrumentación.
`target_device`	Label; obligatorio Es el elemento android_device en el que se debe ejecutar la prueba. Para ejecutar la prueba en un emulador que ya se está ejecutando o en un dispositivo físico, usa estos argumentos: `--test_output=streamed --test_arg=--device_broker_type=LOCAL_ADB_SERVER --test_arg=--device_serial_number=$device_identifier`
`test_app`	Label; obligatorio El objetivo android_binary que contiene las clases de prueba El destino `android_binary` debe especificar qué objetivo está probando mediante su atributo `instruments`.

Atributos
`name`	Name; obligatorio Un nombre único para este destino.
`cache`	Número entero; obligatorio Es el tamaño en megabytes de la partición de caché del emulador. El valor mínimo es de 16 megabytes.
`default_properties`	Etiqueta; el valor predeterminado es `None` Se debe colocar un único archivo de propiedades en /default.prop en el emulador. Esto permite que el autor de la regla configure aún más el emulador para que se vea más como un dispositivo real (en particular, controlando sus cadenas de UserAgent y otros comportamientos que podrían hacer que una aplicación o un servidor se comporten de manera diferente con un dispositivo específico). Las propiedades de este archivo anularán las propiedades de solo lectura que suele establecer el emulador, como ro.product.model.
`horizontal_resolution`	Número entero; obligatorio Es la resolución horizontal de la pantalla en píxeles para emular. El valor mínimo es 240.
`platform_apks`	Lista de etiquetas; el valor predeterminado es `[]` Una lista de los APK que se instalarán en el dispositivo al momento del inicio.
`ram`	Número entero; obligatorio Es la cantidad de RAM en megabytes que se emulará para el dispositivo. Esto es para todo el dispositivo, no solo para una app específica instalada en él. El valor mínimo es 64 megabytes.
`screen_density`	Número entero; obligatorio Es la densidad de la pantalla emulada en píxeles por pulgada. El valor mínimo es de 30 ppp.
`system_image`	Label; obligatorio Un grupo de archivos que contiene los siguientes archivos: system.img: La partición del sistema kernel-qemu: Es el kernel de Linux que cargará el emulador. ramdisk.img: La imagen initrd que se usará en el inicio userdata.img: La partición inicial userdata source.properties: Es un archivo de propiedades que contiene información sobre las imágenes. Estos archivos son parte del SDK de Android o los proporcionan terceros (por ejemplo, Intel proporciona imágenes x86).
`vertical_resolution`	Número entero; obligatorio Es la resolución de pantalla vertical en píxeles que se emula. El valor mínimo es 240.
`vm_heap`	Número entero; obligatorio Es el tamaño en megabytes del montón de máquina virtual que usará Android para cada proceso. El valor mínimo es 16 megabytes.

Atributos
`name`	Name; obligatorio Un nombre único para este destino.
`api_level`	Número entero; no configurable; el valor predeterminado es `0` Nivel de API de Android con el cual compilar. Si no se especifica, se usará el nivel de API más alto instalado.
`path`	String; no configurable; el valor predeterminado es `""` Una ruta de acceso absoluta o relativa a un NDK de Android. Se debe configurar este atributo o la variable de entorno `$ANDROID_NDK_HOME`. El NDK de Android se puede descargar desde el sitio para desarrolladores de Android .
`repo_mapping`	Diccionario: String -> String; el valor predeterminado es `{}` Un diccionario que va del nombre del repositorio local al nombre del repositorio global. Esto permite controlar la resolución de dependencias de lugares de trabajo para las dependencias de este repositorio. Por ejemplo, una entrada `"@foo": "@bar"` declara que, en cualquier momento en que este repositorio dependa de `"@foo"` (como una dependencia de `"@foo//some:target"`), en realidad debería resolver esa dependencia dentro de `"@bar"` declarado de manera global (`"@bar//some:target"`).