Déclarez les dépendances dans elide.pkl et installez-les avec elide install.
| Écosystème | Activé par | Lu depuis |
|---|---|---|
| Maven | par défaut | elide.pkl, ou un projet pom.xml sélectionné avec -p |
| npm | --ecosystems=npm | elide.pkl et package.json |
| PyPI | — | dependencies.pypi est accepté ; elide install ne l’installe pas |
Installer les dépendances
elide install # Maven
elide install --ecosystems=npm # npm
elide install --ecosystems=maven,npm # both
elide install --workspace # every ecosystem the project declares
~/demo elide install --ecosystems=npm,maven
[722ms] ✓ NPM packages installed (541ms)
[18.1s] ✓ Resolved 17 Maven dependencies (17.4s)
[18.1s] ✓ Dependencies installed in 18.0s
~/demo elide install --ecosystems=npm,maven
[ 11ms] Already up to date
[ 17ms] ⇥ Dependencies ready (Up to date)
[ 22ms] ✓ Dependencies installed in 13ms
Un package.json n’active pas npm ; nommez chaque écosystème dont la CI a besoin. Un écosystème inconnu ou
indisponible est une erreur d’utilisation.
Déclarer des dépendances
amends "elide:project.pkl"
dependencies {
maven {
packages {
"com.google.guava:guava:33.4.8-jre"
}
}
npm {
packages { "react@19.0.0" }
devPackages { "typescript@5.6.2" }
}
pypi {
packages { "requests>=2" }
optionalPackages { ["dev"] { "pytest>=8" } }
}
}
Pour un projet qui n’a qu’un pom.xml, lancez elide install -p . ; voir Dépendances Maven.
Groupes Maven
Une entrée est group:artifact:version[:classifier], un MavenPackageSpec, le chemin d’un JAR local ou une référence
project("name"). Les membres d’un espace de travail peuvent omettre la version et prendre celle de la racine
(Espaces de travail), et une entrée déclarée à côté d’un BOM
(group:bom:pom:version) peut l’omettre et prendre la version que liste le BOM. Les conflits se résolvent au plus
proche, comme dans Maven, sauf si resolutions les remplace.
| Groupe | S’applique à |
|---|---|
packages | Classpaths de compilation et d’exécution des source sets de production. |
devPackages | Phase de développement uniquement. |
modules | --module-path pour les compilations, les exécutions, les tests et les images natives. |
compileOnly | Classpath de compilation uniquement. |
runtimeOnly | Classpath d’exécution uniquement. |
processors | Chemin des processeurs d’annotations ; voir Dépendances Maven. |
testPackages | Source sets de test, en plus des dépendances de leur source set de production. |
androidTestPackages | Le source set androidTest : tests instrumentés Android, qui s’exécutent sur un appareil ; jamais le classpath de test de l’hôte. |
kotlinPlugins | Plugins du compilateur Kotlin ; voir Compilateur Kotlin. |
exclusions | Retirées de la résolution et de tous les classpaths. |
substitutions | Fichiers locaux qui remplacent une coordonnée dans tous les classpaths ; voir la référence. |
Résolutions de versions Maven
Utilisez resolutions pour imposer une version exacte partout où un module apparaît dans le graphe de dépendances :
dependencies {
maven {
resolutions {
["org.example:library"] = "1.2.3"
}
}
}
Les clés sont group:artifact ; le remplacement s’applique aux demandes directes et transitives, y compris tous les
classifiers et types de packaging, avant la récupération de leurs POM. Il n’ajoute pas de dépendance et ne rétablit pas
une dépendance exclue. Les plages de versions, les jokers, LATEST et RELEASE sont refusés. Les membres d’un espace
de travail héritent des résolutions de la racine et peuvent les remplacer par clé. Modifier ou supprimer une résolution
entraîne une nouvelle résolution du graphe de dépendances.
Starters Spring Boot :
dependencies {
spring {
version = "4.0.0"
starter { "web"; "actuator" }
testStarter { "test" }
}
}
Chaque nom devient org.springframework.boot:spring-boot-starter-<name>:<version> dans packages ou testPackages.
Les autres artefacts Spring (spring-boot-devtools, org.springframework:*) vont dans maven ; les deux sont
fusionnés.
Le guide Spring Boot présente un manifeste complet pour compiler, tester et empaqueter une application avec Elide.
Bibliothèques Android, par famille :
dependencies {
android {
androidx { ["activity-compose"] = "1.9.3"; ["core-ktx"] = "1.15.0" }
compose { bom = "2025.10.00"; modules { "ui"; "foundation"; "material3"; "ui-tooling" } }
material = "1.12.0"
playServices { ["location"] = "21.3.0" }
test { runner = "1.6.2"; modules { "ext-junit" }; espresso { "core" } }
robolectric = "4.16"
}
}
| Famille | Devient |
|---|---|
androidx | androidx. : core-ktx donne androidx.core:core-ktx ; un groupe imbriqué commence par ses segments, wear-compose-material3 donne androidx.. |
compose | androidx., versionné par le BOM (bom) ou à une seule release (version). |
material | com.. |
playServices | com.. |
test | androidx.test:runner et les bibliothèques AndroidX Test et Espresso nommées, à la release de runner, dans androidTestPackages. |
robolectric | org. et le moteur JUnit Vintage dont elide test a besoin, dans testPackages. |
Un nom inconnu de sa famille fait échouer l’évaluation, en nommant la famille et le nom. Tout le reste va dans
maven ; les deux sont fusionnés. Les archives Android n’ont pas besoin du packaging aar : il est lu dans les
métadonnées publiées de la bibliothèque. Voir Dépendances Android.
Dépôts
dependencies {
maven {
repositories {
["company"] = "https://maven.example.com/releases"
["private"] {
url = "https://packages.example.com/maven"
credentials {
username = read("env:MAVEN_USER")
password = read("env:MAVEN_TOKEN")
}
}
}
localRepository = ".m2/repository"
}
}
| Propriété | Signification |
|---|---|
repositories[name].url | URL du dépôt. |
repositories[name]., .password | Authentification basique. |
repositories[name]., .ntlmWorkstation | L’une ou l’autre sélectionne NTLM. |
repositories[name].name, .description | Nom affiché et description. |
enableDefaultRepositories | Inclure Maven Central (true par défaut). |
localRepository | Dépôt Maven local dans lequel résoudre. |
- Un
http://non chiffré vers toute adresse hors de127.0.0.0/8échoue avecMaven repository 'name' uses plain HTTP.elide build deps --allow-http-repositoriesl’accepte. read("env:…")nécessite--allow-env; voir Options de build.- Avec
enableDefaultRepositories, les artefacts Maven viennent d’abord du proxymaven.pkg.st, puis de Maven Central. Un projet qui déclareandroidoudependencies.androidrésout aussi contre le dépôt Maven de Google.elide build deps --use-pkgst=false(ou--no-use-pkgst) n’utilise que Maven Central ; les options globales--pkgstet--no-pkgstn’y changent rien.
Options Maven
| Option | Effet |
|---|---|
--slim | Ignore les sources et la Javadoc. |
--with=sources | Récupère aussi les sources ; javadoc et docs fonctionnent également. Les valeurs inconnues sortent avec le code 2. |
--direct | Copie les artefacts dans le projet au lieu de créer des liens. |
--fresh | Télécharge à nouveau toutes les dépendances et rafraîchit le cache global. |
elide build deps effectue la même résolution sous forme de tâche et accepte aussi --offline,
--allow-http-repositories et --use-pkgst.
Fichiers installés
| Chemin | Contenu |
|---|---|
. | Paquets npm ; node_modules à la racine du projet pointe ici. |
aube-lock.yaml | Fichier de verrouillage npm. |
.dev/dependencies/m2 | Liens vers le cache Maven standard. |
. | Classpaths résolus ; voir elide classpath. |
Dans un espace de travail, les liens sont dans le .dev/dependencies/ de la racine ; les fichiers de classpath restent
propres à chaque projet. Il n’existe pas de fichier de verrouillage commun à tous les écosystèmes ; voir
État du build.
Interroger le code des dépendances
L’index du code des dépendances, expérimental, enregistre les types, les membres et les
références des JAR Maven résolus. Construisez-le avec elide index build --layers=l1,l2,l3, puis utilisez resolve
pour savoir quel artefact définit une classe, get pour inspecter un type ou un membre, et references pour suivre
ses références dans le code. used-by trouve les sources locales compilées correspondantes.
OpenRewrite utilise le même index pour les transformations de code source Java. Ajoutez les
modules de recettes à devPackages ; ce sont des outils de développement, distincts des dépendances de l’application.
Bibliothèques JVM implicites
- Les racines purement Java ne reçoivent ni bibliothèques Kotlin implicites, ni runtime Metro, ni API d’annotations
Elide, même avec un bloc
kotlin. - Les racines Kotlin reçoivent les bibliothèques qu’activent leurs
kotlin.features. - Les racines Kotlin reçoivent aussi le runtime atomicfu, sauf si
kotlin.features.atomicfu = false. - Les source sets de test reçoivent le JUnit fourni, sauf si
jvm.features.testing = false;elide testa alors besoin de votre proprejunit-platform-consolepour les tests JVM. dev.elide:elide-apiacceptelatestcomme version et se résout vers l’artefact fourni.- Les bibliothèques fournies lient les JAR propres à Elide, mais leurs sources et leur Javadoc viennent de vos dépôts
comme pour toute autre dépendance :
--with=sourcesattache donc aussi les sources dekotlin-stdlib.elide-apin’en a pas.
La liste complète, avec les versions : API JVM. Pour utiliser les Annotations Elide depuis Java :
dependencies {
maven {
compileOnly { "dev.elide:elide-api:1.0.0" }
}
}
Spécificités npm : Installateur npm.
Les valeurs par défaut d’une session Studio s’appliquent aussi à l’installateur npm intégré : ELIDE_PKGST=1 active
le CDN de paquets, sauf remplacement explicite par des options de la CLI. Les requêtes vers l’origine HTTPS
npm.pkg.st portent un ELIDE_STUDIO_SESSION_ID valide pour la corrélation interne. Les autres registres ne reçoivent
aucun en-tête de session Studio. L’installateur natif conserve le contenu des paquets inchangés quand les versions des
dépendances évoluent ; la disposition .dev/dependencies/npm d’Elide n’exige pas une entrée identique pour tout le
projet pour réutiliser ces paquets.