Plug-in do Android para Gradle 9.2.0 (abril de 2026)

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

Compatibilidade

O nível máximo da API compatível com o Plug-in do Android para Gradle 9.2 é o 37.0. Outras informações sobre compatibilidade:

Relatórios de cobertura e teste unificados

O AGP 9.2.0-alpha07 apresenta tarefas para gerar painéis HTML que consolidam resultados e cobertura de testes de vários tipos (unidade e instrumentação), módulos e variantes de build, oferecendo uma visão geral abrangente em um único painel. Para mais informações, consulte Gerar relatórios unificados de cobertura de código e Ver relatórios de teste unificados.

Mudanças no R8

As seguintes mudanças do R8 estão incluídas no AGP 9.2.0.

Semântica -keepattributes mais rigorosa para manter anotações invisíveis em tempo de execução

Anotações invisíveis do ambiente de execução não podem ser lidas durante a execução. Portanto, o D8 remove incondicionalmente as anotações invisíveis em tempo de execução, sem opção de mudar isso.

Para compatibilidade com o ProGuard, o R8 oferece suporte à saída de anotações invisíveis em tempo de execução. Mas, ao compilar para DEX, as anotações invisíveis em tempo de execução geralmente nunca são mantidas. No entanto, é uma prática comum incluir a regra conveniente -keepattributes *Annotation* (direta ou indiretamente das regras de manutenção do consumidor) para que o R8 mantenha as anotações visíveis em tempo de execução. Infelizmente, isso também acaba mantendo anotações invisíveis de tempo de execução.

Para reduzir esse problema e corresponder melhor ao comportamento do D8, os padrões -keepattributes com caracteres curinga não correspondem mais a RuntimeInvisibleAnnotations, RuntimeInvisibleParameterAnnotations e RuntimeInvisibleTypeAnnotations. Como resultado, as anotações invisíveis em tempo de execução só serão mantidas se o nome do atributo for mencionado explicitamente sem caracteres curinga.

Nenhuma das regras a seguir vai manter anotações invisíveis em tempo de execução:

-keepattributes *
-keepattributes *Annotation*
-keepattributes *Invisible*

Para manter as anotações invisíveis do tempo de execução, use a seguinte regra:

-keepattributes RuntimeInvisibleAnnotations,
                RuntimeInvisibleParameterAnnotations,
                RuntimeInvisibleTypeAnnotations

Suporte para nomes negados em regras de membros

A linguagem de configuração foi estendida para que você possa corresponder a padrões de nomes de membros negados.

Por exemplo, para corresponder a todos os métodos que não terminam em "ForTesting", use a seguinte regra:

-keepclassmembers class com.example.MyClass {
  *** !*ForTesting(...);
}

Os padrões de nome de membro também podem ser negados na pré-condição das regras -if. Se um padrão de nome de membro negado contiver caracteres curinga, eles não poderão ser referenciados novamente na regra consequente -if.

Problemas corrigidos

Plug-in do Android para Gradle 9.2.1

Plug-in do Android para Gradle 9.2.0