Sequenza temporale della migrazione DSL/API del plug-in Android Gradle
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Il plug-in Android Gradle (AGP) è il sistema di compilazione supportato per le applicazioni Android e include il supporto per la compilazione di molti tipi diversi di origini e il loro collegamento in un'applicazione che puoi eseguire su un dispositivo Android fisico o su un emulatore.
La sezione seguente descrive l'evoluzione pianificata del DSL e dell'API di AGP.
Man mano che vengono introdotte nuove API nelle release stabili, le API precedenti verranno contrassegnate come ritirate. Queste API deprecate non saranno più disponibili nella prossima release stabile. Di seguito sono riportate informazioni sulle modifiche imminenti in ogni nuova versione dell'AGP.
Per un log più dettagliato dei ritiri o delle rimozioni delle API AGP, consulta gli aggiornamenti dell'API AGP.
AGP 9.0 (seconda metà del 2025)
Le nuove API Variant sono stabili, le vecchie API sono obsolete
Le API Variant in fase di incubazione in 4.1 e 4.2 sono stabili.
Tutte queste interfacce si trovano nell'artefatto gradle-api.
Le interfacce e le classi precedenti utilizzate nella vecchia API Variant sono ora ritirate.
Le nuove interfacce DSL sono stabili, quelle precedenti sono ritirate
Le interfacce DSL in fase di incubazione in 4.1, 4.2 e 7.0 sono ora stabili.
Tutte queste interfacce si trovano nell'artefatto gradle-api.
Le interfacce e le classi precedenti utilizzate nel DSL sono ora ritirate.
Corsi AGP interni privati ancora accessibili
Le classi interne private di AGP, situate in altri elementi, sono ancora accessibili durante la compilazione dei file di compilazione, ma non è consigliabile utilizzarle in quanto potrebbero cambiare in modo sostanziale in qualsiasi momento.
AGP 10.0 (2026)
Le API precedenti vengono rimosse
Tutte le interfacce e le classi precedenti utilizzate nel DSL e nella vecchia API Variant vengono eliminate.
L'elemento gradle-api è l'unico elemento necessario per accedere alle interfacce e alle classi dell'API DSL e delle varianti e deve essere utilizzato durante lo sviluppo dei plug-in.
Utilizzando i metadati di Gradle, che offrono diversi grafici di dipendenza per la compilazione e il runtime, durante la compilazione dei file di build è disponibile solo l'elemento gradle-api.
(Tentative) Access to private internal AGP classes is removed
La dipendenza dall'elemento
gradle
ora nasconde tutte le classi interne e concede l'accesso alla compilazione solo alle
interfacce e alle classi disponibili nell'elemento gradle-api. Ciò influisce sia sul plug-in sia sulla compilazione del file di build.
Non è possibile aggiungere manualmente una dipendenza per ottenere l'accesso alle classi interne.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
