Оновлення

На цій сторінці описано, як оновити 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://`	URL з `https://`; звичайний HTTP приймається лише на loopback	`Maven repository 'plain' uses plain HTTP: http://example.com/maven`

Інші зміни 1.6, які можуть змінити результат без помилки:

Java компілюється з --release під jvm.target або Java 21.
JavadocJar, вихідні файли якого містять Kotlin, генерує Dokka, і вона документує також код на 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.