Aller au contenu

Configuration du projet

Configurez un projet Elide avec elide.pkl : modèles elide init, scripts nommés, dépendances, espaces de travail et épinglage de la version d'Elide.

Lire hors ligneelide help --lang fr projects

Sur cette page

Un projet est un répertoire qui contient un elide.pkl. Les sorties, les dépendances, les rapports et l’état du build vont dans .dev/. Lancez les commandes depuis le répertoire du projet, ou passez -p PATH.

Consultez Le répertoire .dev pour les fichiers générés, les espaces de travail et le nettoyage.

Terminal
bash
elide init --templates   # android, java, ktjvm, spring, micronaut, testcontainers, web-simple, web-demo, workspace

Créer un projet sans questions

elide init ouvre un éditeur dans le terminal. Dans les scripts et en CI, passez --plain --skip-defaults, un modèle et ses paramètres sous la forme name=value :

Terminal
bash
elide init --template java --parameters          # list parameters and blocks
elide init --template java --parameters --json   # the same, as JSON
elide init --plain --skip-defaults --skip-run --template java \
  project_name=greeter package=dev.acme greeting="Hi there" tests=false
text
elide.pkl
src/main/dev/acme/Hello.java
utf-8 · text · Lignes : 2
ArgumentEffet
NAME=VALUE ou NAME VALUEDéfinit un paramètre ; les paramètres omis prennent leur valeur par défaut.
BLOCK=true, BLOCK=falseActive ou désactive un bloc facultatif : tests (sources de test), mcp (.mcp.json).
--skip-runN’exécute pas Elide après la génération des fichiers.
--overwriteRemplace les fichiers existants.
EntréeRésultat
Pas de terminal, sans --plain --skip-defaultsCode de sortie 2 : `elide init` needs an interactive terminal.
Une valeur qui échoue à la validationCode de sortie 2 : Parameter "package" value "1bad" validation failed with error: "Not a valid Java package name."
Une valeur de bloc autre que true/falseCode de sortie 2 : Could not parse block "tests" value "maybe" as boolean, it must be true or false
Un nom inconnuAvertissement No parameter or block "colour" exists, value "red" will be ignored ; code de sortie 0

Créer un projet JVM

pkl
amends "elide:project.pkl"

name = "hello"

jvm {
  main = "sample.HelloKt"
}
utf-8 · pkl · Lignes : 7

src/main/kotlin/sample/Hello.kt :

kotlin
package sample

fun main() {
  println("Hello from Kotlin")
}
utf-8 · kotlin · Lignes : 5
Terminal
bash
elide install
elide build
elide run

src/main/kotlin ne nécessite pas de bloc sources ; voir Source sets.

Construction et exécution d'un projet Kotlin avec Elide
 ~/demo  elide build
[10.5s] ✓ Resolved 7 Maven dependencies (10.4s)
[10.6s] ✓ Compiled 1 main Kotlin source file (128ms)
[10.6s] ⇥ Java main compilation skipped (No sources)
[10.6s] ✓ Build successful in 10.6s
 ~/demo  elide run
[ 11ms] ⇥ Dependencies ready (Up to date)
[ 12ms] ⇥ Kotlin main compilation skipped (Up to date)
[ 12ms] ⇥ Java main compilation skipped (Up to date)
Hello from Kotlin!
[ 69ms] ✓ JVM main application completed successfully (57ms)
[ 74ms] ✓ Build successful in 64ms
 ~/demo  elide build
[ 12ms] ⇥ Dependencies ready (Up to date)
[ 12ms] ⇥ Kotlin main compilation skipped (Up to date)
[ 12ms] ⇥ Java main compilation skipped (Up to date)
[ 29ms] ✓ Build successful in 19ms
 

elide build --inspect liste les tâches et leurs options ; voir Tâches de build.

Ajouter un script

pkl
scripts {
  ["greet"] = "echo hello"
}
utf-8 · pkl · Lignes : 3
Terminal
bash
elide run greet

Les scripts s’exécutent sous /bin/sh. elide run NAME retient la première correspondance : un fichier, puis les scripts de elide.pkl, puis ceux de package.json ou pyproject.toml, puis node_modules/.bin.

Ajouter des dépendances

Déclarez les paquets Maven, npm et PyPI sous dependencies ; elide install résout les paquets Maven et npm, pas PyPI (paquets Python). Voir Dépendances et la référence.

Créer un espace de travail

La racine d’un espace de travail liste les projets membres et les construit comme un seul graphe de tâches. elide init --template workspace en crée un. Voir Espaces de travail.

Inspecter un projet

Terminal
bash
elide project info                 # resolved source sets, dependencies, artifacts
elide project advice               # usage advice for coding agents
elide project export               # the resolved manifest as JSON
elide project export --format=pom  # or intellij
elide classpath                    # the main compile classpath, `:`-separated
elide classpath test:runtime       # [<source-set>:]<usage>

Dans un projet qui déclare android, elide project info affiche aussi le SDK Android : sa racine et sa provenance (le manifeste, ANDROID_HOME, ANDROID_SDK_ROOT, l’emplacement par défaut de la plateforme ou le SDK géré par Elide), la plateforme, les build-tools, les platform-tools, l’émulateur et les images système résolus avec leurs révisions installées, ce que le manifeste requiert et qui manque, ainsi que les appareils connectés et les émulateurs en cours d’exécution (SDK Android).

Les options -f modifient l’export. Formats : Formats d’export du projet. Usages du classpath : Source sets.

Épingler la version d’Elide

Terminal
bash
elide use 1.6.0               # write .elideversion and install that version
elide use 1.6.0 --no-install  # only write the file

toolchain.engines dans elide.pkl liste les versions acceptées ; voir Chaîne d’outils.

Cette page vous a-t-elle aidé ?