إضافة IntelliJ IDEA

تستورد إضافة Elide مجلدًا فيه elide.pkl كما يستورد IntelliJ IDEA مشروع بناء Maven أو Gradle، وتشغّل وتختبر وتصحّح الأخطاء عبر واجهة سطر الأوامر elide.

المتطلبات

المتطلب	ملاحظات
IntelliJ IDEA 2025.3 أو أحدث	إصدار Community أو Ultimate، مع إضافتي Java و Kotlin المضمّنتين. وتتطلب شيفرة Kotlin على Elide 1.6 الإصدار 2026.2 من IntelliJ IDEA أو أحدث، إذ تقرأ إضافة Kotlin فيه مكتبات Kotlin 2.5.
Elide	يُعثر عليه عبر إعداد Elide distribution في المشروع. ويتطلب Elide 1.6 الإضافة 0.9.3 أو أحدث.
JDK مسجّل في بيئة التطوير	لمشاريع JVM.
إضافة Pkl (اختيارية)	الإكمال والتنقل والفحوص في `elide.pkl`.

التثبيت

في Settings → Plugins → ⚙ → Manage Plugin Repositories، أضف:

https://plugins.elide.dev/intellij

ثبّت Elide من تبويب Marketplace وأعد تشغيل بيئة التطوير. وثبّت Pkl من المستودع نفسه لتحرير elide.pkl. كما تُرفق ملفات ZIP للإضافة بكل إصدار على GitHub.

استيراد مشروع

افتح مجلدًا يحتوي على elide.pkl (إعداد المشروع). تربطه الإضافة وتزامنه في الخلفية.

IntelliJ IDEASync and the Elide tool window0:18Add a dependency to elide.pkl, sync the change, find it under the module's Dependencies.

تصبح كل مجموعة مصادر وحدة، وتصبح التبعيات مكتبات مُرفقًا بها مصادرها وتوثيقها.
يكون SDK المشروع هو JDK الخاص بـ jvm.target، أو أحدث JDK مثبّت.
يؤدي تحرير elide.pkl أو ملف القفل إلى اقتراح إعادة التحميل.
تعرض نافذة الأدوات Elide المشاريع المرتبطة ووحداتها وأهداف البناء تحت Tasks، ويمكن تشغيلها من الشجرة.

ينشئ File → New → Project → Elide مشروعًا من القوالب التي يقدّمها elide init.

مساحات العمل

يُستورد ملف البيان الذي يعلن workspace.members كمشروع واحد. ويحصل كل عضو على وحداته و classpath و JDK الخاصة به، وتصبح تبعية project("name") تبعية وحدة، فتصرّف بيئة التطوير الشيفرة وتتنقل عبر الأعضاء. ولا يُربط إلا الجذر؛ ويؤدي تحرير ملف بيان أحد الأعضاء إلى إعادة تحميل مساحة العمل. راجع مساحات العمل.

التشغيل

أنشئ إعداد تشغيل من نوع Elide. يقبل سطر الأوامر فيه كل ما تقبله واجهة سطر الأوامر، مع إكمال الأوامر والخيارات ونقاط الدخول ومهام البناء في المشروع:

run
test -t 'MyTest'
build -- --flag-for-the-tool
serve --port 8080

IntelliJ IDEARun from the gutter0:09Run icons on main functions and on elide.pkl entries start an Elide run configuration.

أيقونة الهامش على	الإجراءات
دالة `main` في Kotlin أو Java	Run، Debug
صنف أو دالة اختبار JUnit	Run، Debug
`jvm.main` و `entrypoint` و `scripts` في `elide.pkl`	Run، Debug (إضافة Pkl)
إدخالات `artifacts` في `elide.pkl`	Build؛ وللملف الثنائي من Native Image أيضًا Run، Debug (إضافة Pkl)

يقبل Run Anything (ضغط Ctrl مرتين) الأمر elide …. ويرسل elide build تقاريره إلى نافذة الأدوات Build في شجرة خطوات مع الأزمنة وتشخيصات المُصرّف؛ وترسل الأوامر الأخرى تقاريرها إلى Run.

الاختبار

يرسل إعداد elide test تقاريره إلى مشغّل الاختبارات: شجرة بحالات النجاح والفشل والتخطي، والأزمنة، والمخرجات، والانتقال إلى المصدر لاختبارات JVM.

IntelliJ IDEATest results0:10elide test reports into the test runner, with jump to source.

يضيف Run with Coverage الخيار --coverage ويحمّل تقارير JaCoCo و LCOV في عرض التغطية، بما في ذلك تقارير عمليات التشغيل التي بدأت خارج بيئة التطوير.

IntelliJ IDEARun with Coverage0:11Run with Coverage loads the JaCoCo report into the Coverage view and marks covered lines.

تصحيح الأخطاء

يضيف Debug على إعداد تشغيل أو اختبار من نوع Elide الخيار --debugger ويُرفق مصحّح JVM في بيئة التطوير على المنفذ 5005. وهو يصحّح شيفرة JVM؛ أما للغات JavaScript و TypeScript و Python فاستخدم مصحّح CDP أو DAP الموصوف في تصحيح الأخطاء.

IntelliJ IDEADebug a run configuration0:13Debug adds --debugger and attaches the IDE's JVM debugger.

يبني Run Native Image و Debug Native Image على مُخرَج Native Image ذلك المُخرَج، ثم يشغّلان الملف الثنائي أو يصحّحان أخطاءه باستخدام GDB أو LLDB. ويتطلب تصحيح الأخطاء إضافة Native Debugging Support (في IntelliJ IDEA Ultimate) و -g في options.flags الخاصة بالمُخرَج؛ ولا تحمل الصور معلومات التصحيح إلا على Linux.

الإعدادات

Settings → Build, Execution, Deployment → Build Tools → Elide:

الإعداد	الأثر
Elide distribution	Auto-detect أو مسار مخصّص.
Native Image debugging	المصحّح (Auto أو GDB أو LLDB) والملف التنفيذي لـ GDB.

يفحص الاكتشاف التلقائي $ELIDE_HOME، ثم:

المنصة	المواقع، بالترتيب
Unix	`$XDG_DATA_HOME/elide`، `~/.local/share/elide`، `/opt/elide/current`، `~/.elide`
Windows	`%LOCALAPPDATA%\elide`، `%ProgramFiles%\Elide`، `%USERPROFILE%\.local\share\elide`، `%USERPROFILE%\.elide`