Εισαγωγή

Στόχος : Προγραμματιστές που θέλουν να αρχίσουν τη δημιουργία προσθηκών Gradle.

Για την αποτελεσματική ανάπτυξη προσθέτων Gradle, απαιτείται ένα καλά διαμορφωμένο περιβάλλον ανάπτυξης. Μια καλή ρύθμιση θα σας εξοικονομήσει χρόνο, θα μειώσει τις απογοητεύσεις και θα διασφαλίσει την συνέπεια των builds σας.

Αυτός ο οδηγός εστιάζει σε τέσσερις θεμελιώδους στύλους :
  1. Le JDK(Java Development Kit), επειδή το Gradle και το JBake τρέχουν πάνω στη JVM.

  2. Un IDEσύγχρονη (IntelliJ IDEA) με καλή υποστήριξη για το Kotlin και το Gradle.

  3. Gradleαυτός, για να αρχικοποιήσει τα έργα.

  4. JBake, ο μηχανισμός του στατικού μας ιστότοπου.

gradle env
Figure 1. Composants του περιβάλλοντος της ανάπτυξης

1. Το JDK: Η μηχανή του Gradle

Gradle είναι μια εφαρμογή που εκτελείται στην εικονική μηχανή Java (JVM). Επομένως, η εγκατάσταση ενός JDK είναι απόλυτη προϋπόθεση.

Ποια έκδοση να επιλέξετε ?

Συνιστάται η χρήση μιας έκδοσης LTS (Long-Term Support) της Java. Στο παρόν,JDK 17 ou JDK 21είναι εξαιρετικές επιλογές.

Εγκατάσταση μέσω SDKMAN! (Συνιστάται)

Το SDKMAN! είναι ένα εξαιρετικό εργαλείο για τη διαχείριση των εκδόσεων πολλών SDK, συμπεριλαμβανομένου του Java και του Gradle.

Εγκαταστήστε το SDKMAN!

curl -s "https://get.sdkman.io" | bash source "$HOME/.sdkman/bin/sdkman-init.sh"

Εγκαταστήστε μια έκδοση του JDK

# Pour lister les versions de Java disponibles sdk list java

# Pour installer Java 17 (par exemple, la distribution Temurin)
sdk install java 17.0.8-tem

Επαλήθευση της εγκατάστασης

java -version

Πρέπει να δείτε την έκδοση που μόλις εγκαταστήσατε να εμφανίζεται.

2. Το IDE : IntelliJ IDEA

Για την ανάπτυξη των προσθέτων Gradle με το DSL Kotlin,IntelliJ IDEAείναι το εργαλείο της επιλογής. Η ενσωμάτωση του με το Gradle και το Kotlin είναι ανυπότακτη.

  • Εκδοση Κοινοτότητας :Δωρεάν και αρκετά επαρκή για να αρχίσουμε.

  • Τελική Έκδοση :Πληρωμένη, προσφέρει προηγμένες λειτουργίες για την ανάπτυξη ιστοσελίδων και βάσεων δεδομένων.

Κατεβάστε την έκδοση που ταιριάζει στην περίπτωσή σας από τον ιστότοπο του JetBrains: https://www.jetbrains.com/idea/download/

Το IDE θα ανιχνεύσει αυτόματα τα αρχεία σας`build.gradle.kts` et settings.gradle.kts, προσφέροντας σας μια ισχυρή αυτοπλήρωση,periήγηση στον κώδικα και ενσωματωμένα εργαλεία αποσφαλμάτωσης.

3. Gradle : Το εργαλείο build

Αν και κάθε έργο θα χρησιμοποιήσει τη δική του έκδοση του Gradle μέσω του Gradle Wrapper, είναι χρήσιμο να υπάρχει μια καθολική εγκατάσταση του Gradle για εργασίες όπως η αρχικοποίηση νέων project (gradle init)

Εγκατάσταση μέσω SDKMAN!

Όπως και για το JDK, το SDKMAN! απλοποιεί την εγκατάσταση του Gradle.

Εγκατάσταση Gradle

sdk install gradle

Επαληθεύστε την εγκατάσταση

gradle -v

Αυτή η εντολή θα εμφανίσει τις εκδόσεις του Gradle, Kotlin, Groovy και του JDK που χρησιμοποιούνται.

