امتداد VS Code

يحوّل امتداد Elide أي مجلد فيه elide.pkl إلى مشروع VS ⁦Code:⁩ فهو يزامن التبعيات ومجموعات المصادر مع خادم لغة Kotlin، ويشغّل ويختبر ويصحّح الأخطاء عبر واجهة سطر الأوامر elide.

المتطلبات

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

التثبيت

curl -LOJ "https://plugins.elide.dev/vscode/files?id=elide.elide"
code --install-extension elide-*.vsix

يرشدك Help → Get Started → Get started with Elide خلال التثبيت والمشروع والمزامنة والتشغيل والاختبار.

مزامنة مشروع

يُزامَن أي مجلد فيه elide.pkl عند فتحه: يحلّ Elide ملف البيان، ويثبّت التبعيات إذا كان ملف القفل قديمًا، ويكتب workspace.json لخادم لغة Kotlin. أضف workspace.json إلى .gitignore.

انقر عنصر شريط الحالة لفتح قائمة ⁦Elide:⁩ المزامنة، وتشغيل أمر، وتشغيل كل الاختبارات، وفتح elide.pkl أو المخرجات. وعندما يتغيّر elide.pkl يقترح الامتداد إعادة التحميل (elide.sync.onManifestChange).

الشريط الجانبي لـ Elide

يعرض عرض Elide في شريط النشاط كل مشروع:

الدعم الذكي للشيفرة

يأتي الإكمال والتنقل والتشخيصات للغتي Kotlin و Java من خادم لغة Kotlin، الذي يستورد workspace.json المتزامن: وحدة لكل مجموعة مصادر، وكل مكتبة مع مصادرها، و JDK، وخيارات Kotlin في ملف البيان.

• تُثبَّت ملفات JAR للمصادر لحزم Maven المعلنة، فيفتح Go to Definition شيفرة المكتبة (elide.install.classifiers).
• يُؤخذ JDK من elide.jdk.home، ثم من jvm.javaHome أو $JAVA_HOME أو JDK مثبّت يطابق jvm.target.
• يمكن أن تحتفظ نسخة المستودع بمجلد .idea الخاص بـ ⁦IntelliJ:⁩ إذ يضبط الامتداد intellij.buildTool على json في إعدادات مساحة العمل، فيقرأ كل محرر نموذجه الخاص.

التشغيل

تشغّل عدسات الشيفرة ما يعلنه المشروع:

عمليات التشغيل مهام في VS Code من النوع elide؛ وتظهر أخطاء المُصرّف في Problems على الملف والسطر المذكورين.

في .vscode/tasks.json:

{ "type": "elide", "command": "test", "args": ["src/api"], "options": { "bail": 3 } }

الاختبار

تظهر اختبارات JUnit في مجموعات مصادر الاختبار في عرض Testing، مع أيقونات في الهامش على كل صنف ودالة. ويستدعي التشغيل elide test --reporter=tap للتحديد ويبلّغ عن كل اختبار فور انتهائه؛ ويعرض الاختبار الفاشل رسالة التأكيد ورابطًا إلى السطر الفاشل.

يشغّل ملف التعريف Debug الاختبارات نفسها تحت المصحّح.

يشغّل Run with Coverage التحديد مع --coverage ويعرض النتيجة في هامش المحرر وفي عرض Test Coverage: للغتي JavaScript و TypeScript من LCOV، وللغتي Java و Kotlin من تقرير JaCoCo بصيغة XML. اطلب تقرير XML في elide.pkl:

import "elide:Coverage.pkl" as Coverage

coverage {
  jvm {
    reports { Coverage.xmlReport() }
  }
}

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

يبدأ Debug with Elide الأمر elide run --debugger ويتصل به. وتوقف نقاط التوقف في مصادر Kotlin و Java البرنامج؛ وإنهاء الجلسة يوقف Elide.

في .vscode/launch.json:

{
  "type": "elide",
  "request": "launch",
  "name": "Elide: Run (debug)",
  "entrypoint": "src/main/kotlin/shop/Main.kt"
}

يختار elide.debug.adapter المصحّح: intellij (افتراضي، من امتداد Kotlin) أو java (Debugger for Java). ويستمع المصحّح على المنفذ 5005، لذا تعمل جلسة واحدة فقط في كل مرة. ولتصحيح أخطاء JavaScript و TypeScript و Python عبر CDP و DAP، راجع تصحيح الأخطاء.

Native Image

يبني نوع الإطلاق elide-native مُخرَج Native Image ويصحّح أخطاء الملف الثنائي تحت GDB، عبر امتداد ⁦**C/C++**⁩ (ms-vscode.cpptools):

{ "type": "elide-native", "request": "launch", "name": "Elide: Debug Native Image", "artifact": "bin" }

أضف -g إلى options.flags الخاصة بالمُخرَج في elide.pkl لنقاط توقف على مستوى المصدر؛ ولا تُصدر معلومات التصحيح إلا على Linux. ويصحّح program ملفًا ثنائيًا موجودًا، ويتخطى build: false البناء.

مساحات العمل

يُزامَن ملف البيان الذي فيه workspace.members كبناء واحد. وكل عضو مشروع في الشريط الجانبي وعرض Testing والمهام وإعدادات الإطلاق، ويتتبّع الدعم الذكي للشيفرة تبعيات project("name") بين الأعضاء دون بناء. وعند فتح مجلد عضو يقترح الامتداد فتح جذر مساحة العمل. راجع مساحات العمل.

الإعدادات