Regras
android_binary
Conferir origem da regraandroid_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)
Produz arquivos de pacote de aplicativo Android (.apk).
Destinos de saída implícitos
name.apk
: um app Android arquivo de pacote assinado com chaves de depuração e zipaligned, ele pode ser usado para desenvolver e depurar seu aplicativo. Não é possível lançar o aplicativo quando assinado com as chaves de depuração.name_unsigned.apk
: uma versão não assinada da acima, que pode ser assinado com as chaves de lançamento antes do lançamento ao público.name_deploy.jar
: um arquivo Java que contém o fechamento transitivo desse destino.O jar de implantação contém todas as classes que seriam encontradas por uma carregador de classe que pesquisou o caminho de classe do tempo de execução deste destino do início ao fim.
name_proguard.jar
: um arquivo Java contendo o resultado de executar o ProGuardname_deploy.jar
. Essa saída só é produzida se atributo proguard_specs é especificado.name_proguard.map
: um resultado do arquivo de mapeamento de executando o ProGuard noname_deploy.jar
. Essa saída só é produzida se atributo proguard_specs é especificado, e proguard_generate_mapping ou shrink_resources está definido.
Exemplos
Exemplos de regras do Android podem ser encontrados no diretório examples/android
do
Árvore de origem do Bazel.
Argumentos
Atributos | |
---|---|
name |
Nome; obrigatório Um nome exclusivo para o destino. |
deps
|
Lista de rótulos o padrão é android_library ,
java_library com android restrição e
cc_library unindo ou produzindo bibliotecas nativas .so para o
Plataforma de destino do Android.
|
srcs
|
Lista de rótulos o padrão é Arquivos Arquivos |
assets
|
Lista de rótulos o padrão é glob de todos os arquivos na pasta
assets . Você também pode referenciar outras regras (qualquer regra que produza
ou arquivos exportados em outros pacotes, desde que todos esses arquivos estejam na pasta
assets_dir no pacote correspondente.
|
assets_dir
|
String; o padrão é assets .
Os pares assets e assets_dir descrevem itens do pacote
recursos e ambos os atributos devem ser fornecidos ou nenhum deles.
|
crunch_png
|
Booleano; o padrão é |
custom_package
|
String; o padrão é |
debug_key
|
Rótulo o padrão é AVISO: não use suas chaves de produção. Elas devem ser rigorosamente protegidos e não mantidos na árvore de origem. |
debug_signing_keys
|
Lista de rótulos o padrão é AVISO: não use suas chaves de produção. Elas devem ser rigorosamente protegidos e não mantidos na árvore de origem. |
debug_signing_lineage_file
|
Rótulo o padrão é AVISO: não use suas chaves de produção. Elas devem ser rigorosamente protegidos e não mantidos na árvore de origem. |
densities
|
Lista de strings o padrão é |
dex_shards
|
Número inteiro o padrão é Observe que cada fragmento resultará em pelo menos um dex no app final. Por isso, não é recomendável definir esse valor para mais de 1 para binários de lançamento. |
dexopts
|
Lista de strings o padrão é |
enable_data_binding
|
Booleano; o padrão é Para criar um app Android com vinculação de dados, também é necessário fazer o seguinte:
|
incremental_dexing
|
Número inteiro nonconfigurable; o padrão é |
instruments
|
Rótulo o padrão é O destino Se o atributo for definido, o |
javacopts
|
Lista de strings o padrão é Essas opções do compilador são transmitidas para javac após as opções do compilador global. |
key_rotation_min_sdk
|
String; o padrão é |
main_dex_list
|
Rótulo o padrão é android/support/multidex/MultiDex$V19.class android/support/multidex/MultiDex.class android/support/multidex/MultiDexApplication.class com/google/common/base/Objects.classPrecisa ser usado com multidex="manual_main_dex" .
|
main_dex_list_opts
|
Lista de strings o padrão é |
main_dex_proguard_specs
|
Lista de rótulos o padrão é multidex estiver definido como legacy .
|
manifest
|
Rótulo obrigatório É o nome do arquivo de manifesto do Android, normalmenteAndroidManifest.xml .
Precisa ser definido se resource_files ou assets estiverem definidos.
|
manifest_values
|
Dicionário: String -> String; o padrão é
Qualquer instância de
Quando |
multidex
|
String; o padrão é Valores possíveis:
|
nocompress_extensions
|
Lista de strings o padrão é |
package_id
|
Número inteiro o padrão é Consulte o argumento |
plugins
|
Lista de rótulos o padrão é java_plugin especificado em
o atributo de plug-ins será executado
esse destino é criado. Recursos gerados por
o plug-in será incluído no jar de resultados de
ao alvo.
|
proguard_apply_dictionary
|
Rótulo o padrão é |
proguard_apply_mapping
|
Rótulo o padrão é proguard_generate_mapping a ser
reutilizado para aplicar o mesmo mapeamento a um novo build.
|
proguard_generate_mapping
|
Booleano; nonconfigurable; o padrão é proguard_specs for
especificado. Esse arquivo listará o mapeamento entre o original e
nomes ofuscados de classes, métodos e campos.
AVISO: se este atributo for usado, o Proguard
a especificação não pode conter |
proguard_specs
|
Lista de rótulos o padrão é |
resource_configuration_filters
|
Lista de strings o padrão é en_XA e/ou ar_XB .
|
resource_files
|
Lista de rótulos o padrão é glob de todos os arquivos na pasta
res .
Os arquivos gerados (de regras gerais) podem ser referenciados por Rótulo aqui também. A única restrição é que as saídas geradas precisam estar sob o mesmo " res " como qualquer outro
arquivos de recursos incluídos.
|
shrink_resources
|
Número inteiro o padrão é manifest e resource_files ) e requer o ProGuard.
Ele funciona basicamente da mesma maneira que o redutor de recursos do Gradle.
(https://developer.android.com/studio/build/shrink-code.html#shrink-resources).
Diferenças significativas:
name_files/resource_shrinker.log
também serão gerados, detalhando a análise e as exclusões realizadas.
Valores possíveis:
|
android_library
Conferir origem da regraandroid_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)
Essa regra compila e arquiva as origens em um arquivo .jar
.
A biblioteca do Android Runtime android.jar
é implicitamente colocada em
o caminho da classe de compilação.
Destinos de saída implícitos
libname.jar
: um arquivo Java.libname-src.jar
: um arquivo contendo o fontes ("jar de origem").name.aar
: um "aar" do Android. pacote contendo o arquivo Java e recursos deste destino. Ele não contém o fechamento transitivo.
Exemplos
Exemplos de regras do Android podem ser encontrados no diretório examples/android
do
Árvore de origem do Bazel.
O exemplo a seguir mostra
como definir idl_import_root
.
Permita que //java/bazel/helloandroid/BUILD
contenha:
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 |
Nome; obrigatório Um nome exclusivo para o destino. |
deps
|
Lista de rótulos o padrão é android_library ,
java_library com android restrição e
cc_library unindo ou produzindo .so bibliotecas nativas
para a plataforma de destino Android.
|
srcs
|
Lista de rótulos o padrão é .java ou .srcjar que
são processados para criar o destino.
Arquivos Arquivos Se |
assets
|
Lista de rótulos o padrão é glob de todos os arquivos na pasta
assets . Você também pode referenciar outras regras (qualquer regra que produza
ou arquivos exportados em outros pacotes, desde que todos esses arquivos estejam na pasta
assets_dir no pacote correspondente.
|
assets_dir
|
String; o padrão é assets .
Os pares assets e assets_dir descrevem itens do pacote
recursos e ambos os atributos devem ser fornecidos ou nenhum deles.
|
custom_package
|
String; o padrão é |
enable_data_binding
|
Booleano; o padrão é Para criar um app Android com vinculação de dados, também é necessário fazer o seguinte:
|
exported_plugins
|
Lista de rótulos o padrão é java_plugin s (por exemplo, de anotação
processadores) para exportar para bibliotecas que dependem diretamente dessa biblioteca.
A lista especificada de |
exports
|
Lista de rótulos o padrão é exports
são consideradas dependências diretas de qualquer regra que dependa diretamente da
de destino com exports .
Os |
exports_manifest
|
Número inteiro o padrão é android_binary
que dependem dessa meta. Os atributos uses-permissions nunca são exportados.
|
idl_import_root
|
String; o padrão é Esse caminho será usado como raiz de importação ao processar origens inativas que dependem dessa biblioteca. Quando Consulte exemplos. |
idl_parcelables
|
Lista de rótulos o padrão é android_library destino que depende dessa biblioteca, diretamente
ou por meio do fechamento transitivo, mas não são traduzidos para Java
ou compilados.
Somente arquivos Esses arquivos devem ser colocados de forma apropriada para que o compilador AID os encontre. Veja a descrição de idl_import_root para saber o que isso significa. |
idl_preprocessed
|
Lista de rótulos o padrão é android_library destino que depende dessa biblioteca, diretamente
ou por meio do fechamento transitivo, mas não são traduzidos para Java
ou compilados.
Somente arquivos |
idl_srcs
|
Lista de rótulos o padrão é srcs .
Esses arquivos serão disponibilizados como importações
Esses arquivos devem ser colocados de forma apropriada para que o compilador AID os encontre. Veja a descrição de idl_import_root para saber o que isso significa. |
javacopts
|
Lista de strings o padrão é Essas opções do compilador são transmitidas para javac após as opções do compilador global. |
manifest
|
Rótulo o padrão é AndroidManifest.xml .
Precisa ser definido se resource_files ou assets estiverem definidos.
|
neverlink
|
Booleano; o padrão é neverlink não serão usadas em
Criação de .apk . Útil se a biblioteca for fornecida pelo
durante a execução.
|
plugins
|
Lista de rótulos o padrão é java_plugin especificado em
o atributo de plug-ins será executado
esse destino é criado. Recursos gerados por
o plug-in será incluído no jar de resultados de
ao alvo.
|
proguard_specs
|
Lista de rótulos o padrão é android_binary , dependendo dessa biblioteca.
Os arquivos incluídos aqui só podem ter regras idempotentes, como -dontnote, -dontwarn
presumanocolaterais e regras que começam com -keep. Outras opções só podem aparecer em
Proguard_specs de android_binary , para garantir mesclas não tautológicas.
|
resource_files
|
Lista de rótulos o padrão é glob de todos os arquivos na pasta
res .
Os arquivos gerados (de regras gerais) podem ser referenciados por Rótulo aqui também. A única restrição é que as saídas geradas precisam estar sob o mesmo " res " como qualquer outro
arquivos de recursos incluídos.
|
android_sdk_repository
Conferir origem da regraandroid_sdk_repository(name, api_level, build_tools_version, path, repo_mapping)
Configura o Bazel para usar um SDK local do Android com suporte à criação de destinos do Android.
Exemplos
O mínimo para configurar um SDK do Android para Bazel é colocar uma regraandroid_sdk_repository
chamado "androidsdk" no arquivo WORKSPACE
e defina $ANDROID_HOME
variável de ambiente para o caminho do SDK do Android. O Bazel vai usar o nível mais alto da API do Android
e a versão das ferramentas de build instaladas no SDK do Android por padrão.
android_sdk_repository( name = "androidsdk", )
Para garantir builds reproduzíveis, path
, api_level
e
Os atributos build_tools_version
podem ser definidos para valores específicos. O build falhará se
o SDK do Android não tem o nível especificado da API ou da versão das ferramentas de build instalado.
android_sdk_repository( name = "androidsdk", path = "./sdk", api_level = 19, build_tools_version = "25.0.0", )
O exemplo acima também demonstra o uso de um caminho relativo ao espaço de trabalho para o SDK do Android. Isso é Útil se o SDK do Android fizer parte do seu espaço de trabalho do Bazel (por exemplo, se for verificado na versão controle).
Bibliotecas de Suporte
As Bibliotecas de Suporte estão disponíveis no Android SDK Manager como "Repositório de Suporte do Android".
Este é um conjunto com controle de versões de bibliotecas comuns do Android, como as bibliotecas Support e AppCompat,
empacotado como repositório Maven local. android_sdk_repository
gera o Bazel
destinos para cada uma dessas bibliotecas que podem ser usados nas dependências do
Metas android_binary
e android_library
.
Os nomes dos destinos gerados são derivados das coordenadas do Maven das bibliotecas na
Repositório de Suporte do Android, formatado como @androidsdk//${group}:${artifact}-${version}
.
O exemplo a seguir mostra como um android_library
pode depender da versão 25.0.0 do
Biblioteca appcompatibilidade 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 |
Nome; obrigatório Um nome exclusivo para o destino. |
api_level
|
Número inteiro nonconfigurable; o padrão é O nível da API usado para um determinado build pode ser substituído pelo Para conferir todos os destinos |
build_tools_version
|
String; nonconfigurable; o padrão é O Bazel exige a versão 30.0.0 ou mais recente das ferramentas de build. |
path
|
String; nonconfigurable; o padrão é $ANDROID_HOME precisa ser definida.
Baixe o SDK do Android em site para desenvolvedores Android. |
repo_mapping
|
Dicionário: String -> String; o padrão é Por exemplo, uma entrada |