4. JBake : Το γεννήτορα στατικών ιστοσελίδων

JBake είναι το εργαλείο που θα χρησιμοποιήσουμε για να μετατρέψουμε τα αρχεία πηγής μας (όπως αυτό) σε έναν στατικό ιστότοπο. Το να έχετε μια τοπική εγκατάσταση είναι πρακτικό για την προεπισκόπηση των αλλαγών.

Εγκατάσταση μέσω SDKMAN!

Ως και για τα άλλα εργαλεία, το SDKMAN! είναι η πιο απλή μέθοδος.

Εγκαταστήστε JBake

sdk install jbake

Έλεγχος εγκατάστασης

jbake -v

Αυτή η εντολή θα εμφανίσει την έκδοση του JBake και τις πληροφορίες του Java περιβάλλοντος που χρησιμοποιεί.

5. Το Gradle Wrapper : Η απόλυτη καλή πρακτική

Μια φορά που το έργο σας δημιουργηθεί (όπως θα δούμε στο επόμενο άρθρο), δεν θα πρέπει πλέον να χρησιμοποιείτε την παγκόσμια εντολή.gradle. Αντίθετα, θα χρησιμοποιήσετε τοGradle Wrapper(./gradlew), ένα script που συμπεριλαμβάνεται στο έργο σας.

Γιατί?

  • Αναπαραγωγιμότητα :Ο Wrapper εγγυάται ότι κάθε άτομο που εργάζεται στο έργο (συμπεριλαμβανομένου του διακομιστή CI/CD σας) χρησιμοποιεί ακριβώς τοίδια έκδοση του Gradle, αποτρέποντας άρα τα σφάλματα κατασκευής που προκύπτουν λόγω διαφορετικών περιβαλλόντων.

  • Απλότητα :Δεν χρειάζεται να εγκαταστήσετε το Gradle χειροκίνητα ώστε να symbállete σε ένα έργο.

Αρκεί να κλώνετε το αποθετήριο και να το τρέξετε`./gradlew`.

Μια τυπική εντολή θα μοιάζει έτσι :

# Ne pas faire : gradle build
# À faire :
./gradlew build

6. Docker και Portainer: Για αναπαραγώγιμες κατασκευές (Προαιρετικό)

Αν και δεν είναι αυστηρά απαραίτητα για τη γραφή ενός plugin, το Docker και το Portainer είναι σύγχρονα DevOps εργαλεία που διευκολύνουν σημαντικά τη δημιουργία επαναπαράγιμων builds και τη διαχείριση του περιβάλλοντος σας.

Εγκατάσταση Docker Engine

Ο Docker σας επιτρέπει να πακετάρετε την εφαρμογή σας και τις εξαρτήσεις της μέσα σε ένα κοντέινερ.

Εγκαταστήστε το Docker μέσω του επίσημου σεναρίου:

curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh

Διαχείριση Docker χωρίς sudo (προτεινόμενο) :

Προσθέστε τον χρήστη σας στην ομάδα`docker`.

sudo usod -aG docker $USER
docker run hello-world

Διαχείριση Docker με Portainer (GUI)

Ο Portainer είναι ένας ελαφρύς διαδικτυακός περιβάλλον για τη διαχείριση των κοντέινερ Docker σας.

Δημιουργήστε ένα όγκο για τα δεδομένα του Portainer :

docker volume create portainer_data

Εκκίνηση του κοντέινερ Portainer :

docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

Μπορείτε τώρα να προσπείρατε τη διεσάνυση του Portainer σε`https://localhost:9443`.

Συμπέρασμα

Το περιβάλλον σου είναι έτοιμο τώρα! Έχετε ένα JDK, το πιο κατάλληλο IDE, το Gradle και το JBake. Με την προσθήκη του Docker, είστε επίσης έτοιμοι να δημιουργήσετε κοντέινερ- και αναγογιμές κατασκευές. Αυτή η ισχυρή βάση θα σας επιτρέψει να εστιάσετε στο ουσιώδες: την ανάπτυξη ισχυρών και χρήσιμων plugin.

Στο επόμενο άρθρο, θα χρησιμοποιήσουμε την εντολή`gradle init`για να δημιουργήσει τη δομή του πρώτου έργου plugin μας.

Σχετικά άρθρα