Cronograma de migração da DSL/API 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 Plug-in do Android para Gradle (AGP, na sigla em inglês) é o sistema de compilação compatível
com apps Android e inclui compatibilidade para compilar vários tipos diferentes de fontes
e vinculá-las em um aplicativo que pode ser executado em um dispositivo Android
físico ou um emulador.
A seção a seguir descreve a evolução planejada da DSL e da API do AGP.
À medida que novas APIs forem introduzidas em versões estáveis, as APIs antigas serão marcadas como
suspensas. Essas APIs suspensas ficarão indisponíveis na próxima
versão estável. Veja abaixo informações sobre as próximas mudanças em cada
versão principal do AGP.
Para ver um registro detalhado sobre as descontinuações ou remoções da API AGP, consulte as atualizações
da API AGP.
AGP 9.0 (segundo semestre de 2025)
Novas APIs Variant estão estáveis e as APIs antigas foram suspensas
As APIs Variant (link em inglês) que estavam em desenvolvimento nas versões 4.1 e 4.2 estão estáveis.
Todas essas interfaces estão localizadas no artefato gradle-api.
As interfaces e classes anteriores usadas na antiga API Variant foram suspensas.
Novas interfaces DSL estão estáveis, e as antigas foram suspensas
As interfaces DSL que estavam em desenvolvimento nas versões 4.1, 4.2 e 7.0 agora estão estáveis.
Todas essas interfaces estão localizadas no artefato gradle-api.
As interfaces e classes usadas anteriormente na DSL foram suspensas.
Classes AGP internas particulares ainda acessíveis
As classes internas particulares do AGP, localizadas em outros artefatos, ainda
podem ser acessadas durante a compilação de arquivos de build, mas não é recomendado
usá-las porque elas podem mudar de maneiras inesperadas a qualquer momento.
AGP 10.0 (2026)
APIs antigas foram removidas
Todas as interfaces e classes anteriores usadas no DSL e na antiga API Variant
foram excluídas.
O artefato gradle-api é o único artefato necessário para acessar as interfaces e
classes de DSL e de APIs variantes, e é necessário usá-lo ao desenvolver
plug-ins.
Usando metadados do Gradle, que oferece diferentes gráficos de dependência para compilação
e para tempo de execução, somente o artefato gradle-api está disponível durante a compilação dos arquivos
de build.
(Provisório) O acesso às classes internas particulares do AGP foi removido.
Depender do artefato
gradle
agora vai ocultar todas as classes internas e vai fornecer acesso de compilação apenas às
interfaces e classes disponíveis no artefato gradle-api. Isso afeta a
compilação do plug-in e do arquivo de build.
Não é possível adicionar manualmente uma dependência para ter acesso às classes
internas.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Android Gradle Plugin DSL/API migration timeline\n\nThe Android Gradle Plugin (AGP) is the supported build system for Android\napplications and includes support for compiling many different types of sources\nand linking them together into an application that you can run on a physical\nAndroid device or an emulator.\n\nThe following section describes the planned evolution of the AGP's DSL and API.\nAs new APIs are introduced in stable releases, old APIs will be marked as\ndeprecated. Those deprecated APIs will then become unavailable in the next\nstable release. Below you will find information about upcoming changes in each\nmajor AGP release.\n\nFor a more detailed log of AGP API deprecations or removals, see the [AGP API\nupdates](/studio/releases/gradle-plugin-api-updates).\n| **Note:** The timeframes mentioned below are estimates and are subject to change.\n\nAGP 9.0 (Second half of 2025)\n-----------------------------\n\n**New Variant APIs are stable, old APIs are deprecated**\n\n- The [Variant APIs](https://medium.com/androiddevelopers/new-apis-in-the-android-gradle-plugin-f5325742e614) that were incubating in 4.1 and 4.2 are stable.\n- All of these interfaces are located in the [`gradle-api`](https://maven.google.com/web/index.html#com.android.tools.build:gradle-api) artifact.\n- The previous interfaces and classes used in the old Variant API are now deprecated.\n\n**New DSL interfaces are stable, old ones are deprecated**\n\n- The [DSL interfaces](https://medium.com/androiddevelopers/new-apis-in-the-android-gradle-plugin-f5325742e614) that were incubating in 4.1, 4.2 and 7.0 are now stable.\n- All of these interfaces are located in the `gradle-api` artifact.\n- The previous interfaces and classes used in the DSL are now deprecated.\n\n**Private internal AGP classes still accessible**\n\nPrivate internal classes from AGP, located in other artifacts, are still\naccessible during compilation of build files, but it is **not** recommended\nto use them as they may change in breaking ways at any time.\n\nAGP 10.0 (2026)\n---------------\n\n**Old APIs are removed**\n\n- All previous interfaces and classes used in the DSL and the old Variant API are **deleted**.\n- The `gradle-api` artifact is the only artifact you need to access DSL and variant API interfaces and classes, and should be used when developing plugins.\n- Using Gradle metadata, which offers different dependency graphs for compile and runtime, only `gradle-api` artifact is available during compilation of build files.\n\n**(Tentative) Access to private internal AGP classes is removed**\n\nDependency on the\n[`gradle`](https://maven.google.com/web/index.html#com.android.tools.build:gradle)\nartifact now hides all internal classes and gives compilation access only to the\ninterfaces and classes available in the `gradle-api` artifact. This impacts both\nplugin and build file compilation.\n\nIt isn't possible to manually add a dependency to get access to the internal\nclasses.\n| **Important:** We would like your feedback on the removal of internal AGP classes. Please let us know about your use case, including specific examples of what you need access to, by submitting your feedback on this [tracking issue](https://issuetracker.google.com/219002669)."]]
