Aktualisieren

Diese Seite behandelt das Aktualisieren von Elide, das Festlegen der Version eines Projekts und die nötigen Änderungen beim Wechsel auf 1.6.

Das installierte Binary aktualisieren

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

Installationsweg	Aktualisieren mit
Installationsskript	`elide upgrade`; eine installierte Python-Komponente bleibt erhalten
Homebrew, apt, RPM, MSI	Dem Paketmanager; siehe Pakete und Installer
GitHub Actions	Der Eingabe `version` von `setup-elide`; siehe Continuous Integration

--channel ist release oder nightly; Standard ist der Kanal, aus dem der laufende Build stammt. --force installiert die aktuelle Version neu.

Version für ein Projekt festlegen

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 schreibt die Version in .elideversion und installiert sie unter ELIDE_HOME (Standard ~/.local/share/elide). Jeder elide-Befehl in diesem Verzeichnis führt dann die festgelegte Version aus und lädt sie bei Bedarf beim ersten Aufruf herunter:

elide info

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

Befehl	Wirkung
`elide use 1.5.4`	Ein Release festlegen und installieren.
`elide use --channel nightly 20260921`	Den Nightly-Build dieses Datums festlegen.
`elide use 1.5.4+20260921`	Einen Nightly-Build über sein vollständiges Tag festlegen.
`elide use --no-install 1.6.0`	Nur `.elideversion` schreiben.
`elide --use-version 1.5.4 run app.js`	Eine installierte Version einmalig ohne Festlegung ausführen.
`elide --ignore-version run app.js`	Das Binary aus `PATH` ausführen und `.elideversion` ignorieren.

elide --version gibt immer das Binary aus PATH aus; elide info gibt die Version aus, die tatsächlich läuft. Nightly-Tags haben die Form <version>+<YYYYMMDD>, zum Beispiel 1.5.4+20260921; die Liste steht unter GitHub Releases.

Um Versionen außerhalb eines Bereichs abzulehnen, statt auf eine zu wechseln, setzen Sie toolchain.engines in elide.pkl:

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

elide build bricht auf einem älteren Binary dann mit Current version of Elide ('1.5.4') does not satisfy project requirements ('>=1.6.0'). ab. Siehe Werkzeugkette.

Version in CI festlegen

Legen Sie die Version im Setup-Schritt fest, und committen Sie .elideversion, damit lokale Ausführungen übereinstimmen:

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

Jedes installierte Elide lädt die Version aus einer committeten .elideversion herunter und führt sie aus; die Festlegung im Workflow und die Datei müssen also übereinstimmen. Für einen Nightly-Build legen Sie das vollständige datierte Tag fest.

Von 1.5 auf 1.6 migrieren

Jede Zeile ist eine Umbenennung oder Entfernung aus dem Änderungsprotokoll zu 1.6.0, mit dem Fehler, den 1.6 bei alter Verwendung ausgibt:

1.5	1.6	Alte Verwendung in 1.6
`elide manifest`	`elide project export`	elide manifest: removed; use `elide project export` instead (Exit-Code `2`)
`testing { coverage { … } }` in `elide.pkl`	Block `coverage { … }` auf oberster Ebene	Cannot find property `coverage` in object of type `elide.testing#Testing`.
Release-Kanal `preview`	`release` oder `nightly`	`invalid value 'preview' for '--channel'` (Exit-Code `2`)
Python in jeder Installation	`elide setup python` oder `--with-python` im Installationsskript	`Python support is not installed. Run 'elide setup python' to add it.`
JavaScript und Python teilen sich einen Kontext	`--interop` bei Programmen, die zwischen Sprachen aufrufen	`Cannot import 'mod.py': JavaScript entries run without Python. Re-run with --interop to use it.`
Maven-Repositorys mit `http://`	URLs mit `https://`; reines HTTP wird nur auf Loopback akzeptiert	`Maven repository 'plain' uses plain HTTP: http://example.com/maven`

Weitere Änderungen in 1.6, die Ergebnisse ohne Fehlermeldung verändern können:

Java kompiliert mit --release und zielt auf jvm.target oder Java 21.
Ein JavadocJar, dessen Quellen Kotlin enthalten, wird von Dokka erzeugt, das auch den Kotlin-Code dokumentiert; setzen Sie darauf generator = "javadoc", um die javadoc-Ausgabe früherer Releases zu behalten. Siehe JAR-Erstellung.
elide run und elide test enden mit dem eigenen Exit-Code des Programms.
elide test beendet die Suche an einem verschachtelten Projekt; nennen Sie dessen Pfad, um es auszuführen.
Source-Sets werden in src/<set>/<language> gesucht, dann in src/<set>, dann im flachen src oder test; siehe Source-Sets.

Patch-Releases innerhalb von 1.6 fügen nur elide.pkl-Eigenschaften hinzu. Um ein Manifest beim Schema von 1.6.0 zu belassen, während Sie ein neueres Elide ausführen, erweitern Sie das veröffentlichte Schema; siehe elide.pkl-Referenz.