VS-Code-Erweiterung

Die Elide-Erweiterung macht jeden Ordner mit einer elide.pkl zu einem VS-Code-Projekt: Sie synchronisiert Abhängigkeiten und Source-Sets in den Kotlin-Language-Server und führt aus, testet und debuggt über die elide-CLI.

Voraussetzungen

Die Erweiterung braucht einen vertrauenswürdigen Workspace: Eine Synchronisierung führt die elide-CLI des Workspace aus.

Installation

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

Help → Get Started → Get started with Elide führt durch Installation, Projekt, Synchronisierung, Ausführen und Testen.

Projekt synchronisieren

Wenn Sie einen Ordner mit elide.pkl öffnen, wird er synchronisiert: Elide löst das Manifest auf, installiert Abhängigkeiten, wenn das Lockfile veraltet ist, und schreibt workspace.json für den Kotlin-Language-Server. Nehmen Sie workspace.json in .gitignore auf.

Ein Klick auf das Element in der Statusleiste öffnet das Elide-Menü: synchronisieren, einen Befehl ausführen, alle Tests ausführen, elide.pkl oder die Ausgabe öffnen. Ändert sich elide.pkl, fragt die Erweiterung, ob neu geladen werden soll (elide.sync.onManifestChange).

Die Elide-Seitenleiste

Die Ansicht Elide in der Aktivitätsleiste listet jedes Projekt auf:

Code-Intelligenz

Vervollständigung, Navigation und Diagnosen für Kotlin und Java liefert der Kotlin-Language-Server, der die synchronisierte workspace.json importiert: ein Modul pro Source-Set, jede Bibliothek mit ihren Quellen, das JDK und die Kotlin-Optionen des Manifests.

• Für deklarierte Maven-Pakete werden Quell-JARs installiert, sodass Go to Definition den Bibliothekscode öffnet (elide.install.classifiers).
• Das JDK stammt aus elide.jdk.home, danach aus jvm.javaHome, $JAVA_HOME oder einem installierten JDK, das zu jvm.target passt.
• Ein Checkout kann ein .idea-Verzeichnis von IntelliJ behalten: Die Erweiterung setzt intellij.buildTool in den Workspace-Einstellungen auf json, sodass jeder Editor sein eigenes Modell liest.

Ausführen

Code Lenses führen aus, was das Projekt deklariert:

Ausführungen sind VS-Code-Tasks vom Typ elide; Compilerfehler erscheinen unter Problems an der gemeldeten Datei und Zeile.

In .vscode/tasks.json:

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

Testen

JUnit-Tests in den Test-Source-Sets erscheinen in der Ansicht Testing, mit Symbolen in der Randleiste an jeder Klasse und Methode. Ein Lauf ruft elide test --reporter=tap für die Auswahl auf und meldet jeden Test, sobald er fertig ist; ein Fehlschlag zeigt seine Assertion-Meldung und verlinkt auf die fehlschlagende Zeile.

Das Profil Debug führt dieselben Tests im Debugger aus.

Run with Coverage führt die Auswahl mit --coverage aus und zeigt das Ergebnis in der Randleiste des Editors und in der Ansicht Test Coverage: JavaScript und TypeScript aus LCOV, Java und Kotlin aus einem JaCoCo-XML-Bericht. Fordern Sie den XML-Bericht in elide.pkl an:

import "elide:Coverage.pkl" as Coverage

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

Debuggen

Debug with Elide startet elide run --debugger und hängt sich an. Haltepunkte in Kotlin- und Java-Quellen halten das Programm an; das Beenden der Sitzung beendet Elide.

In .vscode/launch.json:

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

elide.debug.adapter wählt den Debugger: intellij (Standard, aus der Kotlin-Erweiterung) oder java (Debugger for Java). Der Debugger lauscht auf Port 5005, daher läuft immer nur eine Sitzung. Zum Debuggen von JavaScript, TypeScript und Python über CDP und DAP siehe Debugging.

Native Image

Der Starttyp elide-native baut ein Native-Image-Artefakt und debuggt die Binärdatei unter GDB, über die Erweiterung C/C++ (ms-vscode.cpptools):

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

Fügen Sie für Haltepunkte auf Quellcodeebene -g zu den options.flags des Artefakts in elide.pkl hinzu; Debug-Informationen werden nur unter Linux erzeugt. program debuggt eine vorhandene Binärdatei, build: false überspringt den Build.

Workspaces

Ein Manifest mit workspace.members wird als ein Build synchronisiert. Jedes Mitglied ist ein Projekt in der Seitenleiste, der Testing-Ansicht, den Tasks und den Startkonfigurationen, und die Code-Intelligenz folgt project("name")-Abhängigkeiten zwischen Mitgliedern ohne Build. Beim Öffnen des Verzeichnisses eines Mitglieds wird angeboten, die Workspace-Wurzel zu öffnen. Siehe Workspaces.

Einstellungen