如何配置Maven使用GitHub托管的可自动更新自定义JAR依赖

方案一：使用GitHub Packages（官方Maven仓库） #

这个方案适合通过Maven构建的JAR项目，能直接集成到Maven的依赖管理流程中。

1. 发布JAR到GitHub Packages #

• 配置项目pom.xml：在你的JAR项目的pom.xml中添加以下配置，替换成你的GitHub用户名和仓库名：

  <distributionManagement>
      <repository>
          <id>github</id>
          <name>GitHub Packages</name>
          <url>https://maven.pkg.github.com/你的GitHub用户名/仓库名</url>
      </repository>
  </distributionManagement>
  
  <repositories>
      <repository>
          <id>github</id>
          <url>https://maven.pkg.github.com/你的GitHub用户名/仓库名</url>
          <snapshots>
              <enabled>true</enabled>
          </snapshots>
      </repository>
  </repositories>
  

  同时确保pom里的groupId、artifactId、version定义准确，每次更新JAR时更换版本号（比如从1.0.0改为1.0.1），不要重复使用同一版本号。

• 配置Maven认证：在本地Maven的settings.xml（通常在~/.m2/或Maven安装目录的conf/文件夹下）添加服务器配置，替换成你的GitHub用户名和个人访问令牌（令牌需要开启write:packages权限）：

  <servers>
      <server>
          <id>github</id>
          <username>你的GitHub用户名</username>
          <password>你的GitHub个人访问令牌</password>
      </server>
  </servers>
  

• 执行发布命令：在JAR项目根目录运行：

  mvn clean deploy
  

  完成后，JAR会自动上传到GitHub Packages仓库。

2. 团队成员拉取最新依赖 #

• 配置项目pom.xml：在团队成员的项目pom.xml中添加GitHub Packages仓库：

  <repositories>
      <repository>
          <id>github</id>
          <url>https://maven.pkg.github.com/你的GitHub用户名/仓库名</url>
          <snapshots>
              <enabled>true</enabled>
          </snapshots>
      </repository>
  </repositories>
  

  然后添加对应依赖坐标，和发布的JAR保持一致：

  <dependency>
      <groupId>你的JAR项目groupId</groupId>
      <artifactId>你的JAR项目artifactId</artifactId>
      <version>最新版本号</version>
  </dependency>
  

• 配置Maven认证：团队成员同样需要在settings.xml中添加上述服务器配置（令牌需要开启read:packages权限），之后执行mvn clean install就能自动拉取最新版本的JAR。

方案二：使用GitHub Releases + JitPack #

如果你的JAR不是通过Maven构建的，或者不想使用GitHub Packages，这个方案更轻量化。

1. 上传JAR到GitHub Releases #

• 把更新后的JAR上传到你的GitHub仓库的Releases页面，给每个版本打唯一的tag（比如v1.0.0、v1.0.1）。
• 建议同时上传对应的pom.xml文件，确保依赖信息准确；如果没有，JitPack会自动生成基础pom，但可能缺失部分配置。

2. 团队成员配置依赖 #

• 在项目pom.xml中添加JitPack仓库：

  <repositories>
      <repository>
          <id>jitpack.io</id>
          <url>https://jitpack.io</url>
      </repository>
  </repositories>
  

• 添加依赖，格式为com.github.用户名:仓库名:tag：

  <dependency>
      <groupId>com.github.你的GitHub用户名</groupId>
      <artifactId>你的GitHub仓库名</artifactId>
      <version>v1.0.1</version>
  </dependency>
  

• 执行mvn clean install，JitPack会自动从GitHub Release拉取对应的JAR。

注意事项 #

• 版本号必须唯一：每次更新JAR都要更换版本号，避免Maven缓存旧版本导致拉取失败。
• 权限设置：确保GitHub仓库和Packages仓库对团队成员可见，个人访问令牌的权限要匹配（读/写）。
• 缓存问题：如果拉取不到最新版本，可执行mvn clean install -U强制更新依赖缓存。

内容的提问来源于stack exchange，提问作者Bachu ChennakesavaRao