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

Il plug-in Android per Gradle (AGP) è il sistema di build supportato per le applicazioni Android e include il supporto per compilare molti tipi diversi di fonti e collegarli tra loro in un'applicazione che puoi eseguire su un emulatore o un dispositivo Android fisico.

La seguente sezione descrive l'evoluzione pianificata delle API e DSL di AGP. Man mano che vengono introdotte nuove API nelle release stabili, le API precedenti verranno contrassegnate come deprecate. Queste API deprecate non saranno più disponibili nella prossima release stabile. Di seguito troverai informazioni sulle modifiche imminenti a ogni versione principale di AGP.

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

AGP 9.0 (metà 2024)

Le nuove API Variant sono stabili, mentre le API precedenti sono deprecate

  • Le API Variant che erano in fase di incubazione nelle versioni 4.1 e 4.2 sono stabili.
  • Tutte queste interfacce si trovano nell'elemento gradle-api.
  • Le interfacce e le classi precedenti utilizzate nell'API Variant precedente ora sono deprecate.

Le nuove interfacce DSL sono stabili, mentre quelle precedenti sono state ritirate

  • Le interfacce DSL che stavano incubando nelle versioni 4.1, 4.2 e 7.0 ora sono stabili.
  • Tutte queste interfacce si trovano nell'elemento gradle-api.
  • Le precedenti interfacce e classi utilizzate in DSL sono state ritirate.

Classi AGP interne private ancora accessibili

Le classi interne private di AGP, che si trovano in altri artefatti, sono comunque accessibili durante la compilazione dei file di build, ma non è consigliabile utilizzarle, perché potrebbero cambiare in modo più efficace in qualsiasi momento.

AGP 10.0 (2025)

Le API precedenti vengono rimosse

  • Tutte le interfacce e le classi precedenti utilizzate nella DSL e nell'API Variant precedente vengono eliminate.
  • L'artefatto gradle-api è l'unico di cui hai bisogno per accedere alle interfacce e alle classi DSL e dell'API variante e deve essere utilizzato durante lo sviluppo dei plug-in.
  • Utilizzando i metadati Gradle, che offre diversi grafici delle dipendenze per la compilazione e il runtime, durante la compilazione dei file di build è disponibile solo l'artefatto gradle-api.

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

La dipendenza dall'artefatto gradle ora nasconde tutte le classi interne e consente alla compilazione di accedere solo alle interfacce e alle classi disponibili nell'artefatto gradle-api. Questo influisce sulla compilazione dei plug-in e del file di build.

Non è possibile aggiungere manualmente una dipendenza per ottenere l'accesso alle classi interne.