المادة 1 : إنشاء إضافة Gradle من ألف إلى ياء باستخدام الأمر gradle init
نُشر في 23 September 2025
مقدمة
يمكن أن يبدو بدء مشروع جديد للمكوّن الإضافي لـ Gradle مخيفًا. لحسن الحظ، يوفّر Gradle مساعـدًا تفاعليًا قويًا، المهمة`init`, الذي يولّد هيكل مشروع كامل، نظيف وجاهز للاستخدام. سيعرض لك هذا الدليل كيف تستخدم هذه الأداة لإنشاء قاعدة مكون إضافي صحية، ويشرح الهيكل ويعرض لك كيف تبدأ أول مهام البناء.
الخطوة 1 : تشغيل مساعد المشروع
الأمر`gradle init`هو نقطة البداية. إنها تُطلق مساعد سطر أوامر يطرح عليك سلسلةً من الأسئلة لتكوين المشروع.
افتح الطرفية في مجلد فارغ وشغّل:
gradle initسيرشدك المساعد. إليك الاختيارات التي يجب اتخاذها لمُكوّن Gradle المكتوب بلغة Kotlin:
-
اختر نوع المشروع لتوليدهاختر`Gradle plugin`.
-
اختر لغة التنفيذ:اختر`Kotlin`.
-
حدد DSL لنص سكريبت البناء:اختر`Kotlin`.
-
اسم المشروع:أدخل اسمًا لمشروعك (ex:`site-baker`).
-
معرف الإضافة:امنح إضافةً معرّفًا فريدًا (مثال:`com.cheroliv.site-baker`).
-
فئة البرنامج المساعد:حدد اسم فئة التنفيذ (مثال:`com.cheroliv.SiteBakerPlugin`).
بمجرد الانتهاء، يولّد Gradle شجرة ملفات كاملة.
مخطط عملية التهيئة
@startuml start :تشغيل `gradle init`; :Choisir "Gradle الإضافة"; :اختر "Kotlin" (لغة); :اختر "Kotlin" (DSL); :أدخل الاسم، المعرف، والصف; :تم إنشاء المشروع; stop @enduml
الخطوة 2 : فهم الهيكل المولّد
ينشئ المساعد بنية مشروع متعدد الوحدات، ويقسم المشروع الجذر عن كود مصدر المكون الإضافي نفسه.
.
├── 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ملفات ومجلدات أساسية
-
settings.gradle.kts`هذا الملف في الجذر يحدد الوحدات المشمولة في البناء. هنا، يتضمن المشروع الفرعي`plugin.
[source,kotlin] ---- اسم_المشروع = "site-baker include("plugin") ----