O Plug-in do Android para Gradle 8.3.0 é uma versão principal que inclui vários novos recursos e melhorias.
Compatibilidade
O nível máximo da API para o Plug-in do Android para Gradle 8.3 é o 34. Confira outras informações de compatibilidade:
Versão mínima | Versão padrão | Observações | |
---|---|---|---|
Gradle | 8.4 | 8.4 | 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 | 25.1.8937393 | Instale ou configure uma versão diferente do NDK. |
JDK | 17 | 17 | Para saber mais, consulte Como configurar a versão do JDK. |
Confira a seguir os novos recursos do Plug-in do Android para Gradle 8.3.
Versões de patch
Esta é uma lista das versões de patch no Android Studio Iguana e no Plug-in do Android para Gradle 8.3.
Android Studio Iguana | 2023.2.1 Patch 2 e AGP 8.3.2 (abril de 2024)
Esta atualização secundária inclui estas correções de bugs.
Android Studio Iguana | 2023.2.1 Patch 1 e AGP 8.3.1 (março de 2024)
Esta atualização secundária inclui estas correções de bugs.
Suporte a catálogos de versões do Gradle
O Android Studio oferece suporte a catálogos de versões do Gradle baseados em TOML, um recurso que permite gerenciar dependências em um local central e compartilhar dependências entre módulos ou projetos. O Android Studio agora facilita a configuração de catálogos de versões usando sugestões do editor e integração com a caixa de diálogo Project Structure. Aprenda a configurar e configurar catálogos de versões do Gradle ou como migrar seu build para catálogos de versões.
Preenchimento automático de código e navegação
O Android Studio oferece preenchimento automático de código quando você está editando um catálogo de versões no
formato de arquivo TOML ou adicionando uma dependência de um catálogo de versões a um arquivo
de build. Para usar o preenchimento de código, pressione Ctrl + Espaço
(Command + Espaço no macOS). Além disso, você pode navegar rapidamente de
uma referência de dependência no arquivo build.gradle
do app para onde ela é declarada
no catálogo de versões, pressionando Ctrl+b
(Command+b no macOS).
Integração com a caixa de diálogo "Project Structure"
Se o projeto usa um catálogo de versões definido no formato de arquivo TOML, você pode editar as variáveis definidas nele com a visualização Variables da caixa de diálogo Project Structure (File > Project Structure > Variables) no Android Studio. Para cada catálogo de versões, há um menu suspenso que lista as variáveis desse catálogo. Para editar uma variável, clique no valor dela e substitua. Quando você salva essas alterações, o arquivo TOML é atualizado de acordo.
Você também pode atualizar dependências na visualização Dependencies da caixa de diálogo Project Structure (File > Project Structure > Dependencies). Para atualizar versões usando a caixa de diálogo Project Structure, navegue até o módulo e a dependência que você quer editar e atualize o campo Requested Version. Quando você salva essas alterações, o arquivo TOML é atualizado de acordo. Se a versão da dependência tiver sido definida usando uma variável, atualizar a versão diretamente dessa maneira substituirá a variável por um valor fixado no código. Esteja ciente de que a remoção de uma dependência de um arquivo de build, usando ou não a caixa de diálogo Project Structure, não remove a dependência do catálogo de versões.
Limitações e problemas conhecidos
Confira abaixo problemas ou limitações conhecidos com o suporte a catálogos de versões do Gradle no Android Studio.
Erro ao destacar declarações de alias do plug-in em arquivos de script Kotlin: quando você adiciona uma declaração de plug-in no formato
alias(libs.plugins.example)
, o editor adiciona um sublinhado vermelho na partelibs
. Esse é um problema conhecido no Gradle versões 8.0 e anteriores e será resolvido em uma versão futura do Gradle.Compatibilidade do Android Studio apenas com catálogos de versões no formato TOML. Atualmente, o suporte para preenchimento de código, navegação e caixa de diálogo "Project Structure" do Android Studio só está disponível para catálogos de versões definidos no formato de arquivo TOML. No entanto, ainda é possível adicionar um catálogo de versões diretamente no arquivo
settings.gradle
e usar as dependências dele no projeto.Sem suporte à navegação para arquivos de build KTS: a navegação para uma definição de dependência em um catálogo de versões usando Control + clique (Command + clique no macOS) ainda não tem suporte para arquivos de build criados usando o script Kotlin.
O Firebase Assistente adiciona dependências diretamente nos scripts de build: o Firebase Assistente adiciona dependências diretamente aos scripts de build, e não por meio de catálogos de versões.
A funcionalidade "Find usages" não tem suporte: ainda não há suporte para a localização de usos de uma variável de catálogo de versões em outros arquivos de build, esteja o arquivo no KTS ou no Groovy. Ou seja, usar Control + clique (Command + clique no macOS) em uma definição de variável em um catálogo de versões não leva aos arquivos de build em que a variável é usada.
A caixa de diálogo "Project Structure" no Android Studio mostra vários arquivos de catálogo se eles estiverem na pasta raiz
gradle
, mas não mostra catálogos para um build composto. Por exemplo, se você tiver dois arquivos de catálogo, um para o app e outro para um build composto, a caixa de diálogo "Project Structure" mostrará apenas o arquivo de catálogo do app. Você pode usar um build composto, mas é necessário editar o arquivo TOML diretamente.
Outros insights do SDK: problemas com a política
O Android Studio mostra avisos de lint nos arquivos build.gradle.kts
e build.gradle
e na
caixa de diálogo Project Structure para SDKs públicos que têm violações da política do Google Play
no SDK Index do Google Play. Atualize todas as
dependências que violam as políticas do Google Play, já que essas violações podem impedir
que você publique no Google Play Console no futuro. Os avisos
de violação da política complementam
os avisos de versão desatualizada
mostrados pelo Android Studio.
Suporte à versão do compileSdk do Android Studio.
O Android Studio exibirá um aviso se o projeto usar uma compileSdk
que não é
compatível com a versão atual do Android Studio. Se disponível, ele também
sugere mover para uma versão do Android Studio que ofereça suporte ao compileSdk
usado pelo projeto. Não se esqueça de que o
upgrade do Android Studio também pode exigir que você faça upgrade do AGP.
O AGP também mostra um aviso na janela de ferramentas Build se o compileSdk
usado pelo projeto não tem suporte da versão atual do AGP.
Mudanças no comportamento do lint
A partir do Plug-in do Android para Gradle 8.3.0-alpha02, ao executar o lint em um
módulo, tarefas separadas de análise do lint são executadas para os componentes principais
e de teste do módulo. O objetivo dessa mudança é melhorar o desempenho.
Para reverter para o comportamento anterior, defina
android.experimental.lint.analysisPerComponent=false
no
arquivo gradle.properties
.
Redução precisa de recursos ativada por padrão
A redução precisa de recursos, que remove entradas não usadas do
arquivo resources.arsc
e elimina arquivos de recursos não utilizados, fica ativada por padrão.
Quando essa redução está ativada, sua tabela de recursos é reduzida e
apenas as entradas de pasta res
referenciadas são incluídas no APK.
Para desativar a redução precisa de recursos, defina
android.enableNewResourceShrinker.preciseShrinking
como false
no
arquivo gradle.properties
do projeto.