Dépôt Maven

Dans la terminologie Maven, un dépôt est un emplacement.

Un dépôt Maven contient les bibliothèques tierces dont un projet dépend ; l'emplacement où ces bibliothèques sont stockées est appelé un dépôt.

Dans Maven, toute dépendance, tout plugin ou toute sortie de build d'un projet peut être appelé un artefact.

Les dépôts Maven nous aident à gérer les artefacts (principalement les JAR) ; ils sont l'endroit où tous les fichiers JAR (WAR, ZIP, POM, etc.) sont stockés.

Types de dépôts Maven :

Type de dépôtEmplacement de stockageObjectifPriorité d'accès
Dépôt localSous le répertoire personnel de l'utilisateur.m2/repositoryMet en cache les dépendances téléchargées depuis des dépôts distants1
Dépôt distantServeur réseauFournir un stockage centralisé pour les dépendances et les plugins2
- Dépôt centralrepo.maven.apache.orgLe dépôt par défaut maintenu par l'équipe Maven2.1
- Dépôt de serveur privéConfiguré au sein d'une entreprise (par exemple, Nexus)Héberger des dépendances privées et accélérer les builds2.2
- Autres dépôts publicsTels que Aliyun, JCenter, etc.Mettre en miroir ou compléter le dépôt central2.3

Dépôt local

Le dépôt local de Maven n'est pas créé après l'installation de Maven ; il est créé lors de l'exécution de la première commande Maven.

Lors de l'exécution de Maven, tous les artefacts dont Maven a besoin sont récupérés directement depuis le dépôt local. Si le dépôt local ne les contient pas, il essaiera d'abord de télécharger les artefacts depuis un dépôt distant vers le dépôt local, puis d'utiliser les artefacts du dépôt local.

Par défaut, que ce soit sous Linux ou Windows, chaque utilisateur a un répertoire de dépôt nommé .m2/repository/ dans son répertoire personnel.

  • Windows : C:\Users\<用户名>\.m2\repository

  • Linux/macOS : ~/.m2/repository

Le dépôt local de Maven est créé sous %USER_HOME% par défaut. Pour modifier l'emplacement par défaut, définissez un autre chemin dans le fichier settings.xml situé dans le répertoire %M2_HOME%\conf.

<settings> <localRepository>C:/MyLocalRepository</localRepository> </settings>

Lorsque vous exécutez une commande Maven, Maven téléchargera les fichiers de dépendances vers le chemin que vous avez spécifié.

Nettoyer le dépôt local :

mvn dependency:purge-local-repository
# 或手动删除~/.m2/repository目录

Dépôt central

Le dépôt central Maven est un dépôt fourni par la communauté Maven et contient un grand nombre de bibliothèques couramment utilisées.

Le dépôt central contient les artefacts Java open source les plus populaires, ainsi que le code source, les informations sur l'auteur, les informations SCM, les informations de licence, etc. Généralement, les artefacts dont dépendent les projets Java simples peuvent être téléchargés ici.

Concepts clés du dépôt central :

  • Ce dépôt est géré par la communauté Maven.
  • Aucune configuration n'est requise.
  • Il doit être accessible via le réseau.

Adresse par défaut du dépôt central (aucune configuration explicite requise) :https://repo.maven.apache.org/maven2/


Dépôt distant

Configuration de dépôt personnalisée

Si Maven ne trouve pas les fichiers de dépendances dans le dépôt central, il arrêtera le processus de build et affichera un message d'erreur dans la console. Pour éviter cela, Maven fournit le concept de dépôts distants, qui sont des dépôts personnalisés définis par les développeurs, contenant les bibliothèques de code ou fichiers JAR requis utilisés dans d'autres projets.

Par exemple, en utilisant le pom.xml suivant, Maven téléchargera les fichiers de dépendances déclarés dans le pom.xml (qui ne sont pas disponibles dans le dépôt central) depuis un dépôt distant.

Exemple

<repositories>
    <repository>
        <id>aliyun</id>
        <name>Aliyun Maven</name>
        <url>https://maven.aliyun.com/repository/public</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled> <!-- Désactiver les versions SNAPSHOT -->
        </snapshots>
    </repository>
</repositories>

Dépôt miroir (recommandé)

Configurer dans settings.xml :

Exemple

<mirrors>
    <mirror>
        <id>aliyun</id>
        <name>Miroir Aliyun</name>
        <url>https://maven.aliyun.com/repository/public</url>
        <mirrorOf>central</mirrorOf> <!-- Remplacer le dépôt central -->
    </mirror>
</mirrors>

Dépôt Maven Aliyun

