Reglas de Android

Nocturno · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.7

Reglas

android_binary

Ver la 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 paquete de aplicación para Android (.apk).

Objetivos de salida implícitos

  • name.apk: Es un archivo de paquete de aplicación para Android firmado con claves de depuración y alineado con zip que se puede usar para desarrollar y depurar tu aplicación. No puedes lanzar tu aplicación si está firmada con las claves de depuración.
  • name_unsigned.apk: Es una versión sin firmar del archivo anterior que se podría firmar con las claves de lanzamiento antes de que se lance al público.
  • name_deploy.jar: Es un archivo 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 en la ruta de acceso de clases del tiempo de ejecución de este destino de principio a fin.

  • name_proguard.jar: Es un archivo Java que contiene el resultado de ejecutar ProGuard en name_deploy.jar. Este resultado solo se produce si se especifica el atributo proguard_specs.
  • name_proguard.map: Es un archivo de asignación que resulta de ejecutar ProGuard en name_deploy.jar. Este resultado solo se produce si se especifica el atributo proguard_specs y se configuran 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

Nombre: Obligatorio

Es 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 destino binario. Los tipos de bibliotecas permitidos son: android_library, java_library con restricción android y cc_library que encapsula o produce bibliotecas nativas .so para la plataforma de destino de Android.
srcs

Lista de etiquetas. El valor predeterminado es [].

Es la lista de archivos fuente que se procesan para crear el destino.

Se compilan los archivos srcs de tipo .java. Para facilitar la lectura, no es recomendable colocar el nombre de un archivo fuente .java generado en el srcs. En su lugar, coloca el nombre de la regla de la que depende en srcs, como se describe a continuación.

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

assets

Lista de etiquetas. El valor predeterminado es [].

Lista de recursos que se incluirán en el paquete. Por lo general, se trata de un glob de todos los archivos del directorio assets. También puedes hacer referencia a otras reglas (cualquier regla que genere archivos) o a archivos exportados en los otros paquetes, siempre y cuando todos esos archivos se encuentren en el directorio assets_dir del paquete correspondiente.
assets_dir

Cadena. El valor predeterminado es "".

Es la cadena que proporciona la ruta de acceso a los archivos en assets. El par assets y assets_dir describen los recursos empaquetados, y se deben proporcionar ambos atributos o ninguno de ellos.
crunch_png

Booleano; el valor predeterminado es True

Comprime archivos PNG (o no). Esto es independiente del procesamiento de nueve parches, que siempre se realiza. Esta es una solución alternativa obsoleta para un error de aapt que se corrigió en aapt2.
custom_package

Cadena. El valor predeterminado es "".

Es el paquete Java para el que se generarán los códigos fuente Java. De forma predeterminada, el paquete se infiere del directorio en el que se encuentra el archivo BUILD que contiene la regla. Puedes especificar un paquete diferente, pero esto no se recomienda, ya que puede generar conflictos en la ruta de acceso 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 este atributo debe omitirse.

ADVERTENCIA: No uses tus claves de producción. Deben protegerse estrictamente y no almacenarse en tu árbol fuente.
debug_signing_keys

Lista de etiquetas. El valor predeterminado es [].

Es la 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 querrás usar claves que no sean la predeterminada, por lo que este atributo debe omitirse.

ADVERTENCIA: No uses tus claves de producción. Deben protegerse estrictamente y no almacenarse en tu árbol fuente.
debug_signing_lineage_file

Etiqueta: El valor predeterminado es None.

Es el archivo que contiene el linaje de firma de debug_signing_keys. Por lo general, no querrás usar claves que no sean la predeterminada, por lo que este atributo debe omitirse.

ADVERTENCIA: No uses tus claves de producción. Deben protegerse estrictamente y no almacenarse en tu árbol fuente.
densities

Lista de cadenas; el valor predeterminado es []

Son las densidades por las que se filtrará al compilar el APK. Esto quitará los recursos de elementos gráficos rasterizados que no cargaría un dispositivo con las densidades de pantalla especificadas para reducir el tamaño del APK. También se agregará una sección compatible-screens correspondiente al manifiesto si aún no contiene un listado de superconjunto.
dex_shards

Número entero; el valor predeterminado es 1

