Introduzione

Pubblico di riferimento : Sviluppatore principiante-intermedio con Gradle.

Avviare un nuovo progetto di plugin Gradle può sembrare intimidatorio. Per fortuna, Gradle fornisce un potente assistente interattivo, il task`init`, che genera una struttura di progetto completa, pulita e pronta all’uso. Questa guida ti mostrerà come utilizzare questo strumento per creare una base di plugin sana, e spiegirà la struttura e ti mostrerà come avviare le prime attività di build.

Passo 1 : Avviare l’assistente di progetto

Il comando`gradle init`è il punto di partenza. Avvia una procedura guidata da riga di comando che ti pone una serie di domande per configurare il progetto.

Apri il tuo terminale in una cartella vuota e avvia:

gradle init

L’assistente ti guiderà. Ecco le scelte da fare per un plugin Gradle scritto in Kotlin:

  1. Seleziona il tipo di progetto da generare:Scegliete`Gradle plugin`.

  2. Seleziona il linguaggio di implementazione :Scegli`Kotlin`.

  3. Seleziona il DSL dello script di build:scegliete`Kotlin`.

  4. Nome del progetto:Inserisci un nome per il tuo progetto (es:`site-baker`).

  5. ID del plugin:Dai un identificatore unico al tuo plugin (es:`com.cheroliv.site-baker`)

  6. Classe plugin:Specifica il nome della classe di implementazione (es:`com.cheroliv.SiteBakerPlugin`).

Una volta terminato, Gradle genera un albero di file completo.

init gradle
Figure 1. Diagramma del processo di inizializzazione

Passo 2: Comprendere la struttura generata

L’assistente crea una struttura di progetto multi-modulo, separando il progetto radice dal codice sorgente del plugin stesso.

.
├── gradle/
│   └── wrapper/
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── plugin/
│   ├── build.gradle.kts
│   └── src/
│       ├── main/
│       │   └── kotlin/
│       │       └── com/cheroliv/SiteBakerPlugin.kt
│       ├── test/
│       │   └── kotlin/
│       │       └── com/cheroliv/SiteBakerPluginTest.kt
│       └── functionalTest/
│           └── kotlin/
│               └── com/cheroliv/SiteBakerPluginFunctionalTest.kt
└── settings.gradle.kts

File e cartelle chiave

  • settings.gradle.kts: Questo file nella radice definisce i moduli inclusi nella compilazione. Qui, include il sottoprogetto`plugin`.

[source,kotlin] ---- rootProject.name = "site-baker include("plugin") </think>


Articoli correlati