Pendahuluan

Sasaran : Pengembang pemula hingga menengah dengan Gradle.

Memulai proyek plugin Gradle baru bisa terasa mengancam. Untungnya, Gradle menyediakan asisten interaktif yang kuat, tugas`init`, yang menghasilkan struktur proyek lengkap, bersih, dan siap pakai. Panduan ini akan menunjukkan kepada Anda cara menggunakan alat ini untuk membuat dasar plugin sehat, menjelaskan struktur, dan menampilkan cara menjalankan tugas-build pertama.

Langkah 1 : Mulai asisten proyek

Perintah`gradle init`adalah titik awal. Dia meluncurkan asisten baris perintah yang menanyakan serangkaian pertanyaan untuk mengonfigurasi proyek.

Buka terminal Anda di folder kosong dan jalankan :

gradle init

Asisten akan memandu Anda. Berikut pilihan yang harus dilakukan untuk plugin Gradle yang ditulis dalam Kotlin:

  1. Pilih jenis proyek untuk dihasilkan:Pilih`Gradle plugin`.

  2. Pilih bahasa implementasi:Pilih`Kotlin`.

  3. Pilih DSL skrip build:Pilih`Kotlin`.

  4. Nama proyek:Masukkan nama untuk proyek Anda (contoh:`site-baker`)

  5. Id plugin:Berikan ID unik untuk plugin Anda (contoh:`com.cheroliv.site-baker`)

  6. Kelas plugin:Tentukan nama kelas implementasi (contoh:`com.cheroliv.SiteBakerPlugin`).

Setelah selesai, Gradle menghasilkan pohon file lengkap.

Diagram proses inisialisasi
@startuml
start
:Lancer `gradle init`;
:Choisir "Gradle plugin";
:Choisir "Kotlin" (langage);
:Choisir "Kotlin" (DSL);
:Saisir nom, ID, et classe;
:Projet généré;
stop
@enduml

Langkah 2: Memahami struktur yang dihasilkan

Asisten membuat struktur proyek multi-modul, memisahkan proyek root dari kode sumber plugin itu sendiri.

.
├── 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 dan folder kunci

  • settings.gradle.kts: File ini di root menentukan modul yang termasuk dalam build. Di sini, ia mencakup sub-proyek`plugin`.

[source,kotlin] ---- rootProject.name = "site-baker include("plugin") (empty)


Artikel terkait