GitHub上创建自己的Maven仓库并引用

GitHub创建maven仓库.png

说明：将github的某个仓库作为公共的maven仓库，可以将自己写的项目发布到github上的公共的maven仓库里，然后再以pom引入依赖的方式使用。

1.上传时，可以选择不同版本上传的不同的分支上，此处时master分支，例，可以创建snapshot，release等分支。

2.将项目打包发布到github公共maven仓库几种方式

• maven项目通过配置pom.xml实现(不推荐，配置繁琐)
• 命令行方式(推荐，命令行操作)
• 脚本方式（极力推荐操作简单）

一、maven项目通过配置pom.xml实现

配置项目deploy(发布)到github步骤

1、完善github用户名配置
登录到github中，然后点击Settings-->修改用户名(英文)
点击"Update profile" 保存修改。

修改用户名目的：防止上传jar报未知异常，例如" For 'properties/name', nil is not a string"异常。

2、配置maven工具的settings.xml文件,找到servers标签，添加一个server

    
        github
        guihub登录的用户名
        guihub登录的用户密码
    

3、将jar deploy(发布)到本地存储库中
在maven项目的pom.xml中添加入下代码

    
    
        maven-deploy-plugin
        2.8.1
        
            internal.repo::default::file://${project.build.directory}/mvn-repo
        
    

运行命令: 将本地的jar发布到本地仓库中

mvn clean deploy

即可在对应项目中的target/mvn-repo目录(存储库)下找到本地的jar.

4、将本地存储库位置的jar文件发布到github上
在maven项目的pom.xml中添加入下代码

    
        github
    
    
    
    
        com.github.github
        site-maven-plugin
        0.12
        
            Maven artifacts for ${project.version}
            true
            
            ${project.build.directory}/mvn-repo
            
            refs/heads/master
            true
            
                **/*
            
            
            mvn-repo
            
            zhengjiaao
        
        
            
                
                    site
                
                deploy
            
        
    

再次执行命令:发布到github上

mvn clean deploy

此时打开github查看并刷新仓库mvn-repo，已经存在上传的jar。

上传后效果图：

mvn_1.png

5、使用已上传github存储库的jar并测试是否可用。
使用上传到github上的jar依赖
随便找个maven项目，在pom.xml添加配置

    
        
            mvn-repo
            
            https://raw.github.com/zhengjiaao/mvn-repo/master
            
                true
                always
            
        
    
    
    
        com.zja
        github-util
        0.0.1-SNAPSHOT
    
    

测试jar包里的实体类是否可用：

//没有报错，可以使用github-util jar中的类
AbcEntity abcEntity = new AbcEntity();

项目的pom.xml完整deploy配置

    
        github
    

    
        
            
            
                maven-deploy-plugin
                2.8.1
                
                    internal.repo::default::file://${project.build.directory}/mvn-repo
                
            

            
            
                com.github.github
                site-maven-plugin
                0.12
                
                    Maven artifacts for ${project.version}
                    true
                    
                    ${project.build.directory}/mvn-repo
                    
                    refs/heads/master
                    true
                    
                        **/*
                    
                    
                    mvn-repo
                    
                    zhengjiaao
                
                
                    
                        
                            site
                        
                        deploy
                    
                
            
        
    
    

二、命令行方式

新建本地存储库位置：D:/GitHub/maven-repository
执行命令：将项目发布到本地存储库

## deploy项目到本地仓库
mvn clean deploy -Dmaven.test.skip  -DaltDeploymentRepository=self-mvn-repo::default::file:D:/GitHub/maven-repository

github新建远程仓库，仓库名称:maven-repository
执行命令：将项目存储库里的jar上传到github 的maven-repository仓库上

