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

Esta página contém as notas da versão para prévias do Plug-in do Android para Gradle (AGP, na sigla em inglês).

Plug-in do Android para Gradle 9.0

O Plug-in do Android para Gradle 9.0 é uma nova versão principal da AGP que traz mudanças de API e comportamento.

Para atualizar para o Plug-in do Android para Gradle 9.0.0-alpha04, use o Assistente de upgrade do Plug-in do Android para Gradle no Android Studio Narwhal 4 Feature Drop | 2025.1.4.

O assistente de upgrade do AGP ajuda a preservar os comportamentos atuais ao fazer upgrade do projeto quando apropriado. Assim, é possível fazer upgrade do projeto para usar o AGP 9.0, mesmo que você não esteja pronto para adotar todos os novos padrões do AGP 9.0.

Compatibilidade

O nível máximo da API Android compatível com o Plug-in do Android para Gradle 9.0.0-alpha04 é o nível 36.

O plug-in do Android para Gradle 9.0.0-alpha04 exige o Gradle 9.0.0.

As implementações internas de DSL e a API de variantes descontinuada agora exigem ativação explícita

O Plug-in do Android para Gradle agora tem uma superfície de API definida, com APIs compatíveis definidas no artefato do Maven com.android.tools.build:gradle-api.

Para compatibilidade com plug-ins binários e scripts de build atuais, as implementações anteriores da DSL que antecedem a superfície da API definida ainda eram expostas por padrão no AGP 8.13 e versões anteriores. Isso permite que o código em plug-ins do Gradle e scripts de build acesse detalhes de implementação interna da DSL, bem como as APIs android.applicationVariants, android.libraryVariants, android.testVariants e android.unitTestVariants descontinuadas, que serão removidas em 2026 no AGP 10.

Para tornar essa transição mais visível, a API de variante legada e a DSL interna não estão acessíveis por padrão no Plug-in do Android para Gradle 9.0.0-alpha04.

É possível ativar novamente o uso da API descontinuada definindo android.newDsl=false em gradle.properties.

Durante a série alfa 9.0, vamos entrar em contato com os autores de plug-ins para ajudar na adaptação e no lançamento de plug-ins totalmente compatíveis com os novos modos. Além disso, vamos aprimorar o Assistente de upgrade do AGP no Android Studio para orientar você durante a migração.

Kotlin integrado

O Plug-in do Android para Gradle 9 inclui suporte integrado para compilar Kotlin, substituindo o plug-in do Kotlin aplicado separadamente. Isso simplifica a integração com o AGP, evitando o uso das APIs descontinuadas e melhorando o desempenho em alguns casos.

O Plug-in do Android para Gradle 9 tem uma dependência de tempo de execução do plug-in Kotlin para Gradle 2.2.0, que é a versão mínima necessária para a compatibilidade integrada com Kotlin.

É possível desativar o Kotlin integrado definindo android.builtInKotlin=false. Se você desativou a opção e também precisa usar uma versão mais antiga do plug-in do Gradle do Kotlin, force o downgrade.

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("2.0.0") } // or another version that you want to use
        }
    }
}

Mudanças de comportamento

O Plug-in do Android para Gradle 9.0 tem os seguintes novos comportamentos:

A AGP 9.0 inclui atualizações nos padrões das seguintes propriedades do Gradle. Assim, você pode preservar o comportamento do AGP 8.13 ao fazer upgrade:

android {
  buildFeatures {
    shaders = true
  }
}

Recursos removidos

O Plug-in do Android para Gradle 9.0 remove as seguintes funcionalidades:

• Suporte a apps do Wear OS incorporados
  O AGP 9.0 remove o suporte à incorporação de apps do Wear OS, que não é mais compatível com o Google Play. Isso inclui a remoção das configurações de wearApp e da DSL AndroidSourceSet.wearAppConfigurationName. Consulte Distribuir para Wear OS para saber como publicar seu app no Wear OS.
