简介

Maven是我们在开发java程序中经常使用的构建工具，在团队合作开发过程中，如果我们想要将自己写好的jar包共享给别人使用，通常需要自己搭建maven仓库，然后将写好的jar包上传到maven仓库中，以供其他用户使用。

搭建maven仓库需要服务器和域名，对公司而言域名和服务器多的是，但是如果是我们个人或者小团队想共享一些非常有用的jar包给别人使用就太麻烦了。

最近Github好消息频出，先是对个人用户取消了repositories和协作用户的个数限制，后面对于企业用户也进行了升级和降价处理。如果仓库不大的话，完全可以把仓库搬到github上面去。

更多精彩内容且看：

更多内容请访问 www.flydean.com

前期准备

要在github上面搭建maven仓库，我们需要使用到maven的插件：site-maven-plugin。因为要连到github上面，所以需要设置github的oauth权限。直接用用户名密码也可以，但是这样做不安全，我们并不推荐。

如上图所示，在Settings->Developer settings->Personal access tokens中创建一个access tokens,所需权限如下：

注意，用户这里的权限一定要选，否则后面会报异常。

有了权限，接下来我们再创建一个github-maven-repository,用来作为mvn仓库存储数据。

假如生成的地址是：https://github.com/flydean/gi...

在maven中配置GitHub权限

这一步我们需要编辑setting.xml文件，一般来说这个文件是在~/.m2/settings.xml。

我们需要添加一个Server,如果直接使用github的用户名密码，则像下面这样：


   github
    YOUR_USERNAME
    YOUR_PASSWORD

前面我们讲到了直接使用用户名是不安全的，我们可以使用上面创建的oauth key：


    github
    OAUTH2TOKEN

这个id会在后面的pom.xml文件配置中用到，这里我们先记下来。

配置deploy-plugin

我们的目标是生成包含jar包的maven依赖。在将jar包上传到远程仓库之前，我们需要在本地先生成。

先配置一个本地的repository:


        
            maven.repo
            Local Staging Repository
            file://${project.build.directory}/mvn-repo

上面我们指定了在项目的build目录下面创建了mvn-repo用来存储本地打好的package。

接下来，我们需要使用maven-deploy-plugin指定将打好的包部署到刚刚我们指定的local仓库中。


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

配置site-maven-plugin

现在我们就可以使用site-maven-plugin了：


            
            com.github.github
            site-maven-plugin
            0.12
            
                
                    
                        site
                    
                    
                    deploy
                    
                        
                        github
                        
                        init git maven repository
                        
                        github-maven-repository 
                        flydean 
                        
                        true
                        ${project.build.directory}/mvn-repo
                        refs/heads/mvn-repo

使用中要注意下面几点：

site-maven-plugin的goals是site，它需要跟maven的deploy phase相关联，从而在我们执行mvn deploy的时候自动运行site-maven-plugin。
github的权限配置，我们可以在configuration中设置server=github，也可以配置下面的全局变量：

    
        github

需要指定repositoryName和repositoryOwner，否则会报错。
message表示的是提交到github的消息。
默认情况下的提交到github中的branch是refs/heads/gh-pages，这里我们自定义了一个。

好了，一切都配置完了，我们可以运行了mvn deploy：

从上图可以看到，github上面已经有了一个可共享的项目了。

怎么使用这个共享的项目

使用起来很简单，只需要在pom.xml文件中添加相应的依赖和repository即可：


    YOUR.PROJECT.GROUPID
    ARTIFACT-ID
    VERSION



    ARTIFACT-ID
    https://raw.github.com/flydean/github-maven-repository/mvn-repo/

总结

Github带给我们的福利，赶紧用起来吧。

本文的例子[https://github.com/ddean2009/
learn-java-base-9-to-20](https://github.com/ddean2009/...

本文作者：flydean程序那些事
本文链接：http://www.flydean.com/apache-maven-git-repository/

本文来源：flydean的博客

欢迎关注我的公众号:程序那些事，更多精彩等着您！

使用site-maven-plugin在github上搭建公有仓库

简介

前期准备

在maven中配置GitHub权限

配置deploy-plugin

配置site-maven-plugin

怎么使用这个共享的项目

总结

你可能感兴趣的:(java,maven,构建工具)