Notas da versão do Plug-in do Android para Gradle

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
O repositório JCenter passou a ser somente leitura em 31 de março de 2021. Para saber mais, consulte a atualização do serviço JCenter.

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 normalmente seja atualizado junto com o Android Studio, o plug-in e o resto do sistema do Gradle podem ser executados e atualizados de forma independente.

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

Para mais informações sobre o sistema de build do Gradle, consulte o Guia do usuário do Gradle (link 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 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 7.3.0 no arquivo build.gradle:

Groovy

plugins {
    id 'com.android.application' version '7.3.0' apply false
    id 'com.android.library' version '7.3.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.5.31' apply false
}

Kotlin

plugins {
    id("com.android.application") version "7.3.0" apply false
    id("com.android.library") version "7.3.0" apply false
    id("org.jetbrains.kotlin.android") version "1.5.31" apply false
}

Atenção: não use dependências dinâmicas em números de versão, por exemplo, 'com.android.tools.build:gradle:2.+'. 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 vai fazer o download da 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-inVersão mínima necessária do Gradle
8.08.0
7.47.5
7.37.4
7.27.3.3
7.17.2
77
4.2.0+6.7.1

Versões anteriores

Versão do plug-inVersão necessária do Gradle
4.1.0+6.5+
4.0.0+6.1.1+
3.6.0 - 3.6.45.6.4+
3.5.0 - 3.5.45.4.1+
3.4.0 - 3.4.35.1.1+
3.3.0 - 3.3.34.10.1+
3.2.0 - 3.2.14.6+
3.1.0+4.4+
3.0.0+4.1+
2.3.0+3.3+
2.1.3 - 2.2.32.14.1 - 3.5
2.0.0 - 2.1.22.10 - 2.13
1.5.02.2.1 - 2.13
1.2.0 - 1.3.12.2.1 - 2.9
1.0.0 - 1.1.32.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 7.5.1 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 --7.5.1

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 7.5.1 no arquivo gradle-wrapper.properties.

...
distributionUrl = "https\://services.gradle.org/distributions/gradle-7.5.1-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 adiciona vários recursos específicos para a criação de apps Android. A tabela abaixo lista qual versão do Plug-in do Android para Gradle é necessária para cada versão do Android Studio.

Versão do Android Studio Versão do plug-in necessária
Flamingo | 2022.2.1 3.2-8.0
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 saber as novidades do Plug-in do Android para Gradle, acesse as notas da versão.

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

7.3.0 (setembro de 2022)

O Plug-in do Android para Gradle 7.3.0 é uma versão principal que inclui vários novos recursos e melhorias.

Compatibilidade

Versão mínima Versão padrão Observações
Gradle 7.4 7.4 Para saber mais, consulte Como atualizar o Gradle.
Ferramentas de build do SDK 30.0.3 30.0.3 Instale ou configure as Ferramentas de build do SDK.
NDK N/A 23.1.7779620 Instale ou configure uma versão diferente do NDK.
JDK 11 11 Para saber mais, consulte Como configurar a versão do JDK.

Suporte para sistemas de build C/C++ personalizados

Agora, você pode criar um sistema de build C/C++ personalizado fazendo um script de shell que grava informações no formato de arquivo de build do Ninja (link em inglês). Para saber mais sobre sistemas de build C/C++ personalizados, consulte Integrar sistemas de build C/C++ personalizados usando o Ninja (experimental).

Captura de tela do sistema de build C/C++ personalizado

A versão mínima do plug-in do Kotlin é 1.5.20

A partir da versão 7.3.0-alpha08 do Plug-in do Android para Gradle, ele exige a versão 1.5.20 ou mais recente do plug-in do Kotlin. Para manter a compatibilidade, especifique a versão 1.5.20 ou mais recente do plug-in do Kotlin no arquivo build.gradle:

org.jetbrains.kotlin:kotlin-gradle-plugin:1.5.20

Geração de APK arquivada ativada

No AGP 7.3 e versões mais recentes, todos os Android App Bundles criados têm o Store Archival (link em inglês) ativado por padrão. O Store Archival é um novo recurso de pacote de app que, no futuro, vai permitir que usuários com pouco armazenamento gerenciem com eficiência o espaço de apps, se oferecem suporte a esse sistema de armazenamento.

Para desativar a geração de APKs arquivados, modifique o arquivo build.gradle no nível do app desta maneira:

android {
  bundle {
    storeArchive {
      enable = false
    }
  }
}

O atributo de pacote no arquivo de manifesto foi descontinuado

No AGP 7.3.0-alpha04 e versões mais recentes, se você usar o Gradle para criar seu projeto, o AGP vai gerar um aviso se você usar o atributo package no arquivo de manifesto. Para definir o namespace do seu app, use a propriedade namespace no arquivo build.gradle de módulo. Para saber mais, consulte Definir um namespace.

Para receber ajuda com a mudança para a nova DSL de namespace, use o assistente de upgrade do AGP (Tools > AGP Upgrade Assistant).

Suporte à Plataforma Android

No AGP 7.3.0-beta05 e mais recentes, a versão mínima do SDK com suporte é a 33 (é possível definir minSdk = 33). Ela representa a versão mínima do Android em que o app pode ser executado e é definido no arquivo build.gradle.