O sistema de build do Android Studio é baseado no Gradle, e o Plug-in do Android para Gradle adiciona vários recursos específicos para a criação de apps Android. Embora o Plug-in do Android para Gradle (AGP, na sigla em inglês) geralmente seja atualizado no Android Studio, o plug-in e o restante do sistema Gradle podem ser executados e atualizados de forma independente do Android Studio.
Esta página explica como manter suas ferramentas do Gradle atualizadas e quais são as atualizações recentes. Para ver o que mudou, consulte as notas anteriores da versão do Plug-in do Android para Gradle.
Para conferir o que foi corrigido nessa versão do Plug-in do Android para Gradle, consulte os problemas fechados.
Para ler um resumo detalhado das próximas alterações interruptivas no Plug-in do Android para Gradle, consulte o cronograma do plug-in.
Para saber como configurar seus builds do Android com o Gradle, consulte estas páginas:
- Configurar seu build
- Referência de DSL do Plug-in do Android para Gradle
- Referência de DSL do Gradle (link em inglês)
- Guia do usuário sobre a performance do Gradle (link em inglês)
Para saber mais sobre o sistema de build do Gradle, consulte o Guia do usuário do Gradle (em inglês).
Atualizar o Plug-in do Android para Gradle
Ao atualizar o Android Studio, talvez seja solicitado que você atualize automaticamente o Plug-in do Android para Gradle para a versão mais recente disponível. Você pode aceitar a atualização ou especificar manualmente uma versão com base nos requisitos de build do seu projeto.
Você pode especificar a versão do plug-in no
menu File > Project
Structure > Project no Android Studio ou
no arquivo build.gradle.kts do nível superior. A versão do plug-in se aplica a
todos os módulos criados no projeto do Android Studio em questão. O exemplo abaixo define
o plug-in para a versão 8.4.0 no arquivo
build.gradle.kts:
Kotlin
plugins {
id("com.android.application") version "8.4.0" apply false
id("com.android.library") version "8.4.0" apply false
id("org.jetbrains.kotlin.android") version "1.9.23" apply false
}
Groovy
plugins {
id 'com.android.application' version '8.4.0' apply false
id 'com.android.library' version '8.4.0' apply false
id 'org.jetbrains.kotlin.android' version '1.9.23' apply false
}
Cuidado: não use dependências dinâmicas em números de versão, como 'com.android.tools.build:gradle:8.4.+'.
O uso desse recurso pode resultar em atualizações inesperadas e dificuldades
para resolver diferenças de versão.
Se a versão especificada do plug-in não tiver sido transferida por download, o Gradle fará o download na próxima vez que você criar o projeto ou clicar em File > Sync Project with Gradle Files na barra de menus do Android Studio.
Atualizar o Gradle
Ao atualizar o Android Studio, você pode receber uma solicitação para também atualizar o Gradle para a versão mais recente disponível. Você pode aceitar a atualização ou especificar manualmente uma versão com base nos requisitos de build do projeto.
A tabela a seguir lista qual versão do Gradle é necessária para cada versão do Plug-in do Android para Gradle. Para ter a melhor performance, use a versão mais recente possível do Gradle e do plug-in.
| Versão do plug-in | Versão mínima necessária do Gradle |
|---|---|
| 8.4 | 8,6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
| 7.4 | 7.5 |
Versões anteriores
| Versão do plug-in | Versão necessária do Gradle |
|---|---|
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7 | 7 |
| 4.2.0+ | 6.7.1 |
| 4.1.0+ | 6.5+ |
| 4.0.0+ | 6.1.1+ |
| 3.6.0 - 3.6.4 | 5.6.4+ |
| 3.5.0 - 3.5.4 | 5.4.1+ |
| 3.4.0 - 3.4.3 | 5.1.1+ |
| 3.3.0 - 3.3.3 | 4.10.1+ |
| 3.2.0 - 3.2.1 | 4.6+ |
| 3.1.0+ | 4.4+ |
| 3.0.0+ | 4.1+ |
| 2.3.0+ | 3.3+ |
| 2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
| 2.0.0 - 2.1.2 | 2.10 - 2.13 |
| 1.5.0 | 2.2.1 - 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
| 1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
Você pode especificar a versão do Gradle no menu File >
Project Structure > Project no Android Studio
ou atualizar sua versão do Gradle usando a linha de comando.
A maneira recomendada é usar a
ferramenta de linha de comando Gradle Wrapper (link em inglês),
que atualiza os scripts gradlew. O exemplo
abaixo define a versão do Gradle como 8.4 usando o Gradle Wrapper.
Execute esse comando duas vezes para fazer upgrade do Gradle e do
próprio Gradle Wrapper. Para saber mais, consulte
Como fazer upgrade do Gradle Wrapper (em inglês).
gradle wrapper --gradle-version 8.4
No entanto, esse processo pode falhar em alguns casos. Por exemplo, se você acabou de atualizar o Plug-in do Android para Gradle (AGP, na sigla em inglês)
e ele não é mais compatível com a versão atual do Gradle. Nesse caso,
é necessário editar a referência de distribuição do Gradle no arquivo
gradle/wrapper/gradle-wrapper.properties. O exemplo abaixo
define a versão do Gradle como 8.4 no arquivo
gradle-wrapper.properties.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.4-bin.zip
...
Plug-in do Android para Gradle e compatibilidade com o Android Studio
O sistema de build do Android Studio é baseado no Gradle, e o Plug-in do Android para Gradle (AGP, na sigla em inglês) adiciona vários recursos específicos para a criação de apps Android. A tabela abaixo lista qual versão do AGP é necessária para cada versão do Android Studio.
| Versão do Android Studio | Versão necessária do AGP |
|---|---|
| Coala | 01/01/2024 | 3,2-8,5 |
| Água-viva | 1/3/2023 | 3,2-8,4 |
| Iguana | 2023.2.1 | 3.2-8.3 |
| Hedgehog | 2023.1.1 | 3.2-8.2 |
| Giraffe | 2022.3.1 | 3.2-8.1 |
| Flamingo | 2022.2.1 | 3.2-8.0 |
Versões anteriores
| Versão do Android Studio | Versão necessária do AGP |
|---|---|
| Electric Eel | 2022.1.1 | 3.2-7.4 |
| Dolphin | 2021.3.1 | 3.2-7.3 |
| Chipmunk | 2021.2.1 | 3.2-7.2 |
| Bumblebee | 2021.1.1 | 3.2-7.1 |
| Arctic Fox | 2020.3.1 | 3.1-7.0 |
Para mais informações sobre as novidades do Plug-in do Android para Gradle, acesse as notas da versão.
Versões mínimas de ferramentas para um nível da API do Android
Há versões mínimas do Android Studio e do AGP que oferecem suporte a um nível
específico da API. O uso de versões do Android Studio ou do AGP que são anteriores às exigidas pelo
targetSdk ou compileSdk do projeto pode levar a problemas inesperados. Recomendamos
usar as versões de pré-lançamento mais recentes do Android Studio e do AGP para trabalhar
em projetos voltados para versões de pré-lançamento do SO Android. Além da versão estável, você também pode
instalar
versões de pré-lançamento do Android Studio.
As versões mínimas do Android Studio e do AGP são as seguintes:
| Nível da API | Versão mínima do Android Studio | Versão mínima do AGP |
|---|---|---|
| Prévia do VanillaIceCream | Água-viva | 1/3/2023 | 8.4 |
| 34 | Hedgehog | 2023.1.1 | 8.1.1 |
| 33 | Flamingo | 2022.2.1 | 7.2 |
Mudanças do controle de versões (novembro de 2020)
Estamos atualizando o número da versão do Plug-in do Android para Gradle (AGP, na sigla em inglês) para melhorar a integração com a ferramenta de build do Gradle.
Confira as principais mudanças:
O AGP agora usa um controle de versões semântico, e as alterações interruptivas são direcionadas para versões principais.
Haverá uma versão principal do AGP lançada por ano, alinhada à versão principal do Gradle.
Após o AGP 4.2, virá a versão 7.0, que exige um upgrade para o Gradle versão 7.x. Cada vez que uma versão do AGP com mudanças significativas é liberada, um upgrade de versão significativo na ferramenta Gradle se faz necessário.
O uso das APIs vai ser descontinuado com aproximadamente um ano de antecedência, e os novos recursos serão lançados nesse mesmo tempo. As APIs descontinuadas vão ser removidas cerca de um ano depois, quando houver uma atualização de larga escala.
Compatibilidade
O nível máximo da API com suporte do Plug-in do Android para Gradle 8.3 é o 34. Veja outras informações de compatibilidade:
| Versão mínima | Versão padrão | Observações | |
|---|---|---|---|
| Gradle | 8,6 | 8,6 | Para saber mais, consulte Como atualizar o Gradle. |
| Ferramentas de build do SDK | 34.0.0 | 34.0.0 | Instale ou configure as Ferramentas de build do SDK. |
| NDK | N/A | 26.1.10909125 | Instale ou configure uma versão diferente do NDK. |
| JDK | 17 | 17 | Para saber mais, consulte Como configurar a versão do JDK. |
Confira abaixo os novos recursos do Plug-in do Android para Gradle 8.4.
Versões de patch
Esta é uma lista das versões de patch do Android Studio Jellyfish e do Plug-in do Android para Gradle 8.4.
Android Studio Jellyfish | 2023.3.1 Patch 2 e AGP 8.4.2 (junho de 2024)
Atualização de segurança importante:uma vulnerabilidade de segurança no plug-in do GitHub, disponível no Android Studio Iguana | 2023.2.1 e versões mais recentes, pode expor tokens de acesso a pessoas não autorizadas.
A correção:o Jetbrains resolveu o problema nos produtos da plataforma IntelliJ, e a correção já está disponível no Android Studio Jellyfish | 2023.3.1 Patch 2 (2023.3.1.20).
Se você já tiver um build do Android Studio no Canal estável, clique em Help > Check for Updates (ou Android Studio > Check for Updates no macOS para receber a atualização). Caso contrário, faça o download do build estável mais recente.
Além disso, se você usou ativamente a funcionalidade da solicitação de envio do GitHub no ambiente de desenvolvimento integrado, recomendamos revogar todos os tokens do GitHub usados pelo plug-in. Como o plug-in pode usar a integração com OAuth ou tokens de acesso pessoal (PATs), marque ambos e revogue conforme necessário:
- Para revogar o acesso à integração OAuth, acesse Aplicativos > Apps OAuth autorizados e revogue o acesso ao token de integração do ambiente de desenvolvimento integrado da JetBrains.
- Para revogar o acesso de PATs, acesse Tokens de acesso pessoal e exclua o token emitido para o plug-in do GitHub. O nome do token padrão é plug-in de integração do IntelliJ IDEA no GitHub (link em inglês), mas você pode usar um nome personalizado.
Depois de revogar o acesso aos tokens, você precisa configurar o plug-in novamente para que todos os recursos do plug-in, incluindo as operações do Git, voltem a funcionar.
Pedimos desculpas por qualquer inconveniente e pedimos a todos os usuários que atualizem o app imediatamente para proteger o código e os dados deles.
Esta atualização secundária também inclui estas correções de bugs.
Android Studio Jellyfish | 2023.3.1 Patch 1 e AGP 8.4.1 (maio de 2024)
Esta atualização secundária inclui estas correções de bugs.
As aulas de biblioteca são reduzidas
A partir do Plug-in do Android para Gradle 8.4, se um projeto de biblioteca do Android for reduzida, as classes de programa reduzidas serão publicadas para publicação entre projetos. Isso significa que, se um app depender da versão reduzida dos subprojetos da biblioteca Android, o APK incluirá classes de biblioteca Android reduzidas. Talvez seja necessário ajustar as regras de manutenção da biblioteca caso haja classes ausentes no APK.
Caso você esteja criando e publicando um AAR, os jars locais de que sua biblioteca depende serão incluídos sem redução no AAR, o que significa que o redutor de código não será executado neles.
Para reverter ao comportamento anterior, defina
android.disableMinifyLocalDependenciesForLibraries no arquivo
gradle.properties e
registre um bug.
Versões futuras do AGP vão remover essa flag.