Cantidad de fragmentos en los que se debe descomponer el dexing. Esto hace que el proceso de dexing sea mucho más rápido a expensas del tiempo de inicio y de instalación de la app. Cuanto más grande sea el archivo binario, más fragmentos se deben 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 establecer este valor en más de 1 para los archivos binarios de lanzamiento.

dexopts

Lista de cadenas; el valor predeterminado es []

Marcas de línea de comandos adicionales para la herramienta dx cuando se genera classes.dex. Sujeto a la sustitución de "Make variable" y la tokenización de Bourne shell.
enable_data_binding

Booleano; el valor predeterminado es False

Si es verdadero, esta regla procesa las expresiones de vinculación de datos en los recursos de diseño incluidos a través del atributo resource_files. Sin este parámetro de configuración, las expresiones de vinculación de datos producen errores de compilación.

Para compilar una app para Android con vinculación de datos, también debes hacer lo siguiente:

  1. Establece este atributo para todas las reglas de Android que dependen de esta de forma transitiva. Esto se debe a que los elementos dependientes 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.
  2. Agrega una entrada deps = para la biblioteca de tiempo de ejecución de la vinculación de datos a todos los destinos que establezcan este atributo. La ubicación de esta biblioteca depende de la configuración del depósito.
incremental_dexing

Número entero; no configurable; el valor predeterminado es -1

Fuerza la compilación del destino con o sin dexing incremental, anulando los valores predeterminados y la marca --incremental_dexing.
instruments

Etiqueta: El valor predeterminado es None.

Es el objetivo de android_binary para la instrumentación.

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

javacopts

Lista de cadenas; el valor predeterminado es []

Son opciones de compilador adicionales para este destino. Sujeto a la sustitución de "Make variable" y la tokenización de Bourne shell.

Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.
key_rotation_min_sdk

Cadena. El valor predeterminado es "".

Establece la versión mínima de la plataforma 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 principal. Por ejemplo:
          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 []

Son las opciones de línea de comandos que se pasarán al compilador de la lista de dex principal. Usa esta opción para afectar las clases incluidas en la lista de dex principal.
main_dex_proguard_specs

Lista de etiquetas. El valor predeterminado es [].

Son los archivos que se usarán como especificaciones de Proguard para determinar las clases que se deben conservar en el dex principal. Solo se permite si el atributo multidex está establecido en legacy.
manifest

Label: Obligatoria

Nombre del archivo de manifiesto de Android, normalmente AndroidManifest.xml. Se debe definir si se definen resource_files o assets.
manifest_values

Diccionario: Cadena -> Cadena; el valor predeterminado es {}

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 en las etiquetas uses-sdk y el manifiesto.

Se ignorará packageName y se establecerá desde applicationId si se especifica o desde el paquete en el manifiesto.

Cuando manifest_merger se establece en legacy, solo applicationId, versionCode y versionName tendrán algún efecto.

multidex

Cadena. 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 de 64 000 índices de dex. Se supone que la plataforma nativa admite la carga de clases multidex en el tiempo de ejecución. Esto solo funciona con Android L y versiones posteriores.
  • legacy: Divide el código en varios archivos dex cuando se supera el límite de 64 000 índices de dex. Se supone que las clases de multidex se cargan a través del código de la aplicación (es decir, no hay compatibilidad con la plataforma nativa).
  • manual_main_dex: Divide el código en varios archivos dex cuando se supera el límite de índice de 64 K de dex. El contenido del archivo DEX principal se debe especificar 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 supera el límite de índice.
nocompress_extensions

Lista de cadenas; el valor predeterminado es []

Es una lista de extensiones de archivos que se deben dejar sin comprimir en el APK.
package_id

Número entero; el valor predeterminado es 0

Es el ID de paquete que se asignará a los recursos de este objeto binario.

Consulta el argumento --package-id de AAPT2 para obtener más información. Por lo general, este parámetro se puede (y debe) dejar sin configurar, lo que da como resultado el valor predeterminado de 127 (0x7F).

plugins

Lista de etiquetas. El valor predeterminado es [].