Le dépôt Maven par défaut se trouve à l'étranger, il est donc inévitablement lent à utiliser en Chine. Nous pouvons passer au dépôt d'Aliyun.

Modifiez le fichier settings.xml dans le dossier conf sous le répertoire racine de Maven, puis ajoutez le contenu suivant au nœud mirrors :

<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>Dépôt public Aliyun</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

Si vous souhaitez utiliser d'autres dépôts proxy, vous pouvez<repositories></repositories>ajouter les URL de dépôt correspondantes dans le nœud <repositories>. Prenons l'exemple du dépôt proxy Spring :

<repository> <id>spring</id> <url>https://maven.aliyun.com/repository/spring</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository>

Dans votre fichier pom.xml,<denpendencies></denpendencies>ajoutez les informations de fichier que vous souhaitez référencer dans le nœud <dependencies> :

<dependency> <groupId>[GROUP_ID]</groupId> <artifactId>[ARTIFACT_ID]</artifactId> <version>[VERSION]</version> </dependency>

Exécutez la commande de récupération :

mvn install

Guide de configuration Gradle

Ajoutez le code suivant au fichier build.gradle :

allprojects { repositories { maven { url 'https://maven.aliyun.com/repository/public/' } mavenLocal() mavenCentral() } }

Si vous souhaitez utiliser d'autres dépôts proxy, prenons l'exemple du dépôt Spring, le code est le suivant :

allProjects { repositories { maven { url 'https://maven.aliyun.com/repository/public/' } maven { url 'https://maven.aliyun.com/repository/spring/' } mavenLocal() mavenCentral() } }

Ajoutez les informations du fichier que vous souhaitez référencer :

dependencies { compile '[GROUP_ID]:[ARTIFACT_ID]:[VERSION]' }

Exécutez la commande suivante pour installer les dépendances :

gradle dependencies 
或 
./gradlew dependencies 

Dépôt de serveur privé

Types de dépôts :

Type de dépôtObjectif
hostedStocker des artefacts privés
proxyDépôts distants proxy
groupAgréger plusieurs dépôts

Publier vers un serveur privé

Configurer dans pom.xml :

<distributionManagement>
    <repository>
        <id>nexus-releases</id>
        <url>http://your-nexus/repository/maven-releases</url>
    </repository>
    <snapshotRepository>
        <id>nexus-snapshots</id>
        <url>http://your-nexus/repository/maven-snapshots</url>
    </snapshotRepository>
</distributionManagement>

Configurer l'authentification dans settings.xml :

<servers>
    <server>
        <id>nexus-releases</id>
        <username>deploy-user</username>
        <password>deploy-pwd</password>
    </server>
</servers>

Commande de publication :

mvn deploy

Ordre de recherche des dépendances Maven

Lorsque nous exécutons une commande de build Maven, Maven recherche les bibliothèques de dépendances dans l'ordre suivant :

  • Étape 1- Rechercher dans le dépôt local. Si introuvable, passez à l'étape 2 ; si trouvé, poursuivez les autres opérations.
  • Étape 2- Rechercher dans le dépôt central. S'il n'est pas trouvé et qu'un ou plusieurs dépôts distants ont été configurés, passez à l'étape 4 ; s'il est trouvé, téléchargez-le dans le dépôt local pour référence ultérieure.
  • Étape 3- Si aucun dépôt distant n'est configuré, Maven interrompra simplement le traitement et lèvera une erreur (impossible de trouver les fichiers de dépendance).
  • Étape 4- Rechercher les fichiers de dépendance dans un ou plusieurs dépôts distants. S'ils sont trouvés, téléchargez-les dans le dépôt local pour référence ultérieure ; sinon, Maven interrompra le traitement et lèvera une erreur (impossible de trouver les fichiers de dépendance).

Commandes courantes

CommandeObjectif
mvn dependency:resolveRésoudre les dépendances
mvn dependency:treeAfficher l'arborescence des dépendances
mvn dependency:purge-local-repositoryNettoyer le dépôt local
mvn deployPublier vers un dépôt distant

Problèmes courants et solutions

1. Symptôme : échec du téléchargement des dépendances :Impossible de transférer l'artefact...

Solution :
  • Vérifier la connexion réseau
  • Vérifier si l'URL du dépôt est correcte
  • Désactiver temporairement le pare-feu pour tester

2. Symptôme : échec de l'authentification :401 Unauthorized

Solution :

  • Vérifier la configuration de <server> dans settings.xml
  • Confirmer si le nom d'utilisateur/mot de passe dispose des autorisations d'accès au dépôt

3. Conflits de dépendances

Dépannage :

mvn dependency:tree -Dverbose

Solution : Unifier la version dans <dependencyManagement>

Autres extensions