• Tarefa de relatório androidDependencies e sourceSets

DSL alterada

O Plug-in do Android para Gradle 9.0 tem as seguintes mudanças interruptivas na DSL:

• A parametrização de CommonExtension foi removida.

  Por si só, essa é apenas uma mudança incompatível no nível da origem para ajudar a evitar futuras mudanças incompatíveis no nível da origem, mas também significa que os métodos de bloco precisam ser movidos de CommonExtension para ApplicationExtension, LibraryExension, DynamicFeatureExtension e TestExtension.

  Ao fazer upgrade do projeto para o AGP 9.0, refatore o código do plug-in do Gradle que usa esses parâmetros ou os métodos de bloqueio. Por exemplo, o plug-in a seguir é atualizado para remover o parâmetro de tipo e não depender dos métodos de bloco removidos:

  AGP 8.13

  val commonExtension: CommonExtension<*, *, *, *, *, *> =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig {
          minSdk {
              version = release(28)
          }
      }
  }
  

  AGP 9.0

  val commonExtension: CommonExtension =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig.apply {
          minSdk {
              version = release(28)
          }
      }
  }
  

  Para plug-ins que têm como destino um intervalo de versões do AGP, usar o getter diretamente é compatível com versões do AGP anteriores à 9.0.

DSL removida

O Plug-in do Android para Gradle 9.0 remove:

• AndroidSourceSet.jni, porque não estava funcional.

• AndroidSourceSet.wearAppConfigurationName, já que está relacionado à remoção do suporte a apps do Wear OS incorporados.

• BuildType.isRenderscriptDebuggable, porque não estava funcional.

• ComponentBuilder.enabled. Ele foi substituído por ComponentBuilder.enable.

• DependencyVariantSelection. Ele é substituído por DependencySelection, que é exposto como kotlin.android

• Installation.installOptions(String). Ela foi substituída pela propriedade mutável de Installation.installOptions.

• VariantBuilder.targetSdk e targetSdkPreview, já que não eram significativos em bibliotecas. Use GeneratesApkBuilder.targetSdk ou GeneratesApkBuilder.targetSdkPreview em vez disso.

• O bloco experimental, mas nunca estabilizado, PostProcessing.

• ProductFlavor.setDimension, que é substituída pela propriedade dimension

• LanguageSplitOptions, que era útil apenas para o Google Play Instant, que está descontinuado.

• Variant.unitTest, já que não era aplicável ao plug-in com.android.test. unitTest está disponível nos subtipos VariantBuilder que estendem HasUnitTest.

• VariantBuilder.enableUnitTest, já que não era aplicável ao plug-in com.android.test. enableUnitTest está disponível nos subtipos VariantBuilder que estendem HasUnitTestBuilder.

• VariantBuilder.unitTestEnabled foi removido em favor de enableUnitTest, que tem um nome mais consistente, nos subtipos VariantBuilder que estendem HasUnitTestBuilder.

Propriedades do Gradle removidas

As seguintes propriedades do Gradle foram adicionadas inicialmente como formas de desativar globalmente recursos que estavam ativados por padrão.

Esses recursos foram desativados por padrão desde o AGP 8.0 ou versões anteriores. Ative esses recursos apenas nos subprojetos que os usam para uma build mais eficiente.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

APIs removidas

O Plug-in do Android para Gradle 9.0 remove:

• As APIs BaseExtension.registerTransform descontinuadas e desativadas, que permaneceram apenas para permitir a compilação com a versão mais recente do AGP enquanto o destino era a execução no AGP 4.2 ou versões anteriores.

Propriedades do Gradle aplicadas

O AGP 9.0 gera um erro se você definir as seguintes propriedades do Gradle.

O Assistente de upgrade do Plug-in do Android para Gradle não vai fazer upgrade de projetos para o AGP 9.0 que usam essas propriedades.