Son complementos del compilador de Java que se ejecutan en tiempo de compilación. Cada java_plugin especificado en el atributo plugins se ejecutará cada vez que se compile este destino. Los recursos que genera el complemento se incluirán en el archivo .jar de resultado del destino.
proguard_apply_dictionary

Etiqueta: El valor predeterminado es None.

Archivo que se usará como asignación para ProGuard. Es un archivo separado por líneas de "palabras" que se pueden extraer cuando se cambian los nombres de las clases y los miembros durante la ofuscación.
proguard_apply_mapping

Etiqueta: El valor predeterminado es None.

Archivo que se usará como asignación para ProGuard. Es un archivo de asignación generado por proguard_generate_mapping que se puede volver a usar para aplicar la misma asignación a una compilación nueva.
proguard_generate_mapping

Booleano; no se puede configurar; el valor predeterminado es False

Indica si se debe generar el archivo de asignación de Proguard. El archivo de asignación solo se generará si se especifica proguard_specs. En este archivo, se mostrará la asignación entre los nombres originales y los ofuscados de las clases, los métodos y los campos.

ADVERTENCIA: Si se usa este atributo, la especificación de Proguard no debe contener ni -dontobfuscate ni -printmapping.
proguard_specs

Lista de etiquetas. El valor predeterminado es [].

Archivos que se usarán como especificación de Proguard. En este archivo, se describirá el conjunto de especificaciones que usará Proguard.
resource_configuration_filters

Lista de cadenas; el valor predeterminado es []

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 [].

Es la lista de recursos que se incluirán en el paquete. Por lo general, se trata de un glob de todos los archivos del directorio res.
También se puede hacer referencia a los archivos generados (a partir de genrules) por medio de la etiqueta aquí. La única restricción es que los resultados generados deben estar en el mismo directorio "res" que cualquier otro archivo de recursos que se incluya.
shrink_resources

Número entero; el valor predeterminado es -1

