Aller au contenu

Dépendances

Déclarez des dépendances Maven, npm et PyPI dans elide.pkl et installez les paquets Maven et npm avec elide install : écosystèmes, options, fichiers.

Lire hors ligneelide help --lang fr tooling-dependencies

Sur cette page

Déclarez les dépendances dans elide.pkl et installez-les avec elide install.

ÉcosystèmeActivé parLu depuis
Mavenpar défautelide.pkl, ou un projet pom.xml sélectionné avec -p
npm--ecosystems=npmelide.pkl et package.json
PyPI—dependencies.pypi est accepté ; elide install ne l’installe pas

Installer les dépendances

Terminal
bash
elide install                         # Maven
elide install --ecosystems=npm        # npm
elide install --ecosystems=maven,npm  # both
elide install --workspace             # every ecosystem the project declares
Installation explicite de dépendances Maven et npm avec Elide
 ~/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

pkl
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" } }
  }
}
utf-8 · pkl · Lignes : 17

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.

GroupeS’applique à
packagesClasspaths de compilation et d’exécution des source sets de production.
devPackagesPhase de développement uniquement.
modules--module-path pour les compilations, les exécutions, les tests et les images natives.
compileOnlyClasspath de compilation uniquement.
runtimeOnlyClasspath d’exécution uniquement.
processorsChemin des processeurs d’annotations ; voir Dépendances Maven.
testPackagesSource sets de test, en plus des dépendances de leur source set de production.
androidTestPackagesLe source set androidTest : tests instrumentés Android, qui s’exécutent sur un appareil ; jamais le classpath de test de l’hôte.
kotlinPluginsPlugins du compilateur Kotlin ; voir Compilateur Kotlin.
exclusionsRetirées de la résolution et de tous les classpaths.
substitutionsFichiers 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 :

pkl
dependencies {
  maven {
    resolutions {
      ["org.example:library"] = "1.2.3"
    }
  }
}
utf-8 · pkl · Lignes : 7

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 :

pkl
dependencies {
  spring {
    version = "4.0.0"
    starter { "web"; "actuator" }
    testStarter { "test" }
  }
}
utf-8 · pkl · Lignes : 7

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 :

pkl
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"
  }
}
utf-8 · pkl · Lignes : 10
FamilleDevient
androidxandroidx.<group>:<artifact> : core-ktx donne androidx.core:core-ktx ; un groupe imbriqué commence par ses segments, wear-compose-material3 donne androidx.wear.compose:compose-material3.
composeandroidx.compose.<group>:<module>, versionné par le BOM (bom) ou à une seule release (version).
materialcom.google.android.material:material.
playServicescom.google.android.gms:play-services-<name>.
testandroidx.test:runner et les bibliothèques AndroidX Test et Espresso nommées, à la release de runner, dans androidTestPackages.
robolectricorg.robolectric:robolectric 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

pkl
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"
  }
}
utf-8 · pkl · Lignes : 15
PropriétéSignification
repositories[name].urlURL du dépôt.
repositories[name].credentials.username, .passwordAuthentification basique.
repositories[name].credentials.ntlmDomain, .ntlmWorkstationL’une ou l’autre sélectionne NTLM.
repositories[name].name, .descriptionNom affiché et description.
enableDefaultRepositoriesInclure Maven Central (true par défaut).
localRepositoryDépôt Maven local dans lequel résoudre.
  • Un http:// non chiffré vers toute adresse hors de 127.0.0.0/8 échoue avec Maven repository 'name' uses plain HTTP. elide build deps --allow-http-repositories l’accepte.
  • read("env:…") nécessite --allow-env ; voir Options de build.
  • Avec enableDefaultRepositories, les artefacts Maven viennent d’abord du proxy maven.pkg.st, puis de Maven Central. Un projet qui déclare android ou dependencies.android ré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 --pkgst et --no-pkgst n’y changent rien.

Options Maven

OptionEffet
--slimIgnore les sources et la Javadoc.
--with=sourcesRécupère aussi les sources ; javadoc et docs fonctionnent également. Les valeurs inconnues sortent avec le code 2.
--directCopie les artefacts dans le projet au lieu de créer des liens.
--freshTé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

CheminContenu
.dev/dependencies/npm/node_modulesPaquets npm ; node_modules à la racine du projet pointe ici.
aube-lock.yamlFichier de verrouillage npm.
.dev/dependencies/m2Liens vers le cache Maven standard.
.dev/dependencies/m2/{compile,runtime,test,processors}.classpathClasspaths 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 test a alors besoin de votre propre junit-platform-console pour les tests JVM.
  • dev.elide:elide-api accepte latest comme 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=sources attache donc aussi les sources de kotlin-stdlib. elide-api n’en a pas.

La liste complète, avec les versions : API JVM. Pour utiliser les Annotations Elide depuis Java :

pkl
dependencies {
  maven {
    compileOnly { "dev.elide:elide-api:1.0.0" }
  }
}
utf-8 · pkl · Lignes : 5

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.

Cette page vous a-t-elle aidé ?