Java و Kotlin مع Elide

يُصرّف Elide شيفرة Java (حتى JDK 25) و Kotlin (2.5.0-Beta1) وينسّقها ويبنيها ويختبرها، ويحلّ تبعيات Maven.

لا حاجة إلى تثبيت JDK

تأتي أدوات JDK و Kotlin مع Elide؛ فلا تحتاج إلى JDK منفصل أو مُصرّف Kotlin أو أداة بناء.

تشغيل ملف مصدري

يُصرَّف الملف الذي يحتوي على نقطة دخول main ويُشغَّل مباشرة:

elide run Hello.java
elide run Hello.kt

استخدام الأدوات منفردة

تعمل elide java و elide javac و elide kotlinc و elide jar مثل الأدوات التي تحمل أسماءها. تأتي الوسائط بعد --:

elide javac -- -d target src/main/java/app/Main.java
elide kotlinc -- -d target src/main/kotlin/app/Main.kt
elide java -- -cp target app.Main

يُنسّق elide format شيفرة Java باستخدام Google Java Format وشيفرة Kotlin باستخدام ⁦ktfmt:⁩

elide format -- src                          # rewrite files
elide format --list-files -- --dry-run src   # list files that would change; exit 1 if any

إنشاء مشروع

elide init --plain --skip-defaults --template java

القالب	يُنشئ
`java`	مشروع Java.
`ktjvm`	مشروع Kotlin.
`workspace`	مكتبة Kotlin وتطبيقًا يعتمد عليها.

لترحيل مشروع Maven أو Gradle، يُشغّل elide adopt وكيل برمجة بالذكاء الاصطناعي؛ راجع اعتماد مشروع قائم.

بناء مشروع

elide install   # resolve Maven dependencies
elide build     # compile and assemble artifacts
elide test      # run JUnit tests
elide run       # run the project's main class

~/demo  elide build

[10.5s] ✓ Resolved 7 Maven dependencies (10.4s)

[10.6s] ✓ Compiled 1 main Kotlin source file (128ms)

[10.6s] ⇥ Java main compilation skipped (No sources)

[10.6s] ✓ Build successful in 10.6s

~/demo  elide run

[ 11ms] ⇥ Dependencies ready (Up to date)

[ 12ms] ⇥ Kotlin main compilation skipped (Up to date)

[ 12ms] ⇥ Java main compilation skipped (Up to date)

Hello from Kotlin!

[ 69ms] ✓ JVM main application completed successfully (57ms)

[ 74ms] ✓ Build successful in 64ms

~/demo  elide build

[ 12ms] ⇥ Dependencies ready (Up to date)

[ 12ms] ⇥ Kotlin main compilation skipped (Up to date)

[ 12ms] ⇥ Java main compilation skipped (Up to date)

[ 29ms] ✓ Build successful in 19ms

0:23 / 0:23

يسرد elide build --inspect مهام المشروع. ملف البيان: إعداد المشروع. خيارات المُصرّف والتحزيم: سلسلة أدوات JVM.

ما يمكن للبرامج استخدامه

يمكن للبرامج استخدام JDK، ومكتبة Kotlin القياسية، ومكتبات kotlinx المضمّنة، و JUnit للاختبارات، والتعليقات التوضيحية الخاصة بـ Elide؛ ولا توجد واجهة برمجية لبيئة تشغيل Elide ولا استدعاءات إلى JavaScript أو Python. راجع واجهات JVM البرمجية. لاستخدام قاعدة بيانات، أضف برنامج تشغيل JDBC الخاص بها كتبعية Maven (قواعد البيانات)؛ ولمشاركة مكتبة، راجع النشر إلى Maven.

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

لا تحصل برامج Java و Kotlin التي يشغّلها Elide من Elide على واجهة OpenTelemetry البرمجية ولا على وكيله ولا على سياق التتبع. أضف OpenTelemetry Java SDK أو الوكيل إلى البرنامج كما في أي JVM. ولا يزال elide build و elide test يصدّران نطاقات التتبع (spans) الخاصة بهما؛ راجع OpenTelemetry.

إعادة كتابة الشيفرة وفحصها

في المشاريع التي تحتوي على elide.pkl، يعاين OpenRewrite وصفات Java ويطبّقها، ويعثر فهرس شيفرة التبعيات على أصول الأصناف ويفحص الأعضاء ويستعلم عن مراجع Java و Kotlin المُصرَّفة. كلاهما تجريبي في الإصدار 1.6.0.

أمثلة

ابدأ من قالب:

elide init --template java        # Java app with a JUnit test
elide init --template ktjvm       # Kotlin app with a test
elide init --template workspace   # Kotlin library and app in one workspace