1. ما هو ولماذا تحتاجه؟

Gradle Kotlin DSL (لغة خاصة بالمجال) هي طريقة حديثة وآمنة من حيث الأنواع لكتابة نصوص البناء لـ Gradle، باستخدام لغة البرمجة Kotlin بدلاً من Groovy التقليدية. بدلاً من ملفات build.gradle، ستعمل مع ملفات build.gradle.kts، وهي نصوص Kotlin كاملة. هذا يعني أنك تحصل على جميع مزايا التصنيف الثابت: الإكمال التلقائي في بيئة التطوير (IntelliJ IDEA، Android Studio)، التحقق من الأنواع أثناء التجميع، إعادة الهيكلة، والتنقل بين الكود، مما يقلل بشكل كبير من أخطاء التكوين.

لماذا تحتاجه؟ على الرغم من مرونة Groovy DSL التقليدي، إلا أنه غالباً ما يؤدي إلى نصوص "سحرية" وأخطاء لا تُكتشف إلا أثناء التشغيل. يحل Kotlin DSL هذه المشكلة، مما يجعل تكوين البناء موثوقاً مثل كود التطبيق نفسه. يمكنك استخدام جميع إمكانيات Kotlin: الدوال اللامدا، دوال التمديد، الخصائص المفوضة، الكوروتينات (لتنفيذ المهام)، وغيرها الكثير. هذا مهم بشكل خاص في المشاريع الكبيرة التي تحتوي على مئات الوحدات، حيث يتزايد تعقيد التكوين بشكل كبير.

الاستخدام الرئيسي هو إعداد بناء مشاريع JVM: من تطبيقات وحدة التحكم البسيطة إلى تطبيقات Android متعددة الوحدات ومشاريع الخادم على Spring Boot. Kotlin DSL متوافق تماماً مع الإضافات والمهام الحالية لـ Gradle، ولكنه يتطلب استيراداً صريحاً واستخدام الأنواع. هذا يجعل عملية البناء أكثر قابلية للتنبؤ والتوثيق. إذا كنت تكتب بلغة Kotlin، فإن استخدام Kotlin DSL هو الخيار الطبيعي الذي يجعل ملف البناء جزءاً من قاعدة الكود، وليس "جسماً غريباً".

2. التثبيت

لا يتطلب Gradle Kotlin DSL تثبيتاً منفصلاً عبر مدير حزم (pip, npm). إنه جزء من توزيعة Gradle بدءاً من الإصدار 5.0. كل ما عليك فعله هو تثبيت Gradle نفسه.

الطريقة 1: التثبيت عبر SDKMAN (موصى به لنظام Linux/Mac/WSL)

# تثبيت SDKMAN
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# تثبيت أحدث إصدار من Gradle
sdk install gradle

# التحقق من التثبيت
gradle --version

الطريقة 2: التثبيت عبر Homebrew (macOS)

brew install gradle

الطريقة 3: التثبيت عبر Chocolatey (Windows)

choco install gradle

الطريقة 4: التثبيت اليدوي
قم بتنزيل التوزيعة الثنائية من الموقع الرسمي، قم بفك ضغطها، وأضف المجلد bin إلى متغير البيئة PATH.

بعد تثبيت Gradle، لإنشاء مشروع باستخدام Kotlin DSL، استخدم الأمر gradle init واختر نوع النص "Kotlin" أثناء الإعداد.

3. البداية السريعة

أنشئ ملفاً باسم build.gradle.kts في جذر مشروعك. هذا مثال بسيط لتطبيق Kotlin باستخدام JVM.

// build.gradle.kts
plugins {
    kotlin("jvm") version "1.9.22" // إصدار Kotlin
    application // إضافة لتشغيل التطبيق
}

repositories {
    mavenCentral()
}

dependencies {
    implementation(kotlin("stdlib")) // المكتبة القياسية لـ Kotlin
    // تبعية الاختبار
    testImplementation(kotlin("test"))
}

application {
    mainClass.set("MainKt") // تحديد الفئة الرئيسية
}