Indica si se debe realizar la reducción de recursos. Los recursos que no use el archivo binario se quitarán del APK. Esto solo se admite para las reglas que usan recursos locales (es decir, los atributos manifest y resource_files) y requiere ProGuard. Funciona de la misma manera que el reductor de recursos de Gradle (https://developer.android.com/studio/build/shrink-code.html#shrink-resources).

Diferencias destacadas:

  • También se quitarán los recursos en values/, así como los recursos basados en archivos.
  • Usa strict mode de forma predeterminada
  • La eliminación de recursos de ID sin usar solo se admite con aapt2
Si la reducción de recursos está habilitada, también se generará name_files/resource_shrinker.log, en el que se detallarán el análisis y las eliminaciones que se realizaron.

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 la 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

Nombre: Obligatorio

Es un nombre único para este destino.
aar

Label: Obligatoria

Es el archivo .aar que se proporciona a los destinos de Android que dependen de este destino.
exports

Lista de etiquetas. El valor predeterminado es [].

Son los destinos para exportar a las reglas que dependen de esta regla. Consulta java_library.exports.
srcjar

Etiqueta: El valor predeterminado es None.

Es un archivo JAR que contiene el código fuente de los archivos JAR compilados en el AAR.

android_library

Ver la 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 del entorno de ejecución de Android android.jar se coloca de forma implícita en la ruta de acceso de clase de compilación.

Objetivos de salida implícitos

  • libname.jar: Es un archivo Java.
  • libname-src.jar: Es un archivo que contiene las fuentes ("source jar").
  • 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 establecer idl_import_root. Supongamos que //java/bazel/helloandroid/BUILD contiene 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

Nombre: Obligatorio

Es un nombre único para este destino.
deps

Lista de etiquetas. El valor predeterminado es [].

Es la lista de otras bibliotecas con las que se debe vincular. Los tipos de bibliotecas permitidos son: android_library, java_library con la restricción android y cc_library que encapsula o produce bibliotecas nativas .so para la plataforma de destino de Android.
srcs

Lista de etiquetas. El valor predeterminado es [].

Es la lista de archivos .java o .srcjar que se procesan para crear el destino.

Se compilan los archivos srcs de tipo .java. Para facilitar la lectura, no es recomendable colocar el nombre de un archivo fuente .java generado en el srcs. En su lugar, coloca el nombre de la regla de la que depende en srcs, como se describe a continuación.

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

Si se omite srcs, se exportará desde esta regla cualquier dependencia especificada en deps (consulta las exportaciones de java_library para obtener más información sobre la exportación de dependencias). Sin embargo, este comportamiento dejará de estar disponible pronto, por lo que te recomendamos que no dependas de él.

assets

Lista de etiquetas. El valor predeterminado es [].

Lista de recursos que se incluirán en el paquete. Por lo general, se trata de un glob de todos los archivos del directorio assets. También puedes hacer referencia a otras reglas (cualquier regla que genere archivos) o a archivos exportados en los otros paquetes, siempre y cuando todos esos archivos se encuentren en el directorio assets_dir del paquete correspondiente.
assets_dir

Cadena. El valor predeterminado es "".

Es la cadena que proporciona la ruta de acceso a los archivos en assets. El par assets y assets_dir describen los recursos empaquetados, y se deben proporcionar ambos atributos o ninguno de ellos.
custom_package

Cadena. El valor predeterminado es "".

Es el paquete Java para el que se generarán los códigos fuente Java. De forma predeterminada, el paquete se infiere del directorio en el que se encuentra el archivo BUILD que contiene la regla. Puedes especificar un paquete diferente, pero esto no se recomienda, ya que puede generar conflictos en la ruta de acceso 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 verdadero, esta regla procesa las expresiones de vinculación de datos en los recursos de diseño incluidos a través del atributo resource_files. Sin este parámetro de configuración, las expresiones de vinculación de datos producen errores de compilación.

Para compilar una app para Android con vinculación de datos, también debes hacer lo siguiente:

  1. Establece este atributo para todas las reglas de Android que dependen de esta de forma transitiva. Esto se debe a que los elementos dependientes 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.
  2. Agrega una entrada deps = para la biblioteca de tiempo de ejecución de la vinculación de datos a todos los destinos que establezcan este atributo. La ubicación de esta biblioteca depende de la configuración del depósito.
exported_plugins

Lista de etiquetas. El valor predeterminado es [].

Lista de java_plugins (p.ej., procesadores de anotaciones) que se exportarán a las bibliotecas que dependen directamente de esta biblioteca.

La lista especificada de java_plugins se aplicará a cualquier biblioteca que dependa directamente de esta biblioteca, como si esa biblioteca 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 a través de los atributos exports se considera una dependencia directa de cualquier regla que dependa 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

Indica si se deben exportar las entradas del manifiesto a los destinos android_binary que dependen de este destino. Los atributos de uses-permissions nunca se exportan.
idl_import_root

Cadena. El valor predeterminado es "".

Ruta de acceso relativa al paquete de la raíz del árbol de paquetes de Java que contiene las fuentes de IDL incluidas en esta biblioteca.

Esta ruta de acceso se usará como la raíz de importación cuando se procesen las fuentes de IDL que dependen de esta biblioteca.

Cuando se especifica idl_import_root, tanto idl_parcelables como idl_srcs deben estar en la ruta de acceso 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 de acceso especificada por su paquete en una raíz de Java.

Consulta ejemplos.
idl_parcelables

Lista de etiquetas. El valor predeterminado es [].

Lista de definiciones de IDL de Android que se deben proporcionar como importaciones. Estos archivos estarán disponibles como importaciones para cualquier destino android_library que dependa de esta biblioteca, ya sea directamente 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, se debe usar idl_srcs.

Estos archivos deben colocarse de forma adecuada para que el compilador de AIDL los encuentre. Consulta la descripción de idl_import_root para obtener información sobre lo que significa.
idl_preprocessed

Lista de etiquetas. El valor predeterminado es [].

Lista de definiciones de IDL de Android preprocesadas para proporcionar como importaciones. Estos archivos estarán disponibles como importaciones para cualquier destino android_library que dependa de esta biblioteca, ya sea directamente 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 deban traducirse a interfaces de Java y usa idl_parcelable para los archivos AIDL no preprocesados.

idl_srcs

Lista de etiquetas. El valor predeterminado es [].

Lista de definiciones de IDL de Android para traducir a interfaces de Java. Después de generar 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 directamente o a través de su cierre transitivo.

Estos archivos deben colocarse de forma adecuada para que el compilador de AIDL los encuentre. Consulta la descripción de idl_import_root para obtener información sobre lo que significa.
javacopts

Lista de cadenas; el valor predeterminado es []

Son opciones de compilador adicionales para este destino. Sujeto a la sustitución de "Make variable" y la tokenización de Bourne shell.

Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.
manifest

Etiqueta: El valor predeterminado es None.

Nombre del archivo de manifiesto de Android, normalmente AndroidManifest.xml. Se debe definir si se definen resource_files o assets.

Booleano; el valor predeterminado es False

Solo usa esta biblioteca para la compilación y no en 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 [].

Son complementos del compilador de Java que se ejecutan en tiempo de compilación. Cada java_plugin especificado en el atributo plugins se ejecutará cada vez que se compile este destino. Los recursos que genera el complemento se incluirán en el archivo .jar de resultado del destino.
proguard_specs

Lista de etiquetas. El valor predeterminado es [].

Archivos que se usarán como especificación de Proguard. Estos describirán el conjunto de especificaciones que usará Proguard. Si se especifican, se agregarán a cualquier destino android_binary que dependa de esta biblioteca. Los archivos incluidos aquí solo deben tener reglas idempotentes, es decir, -dontnote, -dontwarn, assumenosideeffects y reglas que comiencen con -keep. Las demás opciones solo pueden aparecer en los proguard_specs de android_binary para garantizar que las combinaciones no sean tautológicas.
resource_files

Lista de etiquetas. El valor predeterminado es [].

Es la lista de recursos que se incluirán en el paquete. Por lo general, se trata de un glob de todos los archivos del directorio res.
También se puede hacer referencia a los archivos generados (a partir de genrules) por medio de la etiqueta aquí. La única restricción es que los resultados generados deben estar en el mismo directorio "res" que cualquier otro archivo de recursos que se incluya.

android_instrumentation_test

Ver la 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. Se iniciará un emulador, se instalarán la aplicación que se está probando, la aplicación de prueba y cualquier otra aplicación necesaria, y se ejecutarán las pruebas definidas en el paquete de prueba.

El atributo test_app especifica el android_binary que contiene la prueba. A su vez, este android_binary especifica la aplicación android_binary en prueba 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

Nombre: Obligatorio

Es un nombre único para este destino.
support_apks

Lista de etiquetas. El valor predeterminado es [].

Otros APKs que se instalarán en el dispositivo antes de que comience la prueba de instrumentación.
target_device

Label: Obligatoria

Es el 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 los siguientes argumentos: --test_output=streamed --test_arg=--device_broker_type=LOCAL_ADB_SERVER --test_arg=--device_serial_number=$device_identifier
test_app

Label: Obligatoria

Es el objetivo android_binary que contiene las clases de prueba. El destino android_binary debe especificar qué destino está probando a través de su atributo instruments.

android_local_test

Ver la 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 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.

Objetivos de salida implícitos

  • name.jar: Es un archivo Java de la prueba.
  • name-src.jar: Es un archivo que contiene las fuentes ("source jar").
  • name_deploy.jar: Es un archivo de implementación de Java adecuado para la implementación (solo se compila si se solicita explícitamente).

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()
Esto incorpora las reglas de maven_jar necesarias para Robolectric. Luego, cada regla android_local_test debe 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

Nombre: Obligatorio

Es un nombre único para este destino.
deps

Lista de etiquetas. El valor predeterminado es [].

Lista de bibliotecas que se probarán, así como bibliotecas adicionales que se vincularán al destino. Todos los recursos, los archivos de recursos y los archivos de manifiesto declarados en las reglas de Android en el cierre transitivo de este atributo están disponibles en la prueba.

La lista 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 [].

Es la lista de archivos fuente que se procesan para crear el destino. Se requiere, excepto en el caso especial que se describe a continuación.

Se compilan los archivos srcs de tipo .java. Para facilitar la lectura, no es recomendable colocar el nombre de un archivo fuente .java generado en el srcs. En su lugar, coloca el nombre de la regla de la que depende en srcs, como se describe a continuación.

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

Se ignorarán todos los demás archivos, siempre y cuando haya al menos un archivo de un tipo de archivo descrito 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

Cadena. El valor predeterminado es "".

Paquete 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 []

Son las densidades por las que se filtrará al compilar el APK. También se agregará una sección compatible-screens correspondiente al manifiesto si aún no contiene un StarlarkListing de superconjunto.
enable_data_binding

Booleano; el valor predeterminado es False

Si es verdadero, 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 este parámetro de configuración, las dependencias de vinculación de datos no tendrán la generación de código necesaria a nivel binario y pueden producir errores de compilación.
javacopts

Lista de cadenas; el valor predeterminado es []

Son opciones adicionales del compilador para esta biblioteca. Sujeto a la sustitución de "Make variable" y la tokenización de Bourne shell.

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 []

Es una lista de marcas para incorporar en la secuencia de comandos de wrapper que se genera para ejecutar este archivo binario. Sujeto a la sustitución de $(location) y "Make variable", y a la tokenización de Bourne shell.

La secuencia de comandos de wrapper para un archivo binario de Java incluye una definición de CLASSPATH (para encontrar todos los archivos JAR dependientes) y llama al intérprete de Java correcto. La línea de comandos que genera la secuencia de comandos de wrapper incluye el nombre de la clase principal seguido de un "$@" para que puedas pasar otros argumentos después del nombre de la clase. Sin embargo, los argumentos destinados al análisis por parte de la JVM deben especificarse antes del nombre de la clase en la línea de comandos. El contenido de jvm_flags se agrega a la secuencia de comandos de wrapper antes de que se muestre el nombre de la clase.

Ten en cuenta que este atributo no tiene efecto en los resultados de *_deploy.jar.
manifest

Etiqueta: El valor predeterminado es None.

Nombre del archivo de manifiesto de Android, normalmente AndroidManifest.xml. Se debe definir si se definen resource_files o assets, o si alguno de los manifiestos de las bibliotecas en prueba tiene una etiqueta minSdkVersion.
manifest_values

Diccionario: Cadena -> Cadena; el valor predeterminado es {}

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 a name en este diccionario. applicationId, versionCode, versionName, minSdkVersion, targetSdkVersion y maxSdkVersion también anularán los atributos correspondientes de las etiquetas uses-sdk y del manifiesto. Se ignorará packageName y se establecerá a partir de applicationId si se especifica o del 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 []

Es una lista de extensiones de archivos que no se comprimirán en el APK de recursos.
plugins

Lista de etiquetas. El valor predeterminado es [].

Son complementos del compilador de Java que se ejecutan en tiempo de compilación. Cada java_plugin especificado en este atributo se ejecutará cada vez que se compile esta regla. Una biblioteca también puede heredar complementos de dependencias que usan exported_plugins. Los recursos que genera el complemento se incluirán en el archivo .jar resultante de esta regla.
resource_configuration_filters

Lista de cadenas; el valor predeterminado es []

Es una lista de filtros de configuración de recursos, como "en", que limitará los recursos del APK solo a los que se encuentran en la configuración "en".
resource_jars

Lista de etiquetas. El valor predeterminado es [].

Obsoleto: En su lugar, usa java_import y deps o runtime_deps.
resource_strip_prefix

Cadena. El valor predeterminado es "".

Es el prefijo de 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 del atributo resources. Es un error que un archivo de recursos no esté en este directorio. Si no se especifica (valor predeterminado), la ruta de acceso del archivo de recursos se determina según la misma lógica que el paquete Java de los archivos fuente. Por ejemplo, un archivo fuente en stuff/java/foo/bar/a.txt se ubicará en foo/bar/a.txt.

runtime_deps

Lista de etiquetas. El valor predeterminado es [].

Son las bibliotecas que estarán disponibles para el archivo binario final o la prueba solo en el tiempo de ejecución. Al igual que los deps comunes, estos aparecerán en la ruta de clase de tiempo de ejecución, pero, a diferencia de ellos, no en la ruta de clase de tiempo de compilación. Aquí se deben enumerar las dependencias que solo se necesitan en el tiempo de ejecución. Las herramientas de análisis de dependencias deben ignorar los destinos que aparecen en runtime_deps y deps.
stamp

Número entero; el valor predeterminado es 0

Indica si se debe codificar la información de compilación en el archivo binario. Valores posibles:
  • stamp = 1: Siempre se incluye la información de compilación en el binario, incluso en las compilaciones de --nostamp. Se debe evitar este parámetro de configuración, ya que podría detener el almacenamiento en caché remoto del binario y cualquier acción posterior que dependa de él.
  • stamp = 0: Siempre reemplaza la información de compilación por valores constantes. Esto proporciona un buen almacenamiento en caché de los resultados de la compilación.
  • stamp = -1: La incorporación de información de compilación se controla con la marca --[no]stamp.

Los archivos binarios con marca de tiempo no se vuelven a compilar, a menos que cambien sus dependencias.
test_class

Cadena. El valor predeterminado es "".

Es la clase de Java que cargará el ejecutor de pruebas.

Este atributo especifica el nombre de una clase Java que ejecutará esta prueba. Es raro que debas configurar este parámetro. Si se omite este argumento, se usará la clase Java cuyo nombre corresponda al name de esta regla android_local_test. La clase de prueba debe anotarse con org.junit.runner.RunWith.

use_launcher

Booleano; el valor predeterminado es True

Indica si el binario debe usar un selector personalizado.

Si este atributo se establece en falso, se ignorarán el atributo launcher y la marca --java_launcher relacionada para este destino.

android_device

Ver la 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 emulador de Android configurado con las especificaciones proporcionadas. Este emulador se puede iniciar con un comando bazel run o ejecutando directamente el script generado. Se recomienda depender de las reglas android_device existentes en lugar de definir las tuyas propias.

Esta regla es un destino adecuado para la marca --run_under de bazel test y blaze run. Inicia un emulador, copia el destino que se está probando o ejecutando en el emulador y lo prueba o 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, como máximo, la arquitectura de CPU I686. Para usar KVM add, agrega tags = ['requires-kvm'] a la regla android_device.

Objetivos de salida implícitos

  • name_images/userdata.dat: Contiene archivos de imagen y snapshots para iniciar el emulador
  • name_images/emulator-meta-data.pb: Contiene información serializada necesaria para pasar al emulador y reiniciarlo.

Ejemplos

En el siguiente ejemplo, se muestra cómo 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 expondrá adb. Si deseas emitir comandos de adb al emulador, este es el puerto al que emitirás adb connect.
  • --emulator_port: Es el puerto en el que se expondrá la consola de administración de Telnet del emulador.
  • --enable_display: Inicia el emulador con una pantalla si es verdadero (el valor predeterminado es falso).
  • --action: Puede ser start o kill.
  • --apks_to_install: Es una lista de APKs para instalar en el emulador.

Argumentos

Atributos
name

Nombre: Obligatorio

Es un nombre único para este destino.
cache

Número entero; obligatorio

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.

Un solo archivo de propiedades que se colocará en /default.prop en el emulador. Esto permite que el autor de la regla configure aún más el emulador para que se parezca más a un dispositivo real (en particular, controlar sus cadenas de UserAgent y otros comportamientos que podrían hacer que una aplicación o un servidor se comporten de manera diferente a 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

Resolución de pantalla horizontal en píxeles que se emulará. El valor mínimo es 240.
platform_apks

Lista de etiquetas. El valor predeterminado es [].

Es una lista de APKs que se instalarán en el dispositivo durante el inicio.
ram

Número entero; obligatorio

Cantidad de RAM en megabytes que se emulará para el dispositivo. Esto se aplica a todo el dispositivo, no solo a una app en particular instalada en él. El valor mínimo es de 64 megabytes.
screen_density

Número entero; obligatorio

Densidad de la pantalla emulada en píxeles por pulgada. El valor mínimo es 30 PPI.
system_image

Label: Obligatoria

Un grupo de archivos que contiene los siguientes archivos:
  • system.img: Es la partición del sistema.
  • kernel-qemu: Es el kernel de Linux que cargará el emulador.
  • ramdisk.img: Es la imagen initrd que se usará en el momento del arranque.
  • userdata.img: Es la partición inicial de userdata.
  • source.properties: Es un archivo de propiedades que contiene información sobre las imágenes.
Estos archivos forman parte del SDK de Android o los proporcionan terceros (por ejemplo, Intel proporciona imágenes x86).
vertical_resolution

Número entero; obligatorio

Resolución de pantalla vertical en píxeles que se emulará. El valor mínimo es 240.
vm_heap

Número entero; obligatorio

Tamaño en megabytes del heap de la máquina virtual que Android usará para cada proceso. El valor mínimo es de 16 megabytes.

android_ndk_repository

Ver la 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. La compatibilidad con versiones futuras del NDK, incluidas la versión 25 y las posteriores, se implementará en la versión de Starlark de android_ndk_repository. Consulta rules_android_ndk para ver la versión de Starlark.

Ten en cuenta que la compilación 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 desde $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 espacio de trabajo en ./android-ndk-r20. Usará las bibliotecas del nivel de API 24 cuando compile tu código JNI.

cpufeatures

El NDK de Android contiene la biblioteca cpufeatures, que se puede usar para detectar la CPU de un dispositivo en 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

Nombre: Obligatorio

Es 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 para el que se realizará la compilación. Si no se especifica, se usará el nivel de API más alto instalado.
path

Cadena; no configurable; el valor predeterminado es ""

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: Cadena -> Cadena; el valor predeterminado es {}

Es un diccionario que asigna el nombre del repositorio local al nombre del repositorio global. Esto permite controlar la resolución de dependencias del espacio de trabajo para las dependencias de este repositorio.

Por ejemplo, una entrada "@foo": "@bar" declara que, para 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 forma global ("@bar//some:target").

android_sdk_repository

Ver la 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 y admita la compilación de destinos de Android.

Ejemplos

Lo mínimo que debes hacer para configurar un SDK de Android para Bazel es colocar una regla android_sdk_repository llamada "androidsdk" en tu archivo WORKSPACE y establecer la variable de entorno $ANDROID_HOME en la ruta de acceso de tu SDK de Android. De forma predeterminada, Bazel usará el nivel de API de Android y la versión de las herramientas de compilación más altos que estén instalados en el SDK de Android. 
android_sdk_repository(
    name = "androidsdk",
)

Para garantizar compilaciones reproducibles, los atributos path, api_level y build_tools_version se pueden establecer en valores específicos. La compilación fallará si el SDK de Android no tiene instalado el nivel de API o la versión de las herramientas de compilación especificados. 

android_sdk_repository(
    name = "androidsdk",
    path = "./sdk",
    api_level = 19,
    build_tools_version = "25.0.0",
)

En el ejemplo anterior, también se muestra el uso de una ruta de acceso relativa al espacio de trabajo para el SDK de Android. Esto es útil si el SDK de Android forma parte de tu espacio de trabajo de Bazel (p.ej., si se registró en el control de versiones).

Bibliotecas de compatibilidad

Las bibliotecas de compatibilidad están disponibles en Android SDK Manager como "Android Support Repository". Es un conjunto versionado de bibliotecas comunes de Android, como las bibliotecas de Support 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 se derivan de las coordenadas de Maven de las bibliotecas en el repositorio de compatibilidad con 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 v7 appcompat. 

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

Nombre: Obligatorio

Es 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 con el que se compila 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}, ya sea que se especifique este atributo o no. Por ejemplo, para compilar en función de un nivel de API no predeterminado, usa bazel build --android_sdk=@androidsdk//:sdk-19 //java/com/example:app.

Para ver todos los destinos de android_sdk que genera android_sdk_repository , puedes ejecutar bazel query "kind(android_sdk, @androidsdk//...)".

build_tools_version

Cadena; no configurable; el valor predeterminado es ""

Es la versión de las herramientas de compilación de Android que se usará desde el SDK de Android. Si no se especifica, se usará la versión más reciente de las herramientas de compilación instaladas.

Bazel requiere la versión 30.0.0 o posterior de las herramientas de compilación.

path

Cadena; no configurable; el valor predeterminado es ""

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: Cadena -> Cadena; el valor predeterminado es {}

Es un diccionario que asigna el nombre del repositorio local al nombre del repositorio global. Esto permite controlar la resolución de dependencias del espacio de trabajo para las dependencias de este repositorio.

Por ejemplo, una entrada "@foo": "@bar" declara que, para 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 forma global ("@bar//some:target").