المادة 0 : إعداد البيئة لإنشاء إضافات Gradle
نُشر في 22 September 2025
مقدمة
لتطوير إضافات Gradle بكفاءة، من الضروري وجود بيئة تطوير مهيئة جيدًا. الإعداد الجيد سيوفر لك الوقت، ويقلل الإحباطات ويضمن تماسك بنائك.
-
Le مجموعة تطوير جافا(حزمة تطوير جافا)، لأن Gradle وJBake تعملان على JVM.
-
Un بيئة تطوير متكاملةحديث (IntelliJ IDEA) مع دعم جيد لكوتولين وGradle.
-
Gradleهو نفسه، لبدء المشاريع.
-
JBake، المحرك لموقعنا الثابت.
@startuml
!theme plain
node "آلة المطور" {
component "JDK (JVM)" as JDK
component "IntelliJ IDEA" as IDE
component "Gradle (عالمي)" as Gradle
component "JBake (عالمي)" as JBake
IDE --> JDK : يستخدم
Gradle --> JDK : يستخدم
JBake --> JDK : يستخدم
}
@enduml
JDK: محرك Gradle
Gradle هو تطبيق يعمل على ماكينة جافا الافتراضية (JVM). وبالتالي، فإن تثبيت JDK هو شرط أساسي مطلق.
أي نسخة تختار؟
يُوصى باستخدام نسخة LTS (دعم طويل الأمد) من Java. في الوقت الحالي،JDK 17 ou مجموعة تطوير جافا 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. البيئة المتكاملة للتطوير : IntelliJ IDEA
لتطوير إضافات Gradle باستخدام DSL Kotlin,IntelliJ IDEAهو أداة الاختيار إن تكامله مع Gradle وKotlin لا يُضاهى.
-
الإصدار المجتمعي :مجانًا وتُعد أكثر من كافية للبدء
-
الطبعة النهائية :مدفوعةً، تقدم ميزات متقدمة لتطوير الويب وقاعدة البيانات
قم بتنزيل النسخة التي تناسبك من موقع JetBrains : https://www.jetbrains.com/idea/download/
سيكتشف الـ IDE تلقائيًا ملفاتك`build.gradle.kts` et settings.gradle.kts, يقدم لك إكمالًا تلقائيًا قويًا، وتنقلًا في الكود، وأدوات تصحيح أخطاء مدمجة.
3. Gradle : أداة البناء
حتى لو سيستخدم كل مشروع نسخه الخاصة من Gradle عبر Gradle Wrapper، فإن وجود تثبيت عام لـ Gradle يكون مفيدًا للمهام مثل تهيئة المشاريع الجديدة (gradle init)")
تثبيت عبر SDKMAN!
كما هو الحال بالنسبة لـ JDK، فإن SDKMAN! يَبسط تثبيت Gradle.
تثبيت Gradle
sdk install gradleالتحقق من التثبيت
gradle -vسيُظهر هذا الأمر إصدارات Gradle وKotlin وGroovy وJDK المستخدمة.
JBake: مولد المواقع الثابتة
JBake هو الأداة التي سنستخدمها لتحويل ملفاتنا المصدرية (مثل هذا الملف) إلى موقع ويب ثابت. الحصول على تثبيت محلي مفيد لمعاينة التغييرات.
التثبيت عبر SDKMAN!
كما هو الحال مع الأدوات الأخرى، SDKMAN! هي أبسط طريقة.
تثبيت JBake
sdk install jbakeالتحقق من التثبيت
jbake -vسيُظهر هذا الأمر نسخة JBake ومعلومات بيئة Java التي يستخدمها.
5. ملف Gradle Wrapper: الممارسة المطلقة
بعد إنشاء مشروعك (والذي سنراه في المقال التالي)، لا ينبغي لك بعد ذلك استخدام الأمر العام`gradle`. بدلاً من ذلك، ستستخدمغلاف Gradle(./gradlew), سكريبت مضمّن في مشروعك.
لماذا؟
-
قابلية التكاثر :الغلاف يضمن أن كل شخص يعمل على المشروع (بما في ذلك خادم CI/CD الخاص بك) يستخدم بالضبط الـنفس نسخة من Gradle، وبالتالي يلغي أخطاء البناء الناتجة عن بيئات مختلفة.
-
البساطة :لا تحتاج إلى تثبيت Gradle يدويًا للمساهمة في مشروع.
ما عليك سوى استنساخ المستودع وتشغيله`./gradlew`.
سيظهر الأمر النمطي هكذا:
# Ne pas faire : gradle build
# À faire :
./gradlew build6. Docker وPortainer: للبناءات القابلة للتكرار (اختياري)
على الرغم من أن Docker وPortainer ليست ضرورية بشكل صارم لكتابة مكوّن إضافي، إلا أنهما أدوات DevOps moderna تُسهّل بشكل كبير إنشاء بنى قابلة للتكرّر وإدارة بيئتك.
تثبيت محرك Docker
دُوكر يتيح لك تعبئة تطبيقك وتبعياته داخل حاوية.
تثبيت Docker عبر النص البرمجي الرسمي :
curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.shإدارة Docker بدون sudo (موصى به) :
أضف مستخدمك إلى المجموعة`docker`.
sudo usod -aG docker $USERdocker run hello-worldإدارة Docker مع Portainer (واجهة المستخدم الرسومية)
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، وبيئة تطوير متكاملة مناسبة، وGradle، وJBake. مع إضافة Docker، أنت أيضًا مستعد لإنشاء بنى حاوية وقابلة للتكرار. هذه القاعدة الصلبة ستسمح لك بالتركيز على ما هو أساسي : تطوير إضافات قوية ومفيدة.
في المقالة القادمة، سنستخدم الأمر`gradle init`لإنشاء الهيكل لمشروعنا الأول للمكوّن الإضافي.