Mise à jour

Cette page explique comment mettre à jour Elide, épingler la version qu’utilise un projet, et ce qu’il faut changer en passant à 1.6.

Mettre à jour le binaire installé

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

Méthode d’installation	Mise à jour avec
Script d’installation	`elide upgrade` ; il conserve un composant Python installé
Homebrew, apt, RPM, MSI	Le gestionnaire de paquets ; voir Paquets et installateurs
GitHub Actions	L’entrée `version` de `setup-elide` ; voir Intégration continue

--channel vaut release ou nightly ; par défaut, c’est le canal dont provient le build en cours d’exécution. --force réinstalle la version actuelle.

Épingler un projet

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 écrit la version dans .elideversion et l’installe sous ELIDE_HOME (par défaut ~/.local/share/elide). Chaque commande elide lancée dans ce répertoire exécute alors la version épinglée, en la téléchargeant à la première utilisation si nécessaire :

elide info

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

Commande	Effet
`elide use 1.5.4`	Épingler une version publiée et l’installer.
`elide use --channel nightly 20260921`	Épingler le build nightly de cette date.
`elide use 1.5.4+20260921`	Épingler un build nightly par son étiquette complète.
`elide use --no-install 1.6.0`	Écrire seulement `.elideversion`.
`elide --use-version 1.5.4 run app.js`	Exécuter une version installée une seule fois, sans épinglage.
`elide --ignore-version run app.js`	Exécuter le binaire du `PATH` en ignorant `.elideversion`.

elide --version affiche toujours le binaire du PATH ; elide info affiche la version qui s’exécute. Les étiquettes nightly ont la forme <version>+<YYYYMMDD>, par exemple 1.5.4+20260921 ; la liste se trouve sur GitHub Releases.

Pour refuser les versions hors d’une plage au lieu de basculer vers l’une d’elles, définissez toolchain.engines dans elide.pkl :

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

Sur un binaire plus ancien, elide build s’arrête alors avec Current version of Elide ('1.5.4') does not satisfy project requirements ('>=1.6.0'). Voir Chaîne d’outils.

Épingler la CI

Épinglez la version dans l’étape d’installation, et commitez .elideversion pour que les exécutions locales correspondent :

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

Tout Elide installé télécharge et exécute la version indiquée dans un .elideversion commité ; l’épinglage du workflow et le fichier doivent donc concorder. Pour un build nightly, épinglez l’étiquette datée complète.

Migrer de 1.5 vers 1.6

Chaque ligne est un renommage ou une suppression tiré du journal des modifications de 1.6.0, avec l’erreur qu’affiche 1.6 pour l’ancien usage :

1.5	1.6	Ancien usage en 1.6
`elide manifest`	`elide project export`	elide manifest: removed; use `elide project export` instead (sortie `2`)
`testing { coverage { … } }` dans `elide.pkl`	Bloc `coverage { … }` de premier niveau	Cannot find property `coverage` in object of type `elide.testing#Testing`.
Canal de publication `preview`	`release` ou `nightly`	`invalid value 'preview' for '--channel'` (sortie `2`)
Python dans chaque installation	`elide setup python`, ou `--with-python` sur le script d’installation	`Python support is not installed. Run 'elide setup python' to add it.`
JavaScript et Python partagent un contexte	`--interop` pour les programmes qui appellent d’un langage à l’autre	`Cannot import 'mod.py': JavaScript entries run without Python. Re-run with --interop to use it.`
Dépôts Maven en `http://`	URL en `https://` ; le HTTP en clair n’est accepté que sur loopback	`Maven repository 'plain' uses plain HTTP: http://example.com/maven`

Autres changements de 1.6 qui peuvent modifier les résultats sans erreur :

Java compile avec --release, en ciblant jvm.target ou Java 21.
Un JavadocJar dont les sources incluent du Kotlin est généré par Dokka, qui documente aussi le Kotlin ; définissez generator = "javadoc" dessus pour conserver la sortie javadoc des versions précédentes. Voir Assemblage JAR.
elide run et elide test se terminent avec le code de sortie du programme lui-même.
elide test arrête la découverte à un projet imbriqué ; indiquez son chemin pour l’exécuter.
Les source sets suivent src/<set>/<language>, puis src/<set>, puis src ou test à plat ; voir Source sets.

Les versions correctives de 1.6 ne font qu’ajouter des propriétés à elide.pkl. Pour garder un manifeste sur le schéma 1.6.0 tout en exécutant un Elide plus récent, amendez le schéma publié ; voir Référence elide.pkl.