Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Plug-in do Android para Gradle 3.2.0 (setembro de 2018)
Esta versão do plug-in do Android requer o seguinte:
|
Versão mínima |
Versão padrão |
Observações |
Gradle |
4.6 |
4.6 |
Para saber mais, consulte Como atualizar o Gradle. |
Ferramentas de build do SDK |
28.0.3 |
28.0.3 |
Instale ou configure as Ferramentas de build do SDK. |
3.2.1 (outubro de 2018)
Com esta atualização, não será mais necessário especificar uma versão para o SDK Build Tools. O Plug-in do Android para Gradle agora usa a versão 28.0.3 por padrão.
Novos recursos
-
Suporte à criação de Android App Bundles: o pacote de apps é um novo formato de upload
que inclui todo o código e recursos compilados do app e
adia a geração e a assinatura do APK para a Google Play Store. Não é mais necessário
criar, assinar e gerenciar vários APKs, e os usuários recebem downloads menores,
otimizados para o dispositivo deles. Para saber mais, leia
Sobre os Android App Bundles.
-
Suporte a velocidades aprimoradas de build incremental ao usar processadores de anotações:
a DSL AnnotationProcessorOptions
agora estende a interface CommandLineArgumentProvider
,
que permite que você ou o autor do processador de anotações anote
argumentos para o processador usando
anotações de tipos de propriedade de build incremental (links em inglês).
O uso dessas anotações melhora a exatidão e a performance de
builds limpos incrementais e em cache. Para saber mais, leia
Transmitir argumentos para os processadores de anotações.
-
Ferramenta de migração para o AndroidX: ao usar o Plug-in do Android para Gradle 3.2.0 com
o Android 3.2 e versões mais recentes, você pode migrar as dependências locais e do Maven
do seu projeto para que usem as novas bibliotecas AndroidX, selecionando Refactor >
Migrate to AndroidX na barra de menus. O uso dessa ferramenta de migração também configura
as flags abaixo como true
no seu arquivo gradle.properties
:
-
android.useAndroidX
: quando configurado como true
, o plug-in do Android usa a
biblioteca AndroidX adequada, em vez de uma Biblioteca de Suporte. Quando essa flag
não é especificada, o plug-in a configura como false
por padrão.
-
android.enableJetifier
: quando configurado como true
, o plug-in do Android
migra automaticamente as bibliotecas de terceiros já existentes para usar o AndroidX,
reprogramando os binários delas. Quando essa flag não é especificada, o plug-in a configura
como false
por padrão. Você pode configurar essa flag como true
apenas quando
android.useAndroidX
também estiver configurado como true
. Caso contrário, ocorre um erro de build.
Para saber mais, leia a Visão geral do AndroidX.
-
Novo redutor de código, R8: o R8 é uma nova ferramenta de redução e ofuscação de código
que substitui o ProGuard. Comece a usar a versão de pré-lançamento do R8
incluindo o seguinte no arquivo gradle.properties
do seu projeto:
android.enableR8 = true
android.enableR8 = true
Mudanças de comportamento
-
Agora, a simplificação de leitura com D8 é ativada por padrão.
-
O AAPT2 agora fica no repositório Maven do Google. Para usar o AAPT2, confira se você
tem a dependência do google()
no seu arquivo build.gradle
,
conforme mostrado abaixo:
buildscript {
repositories {
google() // here
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.2.0'
}
}
allprojects {
repositories {
google() // and here
jcenter()
}
buildscript {
repositories {
google() // here
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.2.0'
}
}
allprojects {
repositories {
google() // and here
jcenter()
}
-
Agora, o multidex nativo é ativado por padrão. As versões anteriores do Android
Studio ativavam a multidex nativa ao implantar a versão de depuração de um app em um
dispositivo com a API de nível 21 do Android ou mais recente. Agora, independente de você estar implantando
em um dispositivo ou criando um APK para a versão, o Plug-in do Android para Gradle
ativa o multidex nativo para todos os módulos configurados
como minSdkVersion=21
ou mais recente.
-
O plug-in agora aplica uma versão mínima dos plug-ins protobuf (0.8.6),
Kotlin (1.2.50) e Crashlytics (1.25.4).
-
O plug-in de módulo de recurso, com.android.feature
, agora
aplica o uso exclusivo de letras, dígitos e sublinhados ao especificar
um nome de módulo. Por exemplo, se o nome do módulo de recursos incluir traços,
haverá um erro de build. Esse comportamento corresponde ao do plug-in de recursos
dinâmicos.
Correções de bugs
- O JavaCompile agora pode ser armazenado em cache em projetos com vinculação de dados
(problema 69243050).
- Melhor evasão de compilação para módulos de biblioteca com vinculação de dados
(problema 77539932).
- Agora, você pode reativar a
configuração sob demanda (em inglês),
caso a tenha desativado em versões anteriores devido a alguns
erros de build imprevisíveis
(problema 77910727).
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-09-05 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 UTC."],[],[],null,["\u003cbr /\u003e\n\nAndroid Gradle Plugin 3.2.0 (September 2018)\n\nThis version of the Android plugin requires the following:\n\n| | Minimum version | Default version | Notes |\n|----------------:|:---------------:|:---------------:|:----------------------------------------------------------------------------------------------------------:|\n| Gradle | 4.6 | 4.6 | To learn more, see [updating Gradle](/build/releases/gradle-plugin?buildsystem=ndk-build#updating-gradle). |\n| SDK Build Tools | 28.0.3 | 28.0.3 | [Install](/studio/intro/update#sdk-manager) or [configure](/tools/releases/build-tools) SDK Build Tools. |\n\n**3.2.1 (October 2018)**\n\nWith this update, you no longer need to specify a version for the SDK Build\nTools. The Android Gradle plugin now uses version 28.0.3 by default.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nNew features\n\n- **Support for building Android App Bundles:** The app bundle is a new upload\n format that includes all your app's compiled code and resources while\n deferring APK generation and signing to the Google Play Store. You no longer\n have to build, sign, and manage multiple APKs, and users get smaller downloads\n that are optimized for their device. To learn more, read\n [About Android App Bundles](/guide/app-bundle).\n\n- **Support for improved incremental build speeds when using annotation processors:**\n The [`AnnotationProcessorOptions`](https://google.github.io/android-gradle-dsl/current/com.android.build.gradle.internal.dsl.AnnotationProcessorOptions.html)\n DSL now extends [`CommandLineArgumentProvider`](https://docs.gradle.org/current/javadoc/org/gradle/process/CommandLineArgumentProvider.html),\n which enables either you or the annotation processor author to annotate\n arguments for the processor using\n [incremental build property type annotations](https://docs.gradle.org/current/userguide/more_about_tasks.html#sec:up_to_date_checks).\n Using these annotations improves the correctness and performance of\n incremental and cached clean builds. To learn more, read\n [Pass arguments to annotation processors](/studio/build/dependencies#processor-arguments).\n\n- **Migration tool for AndroidX:** When using Android Gradle plugin 3.2.0 with\n Android 3.2 and higher, you can migrate your project's local and Maven\n dependencies to use the new AndroidX libraries by selecting **Refactor \\\u003e\n Migrate to AndroidX** from the menu bar. Using this migration tool also sets\n the following flags to `true` in your `gradle.properties` file:\n\n - **`android.useAndroidX`:** When set to `true`, the Android plugin uses the\n appropriate AndroidX library instead of a Support Library. When this flag\n is not specified, the plugin sets it to `false` by default.\n\n - **`android.enableJetifier`:** When set to `true`, the Android plugin\n automatically migrates existing third-party libraries to use AndroidX by\n rewriting their binaries. When this flag is not specified, the plugin sets\n it to `false` by default. You can set this flag to `true` only while\n `android.useAndroidX` is also set to `true`, otherwise you get a build error.\n\n To learn more, read the [AndroidX overview](/topic/libraries/support-library/androidx-overview).\n- **New code shrinker, R8:** R8 is a new tool for code shrinking and obfuscation\n that replaces ProGuard. You can start using the preview version of R8 by\n including the following in your project's `gradle.properties` file:\n\n ```groovy\n android.enableR8 = true\n \n ``` \n\n ```kotlin\n android.enableR8 = true\n \n ```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nBehavior changes\n\n- Desugaring with D8 is now enabled by default.\n\n- AAPT2 is now on Google's Maven repo. To use AAPT2, make sure that you\n have the `google()` dependency in your `build.gradle`\n file, as shown below:\n\n ```groovy\n buildscript {\n repositories {\n google() // here\n jcenter()\n }\n dependencies {\n classpath 'com.android.tools.build:gradle:3.2.0'\n }\n }\n allprojects {\n repositories {\n google() // and here\n jcenter()\n }\n \n ``` \n\n ```kotlin\n buildscript {\n repositories {\n google() // here\n jcenter()\n }\n dependencies {\n classpath 'com.android.tools.build:gradle:3.2.0'\n }\n }\n allprojects {\n repositories {\n google() // and here\n jcenter()\n }\n \n ```\n- Native multidex is now enabled by default. Previous versions of Android\n Studio enabled native multidex when deploying the debug version of an app to a\n device running Android API level 21 or higher. Now, whether you're deploying\n to a device or building an APK for release, the Android Gradle plugin\n enables native multidex for all modules that set\n `minSdkVersion=21` or higher.\n\n- The plugin now enforces a minimum version of the protobuf plugin (0.8.6),\n Kotlin plugin (1.2.50), and Crashlytics plugin (1.25.4).\n\n- The feature module plugin,`com.android.feature`, now\n enforces the use of only letters, digits, and underscores when specifying\n a module name. For example, if your feature module name includes dashes,\n you get a build error. This behavior matches that of the dynamic feature\n plugin.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nBug fixes\n\n- JavaCompile is now cacheable in projects with data binding. ([Issue #69243050](https://issuetracker.google.com/69243050))\n- Better compile avoidance for library modules with data binding. ([Issue #77539932](https://issuetracker.google.com/77539932))\n- You can now re-enable [configure-on-demand](https://docs.gradle.org/current/userguide/multi_project_builds.html#sec:configuration_on_demand) if you've disable it in earlier versions due to some unpredictable build errors. ([Issue #77910727](https://issuetracker.google.com/77910727))\n\n\u003cbr /\u003e"]]