Плагін для IntelliJ IDEA

Плагін Elide імпортує каталог з elide.pkl так само, як IntelliJ IDEA імпортує проєкт Maven або Gradle, а запуск, тестування й налагодження виконує через CLI elide.

Вимоги

Вимога	Примітки
IntelliJ IDEA 2025.3 і новіші	Community або Ultimate із вбудованими плагінами Java і Kotlin. Для коду на Kotlin з Elide 1.6 потрібна IntelliJ IDEA 2026.2 або новіша: її плагін Kotlin читає бібліотеки Kotlin 2.5.
Elide	Знаходиться через налаштування проєкту Elide distribution. Для Elide 1.6 потрібен плагін 0.9.3 і новіший.
JDK, зареєстрований в IDE	Для проєктів JVM.
Плагін Pkl (необов’язково)	Автодоповнення, навігація й інспекції в `elide.pkl`.

Встановлення

У Settings → Plugins → ⚙ → Manage Plugin Repositories додайте:

https://plugins.elide.dev/intellij

Встановіть Elide на вкладці Marketplace і перезапустіть IDE. Для редагування elide.pkl встановіть 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 або lock-файлу IDE пропонує перезавантажити проєкт.
Вікно інструментів Elide показує прив’язані проєкти, їхні модулі й цілі збирання в розділі Tasks; їх можна запускати просто з дерева.

File → New → Project → Elide створює проєкт із шаблонів, які пропонує elide init.

Робочі простори

Маніфест, що оголошує workspace.members, імпортується як один проєкт. Кожен учасник отримує власні модулі, classpath і JDK, а залежність project("name") стає залежністю від модуля, тож IDE компілює код і переходить по ньому між учасниками. Прив’язується лише корінь; редагування маніфесту учасника перезавантажує робочий простір. Див. Робочі простори.

Запуск

Створіть конфігурацію запуску Elide. Її командний рядок приймає все, що приймає CLI, з автодоповненням команд, прапорців, точок входу й завдань збирання проєкту:

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 у подання покриття, зокрема звіти запусків поза IDE.

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

Налагодження

Debug для конфігурації запуску чи тестування Elide додає --debugger і під’єднує налагоджувач JVM з IDE до порту 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`