الترقية

تتناول هذه الصفحة تحديث Elide، وتحديد الإصدار الذي يستخدمه المشروع، وما يجب تغييره عند الانتقال إلى 1.6.

تحديث الملف التنفيذي المثبّت

elide upgrade --check
elide upgrade
elide upgrade --channel release

طريقة التثبيت	التحديث باستخدام
سكربت التثبيت	`elide upgrade`؛ ويحتفظ بمكوّن Python المثبّت
Homebrew و apt و RPM و MSI	مدير الحزم؛ راجع الحزم والمثبتات
GitHub Actions	المُدخل `version` في `setup-elide`؛ راجع التكامل المستمر

قيمة --channel هي release أو nightly؛ والقيمة الافتراضية هي القناة التي جاءت منها النسخة قيد التشغيل. ويعيد --force تثبيت الإصدار الحالي.

تحديد إصدار المشروع

elide use 1.5.4

Elide 1.5.4 is already installed at /home/you/.local/share/elide/versions/1.5.4/bin/elide

يكتب elide use الإصدار في .elideversion ويثبّته تحت ELIDE_HOME (افتراضيًا ~/.local/share/elide). بعد ذلك يشغّل كل أمر elide في ذلك المجلد الإصدار المحدد، ويُنزّله عند أول استخدام إذا لزم الأمر:

elide info

Elide - putting the java back in javascript
Version: 1.5.4+20260921.44ff130047
Mode: release

الأمر	التأثير
`elide use 1.5.4`	تحديد إصدار منشور وتثبيته.
`elide use --channel nightly 20260921`	تحديد نسخة nightly الصادرة في ذلك التاريخ.
`elide use 1.5.4+20260921`	تحديد نسخة nightly بوسمها الكامل.
`elide use --no-install 1.6.0`	كتابة `.elideversion` فقط.
`elide --use-version 1.5.4 run app.js`	تشغيل إصدار مثبّت مرة واحدة، دون تحديده للمشروع.
`elide --ignore-version run app.js`	تشغيل الملف التنفيذي الموجود في `PATH` مع تجاهل `.elideversion`.

يطبع elide --version دائمًا الملف التنفيذي الموجود في PATH، بينما يطبع elide info الإصدار الذي يعمل فعلًا. تأخذ وسوم nightly الصيغة <version>+<YYYYMMDD>، مثل 1.5.4+20260921؛ والقائمة موجودة في GitHub Releases.

لرفض الإصدارات الواقعة خارج نطاق ما بدلًا من التبديل إلى أحدها، اضبط toolchain.engines في elide.pkl:

toolchain { engines { ["elide"] = ">=1.6.0" } }

عندئذ يتوقف elide build على ملف تنفيذي أقدم بالرسالة Current version of Elide ('1.5.4') does not satisfy project requirements ('>=1.6.0'). راجع سلسلة الأدوات.

تحديد الإصدار في CI

حدّد الإصدار في خطوة الإعداد، وأودِع .elideversion في المستودع كي تتطابق عمليات التشغيل المحلية:

- uses: elide-dev/setup-elide@v4.2.0
  with:
    version: 1.6.0
    channel: release

أي نسخة مثبّتة من Elide تُنزّل الإصدار المذكور في .elideversion المودَع وتشغّله، لذا يجب أن يتطابق الإصدار المحدد في سير العمل مع الملف. ولنسخة nightly، حدّد الوسم الكامل المؤرّخ.

الانتقال من 1.5 إلى 1.6

كل صف هو إعادة تسمية أو إزالة من سجل التغييرات للإصدار 1.6.0، مع الخطأ الذي يطبعه 1.6 عند الاستخدام القديم:

1.5	1.6	الاستخدام القديم في 1.6
`elide manifest`	`elide project export`	elide manifest: removed; use `elide project export` instead (رمز الخروج `2`)
`testing { coverage { … } }` في `elide.pkl`	كتلة `coverage { … }` في المستوى الأعلى	Cannot find property `coverage` in object of type `elide.testing#Testing`.
قناة الإصدار `preview`	`release` أو `nightly`	`invalid value 'preview' for '--channel'` (رمز الخروج `2`)
Python في كل تثبيت	`elide setup python`، أو `--with-python` في سكربت التثبيت	`Python support is not installed. Run 'elide setup python' to add it.`
تتشارك JavaScript و Python سياقًا واحدًا	`--interop` للبرامج التي تستدعي شيفرة بلغات أخرى	`Cannot import 'mod.py': JavaScript entries run without Python. Re-run with --interop to use it.`
مستودعات Maven عبر `http://`	عناوين `https://`؛ ولا يُقبل HTTP غير المشفّر إلا على loopback	`Maven repository 'plain' uses plain HTTP: http://example.com/maven`

تغييرات أخرى في 1.6 قد تغيّر النتائج دون ظهور خطأ:

تُصرَّف Java باستخدام --release، مستهدفةً jvm.target أو Java 21.
يُنشئ Dokka أي JavadocJar تتضمن مصادره Kotlin، ويوثّق شيفرة Kotlin أيضًا؛ اضبط عليه generator = "javadoc" للإبقاء على خرج javadoc كما في الإصدارات السابقة. راجع تجميع JAR.
ينتهي elide run و elide test برمز الخروج الخاص بالبرنامج نفسه.
يتوقف elide test عن الاكتشاف عند المشروع المتداخل؛ اذكر مساره لتشغيله.
تتبع مجموعات المصادر src/<set>/<language>، ثم src/<set>، ثم src أو test المسطّحين؛ راجع مجموعات المصادر.

لا تضيف إصدارات التصحيح ضمن 1.6 سوى خصائص في elide.pkl. لإبقاء ملف البيان على مخطط 1.6.0 أثناء تشغيل Elide أحدث، وسّع المخطط المنشور في ملف البيان؛ راجع مرجع elide.pkl.