إعداد المشروع

المشروع مجلد يحتوي على ملف elide.pkl. تُحفظ المخرجات والتبعيات والتقارير وحالة البناء في .dev/. شغّل الأوامر من مجلد المشروع، أو مرّر -p PATH.

elide init --templates   # java, ktjvm, web-simple, web-demo, workspace

إنشاء مشروع دون أسئلة

يفتح elide init محررًا في الطرفية. في السكربتات وفي CI، مرّر --plain --skip-defaults وقالبًا ومعاملاته بالصيغة name=value:

elide init --template java --parameters          # list parameters and blocks
elide init --template java --parameters --json   # the same, as JSON
elide init --plain --skip-defaults --skip-run --template java \
  project_name=greeter package=dev.acme greeting="Hi there" tests=false

elide.pkl
src/main/dev/acme/Hello.java

الوسيط	التأثير
`NAME=VALUE` أو `NAME VALUE`	يضبط معاملًا؛ تأخذ المعاملات المحذوفة قيمها الافتراضية.
`BLOCK=true`، `BLOCK=false`	يفعّل كتلة اختيارية أو يعطّلها: `tests` (مصادر الاختبار)، `mcp` (`.mcp.json`).
`--skip-run`	لا يشغّل Elide بعد توليد الملفات.
`--overwrite`	يستبدل الملفات الموجودة.

المُدخل	النتيجة
لا توجد طرفية، ودون `--plain --skip-defaults`	رمز الخروج `2`: `elide init` needs an interactive terminal.
قيمة لا تجتاز التحقق	رمز الخروج `2`: `Parameter "package" value "1bad" validation failed with error: "Not a valid Java package name."`
قيمة كتلة غير `true`/`false`	رمز الخروج `2`: `Could not parse block "tests" value "maybe" as boolean, it must be true or false`
اسم غير معروف	تحذير `No parameter or block "colour" exists, value "red" will be ignored`؛ رمز الخروج `0`

إنشاء مشروع JVM

amends "elide:project.pkl"

name = "hello"

jvm {
  main = "sample.HelloKt"
}

الملف src/main/kotlin/sample/Hello.kt:

package sample

fun main() {
  println("Hello from Kotlin")
}

elide install
elide build
elide run

لا يحتاج src/main/kotlin إلى كتلة sources؛ راجع مجموعات المصادر.

~/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 المهام وخياراتها؛ راجع مهام البناء.

إضافة سكربت

scripts {
  ["greet"] = "echo hello"
}

elide run greet

تعمل السكربتات تحت /bin/sh. يختار elide run NAME أول تطابق: ملفًا، ثم سكربتات elide.pkl، ثم سكربتات package.json أو pyproject.toml، ثم node_modules/.bin.

إضافة التبعيات

صرّح بحزم Maven و npm و PyPI تحت dependencies؛ يحلّ elide install حزم Maven و npm دون PyPI (حزم Python). راجع التبعيات والمرجع.

إنشاء مساحة عمل

يسرد جذر مساحة العمل المشاريع الأعضاء ويبنيها كمخطط مهام واحد. ينشئ elide init --template workspace مساحة عمل. راجع مساحات العمل.

فحص مشروع

elide project info                 # resolved source sets, dependencies, artifacts
elide project advice               # usage advice for coding agents
elide project export               # the resolved manifest as JSON
elide project export --format=pom  # or intellij
elide classpath                    # the main compile classpath, `:`-separated
elide classpath test:runtime       # [<source-set>:]<usage>

تغيّر خيارات -f التصدير. الصيغ: صيغ تصدير المشروع. استخدامات ⁦classpath:⁩ مجموعات المصادر.

تحديد إصدار Elide

elide use 1.6.0               # write .elideversion and install that version
elide use 1.6.0 --no-install  # only write the file

يسرد toolchain.engines في elide.pkl الإصدارات المقبولة؛ راجع سلسلة الأدوات.