Sequenza temporale della migrazione DSL/API del plug-in Android Gradle

Android Gradle Plugin (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 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, quelle precedenti verranno contrassegnate come obsolete. Queste API deprecate non saranno più disponibili nella successiva release stabile. Di seguito troverai informazioni sulle modifiche imminenti in ogni versione principale di AGP.

Per un log più dettagliato dei ritiri o delle rimozioni delle API AGP, consulta gli aggiornamenti delle API AGP.

AGP 9.0 (gennaio 2026)

Le nuove API per le varianti sono stabili, le vecchie API sono obsolete

  • Le API Variant in fase di incubazione nelle versioni 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 obsolete e richiedono l'attivazione esplicita per essere utilizzate.

Le nuove interfacce DSL sono stabili, quelle precedenti sono ritirate

  • Le interfacce DSL in fase di incubazione nelle versioni 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 obsolete e richiedono l'attivazione esplicita per essere utilizzate.

Classi AGP interne private ancora accessibili

Le classi interne private di AGP, che si trovano in altri artefatti, sono ancora accessibili durante la compilazione di file di build e plug-in, ma non è consigliabile utilizzarle perché potrebbero cambiare in modo incompatibile in qualsiasi momento.

AGP 10.0 (fine 2026)

Rimozione delle API precedenti

  • Tutte le interfacce e le classi precedenti utilizzate nel DSL e nella vecchia API Variant sono eliminate.
  • L'artefatto gradle-api è l'unico artefatto necessario per accedere alle interfacce e alle classi API DSL e varianti e deve essere utilizzato durante lo sviluppo dei plug-in.

(Provvisorio) L'accesso alle classi AGP interne private viene rimosso

La dipendenza dall'artefatto gradle ora nasconde tutte le classi interne e concede l'accesso alla compilazione solo alle interfacce e alle classi disponibili nell'artefatto gradle-api. Ciò influisce sulla compilazione dei plug-in.

Non è possibile aggiungere manualmente una dipendenza per accedere alle classi interne.