利用github搭建个人maven仓库的方法步骤

下面是详细讲解如何利用GitHub搭建个人Maven仓库的步骤。

一、为什么要搭建个人Maven仓库？

在日常开发中，我们经常会使用到Maven来管理Java项目的依赖。而Maven默认会从远程的Maven仓库中查找依赖，这样会有以下问题：

依赖的版本无法控制，有可能出现版本不兼容的问题；
网络不稳定或远程仓库出现故障，导致依赖下载失败；
公司内部需要使用某些特定版本的依赖，但是公共的Maven仓库中没有这些依赖。

因此，为了解决这些问题，我们可以在GitHub上搭建个人的Maven仓库，来管理本地或公司内部需要使用的依赖，便于控制依赖版本和依赖管理。

二、搭建个人Maven仓库的方法

1. 创建GitHub仓库

首先，需要在GitHub上创建一个新的仓库，作为我们的个人Maven仓库。比如，我们创建了一个名为my-maven-repo的仓库。

2. 下载Apache Maven

接下来，需要下载并安装Apache Maven。可在Maven官网下载最新版本的Maven，解压到本地某个路径中。

3. 配置Settings.xml文件

Maven会读取~/.m2/settings.xml文件来查找Maven配置。因此，我们需要在该文件中添加以下配置，指定我们的GitHub仓库作为Maven仓库：

<settings>
  <servers>
    <server>
      <id>github</id>
      <username>GITHUB_USERNAME</username>
      <password>GITHUB_TOKEN</password>
    </server>
  </servers>

  <profiles>
    <profile>
      <id>github</id>
      <repositories>
        <repository>
          <id>github</id>
          <url>https://maven.pkg.github.com/GITHUB_USERNAME/MY-MVN-REPO/</url>
        </repository>
      </repositories>
    </profile>
  </profiles>

  <activeProfiles>
    <activeProfile>github</activeProfile>
  </activeProfiles>
</settings>

其中，GITHUB_USERNAME是你的GitHub用户名，GITHUB_TOKEN需要在GitHub生成一个访问令牌（token），用于在Maven上传依赖时进行认证。

具体生成token的方法可以参考GitHub的文档。

添加完成后，保存settings.xml文件。

4. 上传依赖到GitHub仓库

接下来，需要将本地的依赖上传到GitHub仓库中。以上传my-demo项目的依赖为例，可以在该项目的pom.xml文件中添加以下配置：

<distributionManagement>
  <repository>
    <id>github</id>
    <name>GitHub my-maven-repo Package</name>
    <url>https://maven.pkg.github.com/GITHUB_USERNAME/MY-MVN-REPO/</url>
  </repository>
</distributionManagement>

然后，在命令行中执行以下命令，将项目打包并上传到GitHub仓库中：

mvn clean package
mvn deploy

执行成功后，依赖就会上传到GitHub仓库的packages中。

5. 使用GitHub仓库中的依赖

最后，我们就可以在其他项目的pom.xml文件中添加以下依赖，来使用刚上传的依赖了：

<repositories>
  <repository>
    <id>github</id>
    <name>GitHub my-maven-repo</name>
    <url>https://maven.pkg.github.com/GITHUB_USERNAME/MY-MVN-REPO/</url>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>com.example</groupId>
    <artifactId>my-demo</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

其中，com.example:my-demo:1.0.0就是刚上传的项目的依赖。在<repositories>中添加GitHub仓库的信息，在<dependencies>中引入依赖即可使用。

三、示例说明

示例一：上传本地项目依赖到GitHub仓库

以下示例以Spring Boot项目为例，演示如何上传本地项目依赖到GitHub仓库中。

在GitHub上创建一个名为my-boot-repo的仓库，用来作为Maven仓库。
将Spring Boot项目的pom.xml文件中的以下配置修改为：

xml <distributionManagement> <repository> <id>github</id> <url>https://maven.pkg.github.com/GITHUB_USERNAME/my-boot-repo/</url> </repository> </distributionManagement>

其中，GITHUB_USERNAME为你的GitHub用户名。

在项目根目录下执行以下命令，将项目打包并上传至GitHub仓库：

shell mvn clean package mvn deploy

上传成功后，就可以在其他项目的pom.xml文件中添加以下依赖：

```xml

github
GitHub my-boot-repo
https://maven.pkg.github.com/GITHUB_USERNAME/my-boot-repo/

com.example
my-boot-app
1.0.0

```

其中，com.example:my-boot-app:1.0.0即为刚上传的Spring Boot项目的依赖。在<repositories>中添加GitHub仓库信息，在<dependencies>中引入依赖即可使用。

示例二：上传第三方依赖到GitHub仓库

以下示例以Jedis库为例，演示如何上传第三方依赖到GitHub仓库中。

在GitHub上创建一个名为my-libs-repo的仓库，用来作为Maven仓库。
修改项目的pom.xml文件，添加以下配置：

xml <repositories> <repository> <id>github</id> <name>GitHub my-libs-repo</name> <url>https://maven.pkg.github.com/GITHUB_USERNAME/my-libs-repo/</url> </repository> </repositories>

其中，GITHUB_USERNAME为你的GitHub用户名。

添加以下<dependency>元素到项目的pom.xml文件中：

xml <dependency> <groupId>redis.clients</groupId> <artifactId>jedis</artifactId> <version>3.6.0</version> </dependency>

在命令行中执行以下命令，将Jedis依赖上传至GitHub仓库：

shell mvn deploy:deploy-file \ -DgroupId=redis.clients \ -DartifactId=jedis \ -Dversion=3.6.0 \ -Dpackaging=jar \ -Dfile=jedis-3.6.0.jar \ -DrepositoryId=github \ -Durl=https://maven.pkg.github.com/GITHUB_USERNAME/my-libs-repo/

其中，jedis-3.6.0.jar为本地待上传的jar包名称，GITHUB_USERNAME为你的GitHub用户名。执行成功后，Jedis依赖就会上传至GitHub仓库中。

在其他项目的pom.xml文件中添加以下依赖：

```xml

github
GitHub my-libs-repo
https://maven.pkg.github.com/GITHUB_USERNAME/my-libs-repo/

redis.clients
jedis
3.6.0

```

其中，redis.clients:jedis:3.6.0即为刚上传的Jedis依赖。在<repositories>中添加GitHub仓库信息，在<dependencies>中引入依赖即可使用。

四、总结

通过以上步骤，我们就可以在GitHub上搭建个人的Maven仓库，来管理本地或公司内部需要使用的依赖，便于控制依赖版本和依赖管理。同时也可以发布自己编写的开源项目到maven central仓库，供广大开发者使用。

本站文章如无特殊说明，均为本站原创，如若转载，请注明出处：利用github搭建个人maven仓库的方法步骤 - Python技术站