إضافة Gradle

تجعل الإضافتان dev.elide.settings و dev.elide مهام JavaCompile في Gradle تشغّل elide javac، وتضيفان مهامًا للتنسيق ولتصدير التبعيات. ويبقى لـ Gradle حلّ التبعيات والاختبارات والتحزيم.

المتطلبات

التثبيت

يضيف الملف settings.gradle.kts مستودع Maven Central إلى مستودعات الإضافات، ويختار بيئة تشغيل Elide للبناء كله:

import dev.elide.gradle.ElideRuntimeMode

pluginManagement {
    repositories {
        mavenCentral()
        gradlePluginPortal()
    }
}

plugins {
    id("dev.elide.settings") version "1.2.0"
}

elide {
    runtime {
        mode = ElideRuntimeMode.MANAGED
        version = "1.6.0"
    }
}

كل مشروع يجب أن يُصرَّف باستخدام Elide يطبّق dev.elide دون إصدار:

// build.gradle.kts
plugins {
    id("dev.elide")
    java
}

elide {
    compiler = true
}

في Gradle 7.6، اضبط امتداد الإعدادات باستخدام configure<dev.elide.gradle.ElideSettingsExtension> { runtime { … } }.

اختيار بيئة التشغيل

elide {
    runtime {
        mode = ElideRuntimeMode.PATH
        executable = layout.projectDirectory.file("tools/elide")
    }
}

تتوفّر التنزيلات المُدارة لأنظمة Linux x86_64 و arm64، و macOS arm64، و Windows x86_64. لا يؤدي تطبيق الإضافة إلى تنزيل أي شيء أو تشغيله؛ إذ تُجهَّز بيئة التشغيل حين تحتاج إليها مهمة.

الإعداد

الكتلة elide { } في المشروع:

تتجاوز خصائص Gradle هذه الكتلة لتشغيل واحد، في الاتجاهين:

./gradlew build -Pelide.builder.javac.enable=false

المهام

تحتفظ compileJava و compileTestJava بنوعي مهمتيهما، لذا يعمل التصريف التزايدي وذاكرة البناء المؤقتة كالمعتاد.

مثال

settings.gradle.kts
build.gradle.kts
src/main/java/com/example/HelloWorld.java
src/test/java/com/example/HelloWorldTest.java

// build.gradle.kts
plugins {
    id("dev.elide")
    java
    application
}

application {
    mainClass = "com.example.HelloWorld"
}

repositories {
    mavenCentral()
}

elide {
    compiler = true
}

dependencies {
    implementation("com.google.guava:guava:33.4.8-jre")
    testImplementation("org.junit.jupiter:junit-jupiter:5.13.4")
    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

tasks.test {
    useJUnitPlatform()
}

مع ملف settings.gradle.kts من قسم التثبيت:

./gradlew clean build run

> Task :prepareElideRuntime UP-TO-DATE
> Task :elideInstall SKIPPED
> Task :clean
> Task :compileJava
> Task :jar
> Task :run
Hello, World!
> Task :compileTestJava
> Task :test
> Task :build
BUILD SUCCESSFUL in 5s
Configuration cache entry stored.

ينزّل التشغيل الأول Elide في prepareElideRuntime؛ وتعيد التشغيلات اللاحقة استخدامه.

OpenRewrite واستعلامات التبعيات

للمشاريع التي تحوي elide.pkl، راجع OpenRewrite وفهرس شيفرة التبعيات. لا تضيف إضافة Gradle مهامًا لإعادة الكتابة أو لفهرس الشيفرة؛ وتصدّر elideExportDependencies الإحداثيات والمجاميع الاختبارية، لكن ناتجها ليس مُدخلًا لـ elide index. راجع حدود إعداد المشروع قبل استخدام هذه الأوامر إلى جانب Gradle.

القيود

• لا يمرّ عبر Elide إلا تصريف Java. أما Kotlin (compileKotlin) فتستخدم مُصرّف إضافة Kotlin لـ Gradle.
• لا تدعم persistentCompiler الخيار forkOptions.jvmArgs.
• الوضع MANAGED غير متاح على macOS بمعالجات Intel؛ استخدم PATH هناك.
• لا تشمل elideFormat إلا المصادر تحت src/.