#1.进入项目到本地仓库
$ cd D:/GitHub/maven-repository
#添加md文档
$ echo "# maven-repository" >> README.md
#2.git初始化
$ git init
#3.将本地仓库内容添加到暂存区
$ git add .
#4.将暂存区内容提交
$ git commit -m "提交存储库"
#5.绑定远程github仓库
$ git remote add origin https://github.com/zhengjiaao/maven-repository.git
#6.将本地仓库推送至远程github的maven-repository仓库上
$ git push -u origin master

使用上传的jar
随便找个maven项目，在pom.xml添加配置

    
        
            maven-repository
            
            https://raw.github.com/zhengjiaao/maven-repository/master
            
                true
                always
            
        
    
    
    
        com.zja
        github-util
        0.0.1-SNAPSHOT
    
    

测试jar包里的实体类是否可用：

//没有报错，可以使用github-util jar中的类
AbcEntity abcEntity = new AbcEntity();

三、脚本方式

• 1.将git安装位置下的cmd目录配置到环境变量中

  例如：D:\Git\cmd

• 2.新建github远程仓库，仓库名称:maven-repository

  远程仓库地址：https://github.com/zhengjiaao/maven-repository.git

  relation.bat脚本作用：(脚本可放在任何电脑位置，“双击执行脚本”)

  1.创建本地仓库，并与远程仓库关联
  2.新建master、snapshot、release等分支

  relation.bat:直接双击执行脚本

  chcp 65001
  ::此脚本仅执行一次，不可多次执行
  ::【需要修改1】：github本地仓库，非maven存储库
  set DEPLOY_PATH=D:\GitHub\maven-repository
  
  D:
  ::创建本地仓库
  md %DEPLOY_PATH%
  cd %DEPLOY_PATH%
  
  ::将本地仓库与远程仓库关联
  echo "# maven-repository" >> README.md
  git init
  git add README.md
  git commit -m "first commit"
  git remote add origin https://github.com/zhengjiaao/maven-repository.git
  git push -u origin master
  
  ::新建分支snapshot，并将新建的分支推送到远程仓库
  git switch -c snapshot
  git push --set-upstream origin snapshot
  
  git switch -c release
  git push --set-upstream origin release
  
  pause
  
  

  分支作用：
  master分支管理所有的版本
  snapshot分支只管理项目中的snapshot版本
  release分支只管理项目中的release版本

• 4.新建脚本放到项目根路径下

  执行脚本前提：远程仓库已有master、snapshot、release分支

  github.bat：传参执行脚本 例如：./github.bat r

chcp 65001
echo "注：1、将此bat脚本文件放到项目跟路径下"
echo "    2、启动CMD 参传方式: github.bat r/s"
echo "    3、参数说明：r/s r是release正式版本，s是snapshot快照版本"

:: deploy参数，snapshot 表示快照包，简写为s， release表示正式包，简写为r
set arg=%1

::【需要修改1】：github本地存储库，非maven存储库
set DEPLOY_PATH=D:/GitHub/maven-repository/
::分支
set "branch="

:: 快照包发布 snapshot分支
if "s"=="%arg%" (
    set "branch=snapshot"
)

:: 正式包发布 release分支
if "r"=="%arg%" (
    set "branch=release"
)

D:
cd %DEPLOY_PATH%
git pull

echo 切换对应分支%branch%
git checkout %branch%

::【需要修改2】：项目的磁盘
J:
::回到项目当前根目录
cd %~dp0
echo 开始deploy,将项目发布到本地存储库%DEPLOY_PATH%
call mvn clean deploy -Dmaven.test.skip  -DaltDeploymentRepository=self-mvn-repo::default::file:%DEPLOY_PATH%

D:
cd %DEPLOY_PATH%
echo 本地存储库的发送到github仓库%branch%分支上
git add .
git commit -m "提交新的版本"
git pull
git push origin %branch%

echo 将%branch%分支合并到master分支
git checkout master
git add .
git git commit -m 'master'
git merge %branch%
git commit -m 'master merge'
git push origin master

::git push origin master

pause