Gradle项目的jar发布到私有仓库

迈不过友情╰ 2022-11-18 02:06 235阅读 0赞

### 欢迎访问我的GitHub ###

> 这里分类和汇总了欣宸的全部原创(含配套源码)：[https://github.com/zq2599/blog\_demos][https_github.com_zq2599_blog_demos]

### 常见场景 ###

*  作为java库的开发者，如何让其他项目用上自己的java库？常用方式是上传到内网环境的Nexus3私服，其他java项目用maven或gradle从Nexus私服下载这个java库使用：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70]
 *  上述过程是一名java程序员的基本功，今天咱们就来实战演练这套基本功，全文由以下内容组成：

1.  准备工作
2.  Nexus3上创建帐号
3.  Nexus3上创建两个仓库(release和snapshot)
4.  java库的项目中添加上传jar的配置，并验证上传
5.  使用java库的项目中添加下载jar的配置，并验证使用
6.  snapshot更新验证
7.  release验证

### 前提 ###

开始实战前有些准备工作要先完成，首先是本地开发环境：

1.  操作系统：win10
2.  JDK：1.8.0\_281
3.  Gradle：6.8.3
4.  IDEA：2021.1 (Ultimate Edition)

还请在局域网部署Nexus3私服，部署和配置方式请请参考：

1.  [《Ubuntu部署和体验Nexus3》][Ubuntu_Nexus3]
2.  [《群晖DS218+做maven私服(nexus3)》][DS218_maven_nexus3]
3.  [《Nexus3常用功能备忘》][Nexus3]

*  上述准备工作完成后，可以开始实战操作了；

### Nexus3上创建帐号 ###

1.  以管理员身份登录Nexus3，按照下图操作新增一个帐号，用来执行上传下载操作：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 1]
2.  帐号基本信息如下，注意两个红框中的配置，状态是激活，角色您可以视情况而定，我这里为了简单就用了管理员角色：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 2]
3.  最后点击底部的Create local user按钮完成创建；

### Nexus3上创建两个仓库(release和snapshot) ###

1.  一般咱们会用到两种类型的仓库：release和snapshot，先创建release的，操作如下：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 3]
2.  类型选择maven2(hosted)：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 4]
3.  需要设置的参数如下图，这里我起的名字是my-release，注意Version policy一定要选择**Release**：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 5]
4.  点击底部的Create respository即可创建仓库；
5.  接着创建snapshot类型的仓库，名字是my-snapshot，详情如下所示，注意Version policy一定要选择**Snapshot**，并且允许重复部署：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 6]

*  好了，设置完成，接下来进入开发环节，先把二方库部署到刚刚新建的仓库中，再在另一个应用中使用这个二方库；

### 将二方库部署到Nexus3 ###

1.  接下来的操作在您的二方库工程上进行，我这里用的是一个典型父子结构的gradle工程，该工程详情请参考[《Gradle构建多模块SpringBoot应用》][Gradle_SpringBoot]，下图红框中的democlient就是二方库模块，这里面只有一个Student类，咱们要做的就是将democlient模块构建成jar并部署到Nexus3的仓库中：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 7]
2.  democlient模块的build.gradle如下，与上传操作有关的是maven插件，以及uploadArchives任务的参数，其中仓库的url参数的来源稍后会讲到：

plugins { 
        id 'java-library'
        // 使用maven插件执行上传jar到Nexus3的操作
        id 'maven'
    }
    
    // 如果要上传库到私服，就在此添加
    def uploadGroup = group
    def uploadArtifactId = this.name
    def uploadVersion = version
    
    // uploadArchives任务的配置
    uploadArchives { 
        // 仓库配置
        repositories { 
            mavenDeployer { 
                // release仓库的配置
                repository(url: 'http://192.168.50.43:8081/repository/my-release/') { 
                    authentication(
                            // Nexus3上有权限上传jar的帐号及其密码
                            userName: 'bolingcavalry',
                            password: '123456'
                    )
                }
                // snapshot仓库的配置
                snapshotRepository(url: 'http://192.168.50.43:8081/repository/my-snapshot/') { 
                    authentication(
                            // Nexus3上有权限上传jar的帐号及其密码
                            userName: 'bolingcavalry',
                            password: '123456'
                    )
                }
    
                // 二方库的身份参数：group、artifact、version
                pom.groupId = uploadGroup
                pom.artifactId = uploadArtifactId
                pom.version = uploadVersion
            }
        }
    }
    
    // 子模块自己的依赖
    dependencies { 
        // 使用api，将依赖传递给使用democlient的模块
        api 'org.projectlombok:lombok'
        // annotationProcessor不会传递，使用了lombok生成代码的模块，需要自己声明annotationProcessor
        annotationProcessor 'org.projectlombok:lombok'
    }

1.  uploadArchives任务中的仓库url参数，请直接从仓库的详情页复制，如下图红框4就是my-release仓库的url：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 8]
2.  确认您项目的version，我这里是1.0.0-SNAPSHOT，如下图红框，所以构建出的jar会上传的my-snapshot仓库：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 9]
3.  设置完毕后双击下图红框中的按钮，即可开始编译和构建：  
    ![在这里插入图片描述][20210412224834268.png]
4.  构建完成后控制台输出如下，可见会先做编译打包再上传：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 10]
5.  去Nexus3看看，点击下图位置查看仓库内容：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 11]
6.  如下图，jar已经上传成功，这里有多个是因为我这边执行了多次uploadArchives任务：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 12]

### 上传到my-release仓库 ###

*  篇幅所限，就不展示上传到my-release仓库的过程了，因为和前面上传到my-snapshot的操作是一样的，唯一的不同就是项目version中不要有snapshot，如下图，这样就能上传到my-release仓库：  
    ![在这里插入图片描述][2021041222580789.png]
 *  需要注意的是，之前创建my-release仓库时，其Deployment policy选项为Disable redeploy，即不允许同一个version重复提交，因此同一个version只能成功上传一次，如果再次上传会报错，如下图：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 13]

### 使用仓库的内容 ###

使用仓库的方法很简单，首先确保使用者的电脑能够访问到仓库，再在项目中配置仓库地址和jar坐标就行了，如下图红框：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 14]

*  以上就是Gradle项目的jar发布到私有仓库和使用该jar的完整过程，如果您正在发布二方库，希望本文可以给您一些参考；

### 你不孤单，欣宸原创一路相伴 ###

1.  [Java系列][Java]
2.  [Spring系列][Spring]
3.  [Docker系列][Docker]
4.  [kubernetes系列][kubernetes]
5.  [数据库+中间件系列][Link 1]
6.  [DevOps系列][DevOps]

### 欢迎关注公众号：程序员欣宸 ###

> 微信搜索「程序员欣宸」，我是欣宸，期待与您一同畅游Java世界…

[https_github.com_zq2599_blog_demos]: https://github.com/zq2599/blog_demos
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70]: /images/20221022/e87ef3e1e7ea4f56a894292e44f77ed5.png
[Ubuntu_Nexus3]: https://xinchen.blog.csdn.net/article/details/104617262
[DS218_maven_nexus3]: https://xinchen.blog.csdn.net/article/details/105458466
[Nexus3]: https://xinchen.blog.csdn.net/article/details/105458882
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 1]: /images/20221022/622b5200a0a84fb184404a44d8e98cff.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 2]: /images/20221022/17bc1d0f61e642e788d895a2fb256b0c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 3]: /images/20221022/918c2e7acce4402284e2525c2ff99642.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 4]: /images/20221022/9d74881e871e4b85a04a73ae8b038f81.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 5]: /images/20221022/b426747ca56142098294cae4cda7211c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 6]: /images/20221022/3e9c7798c3774ca29d2398bf62e6bfd8.png
[Gradle_SpringBoot]: https://xinchen.blog.csdn.net/article/details/115049633
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 7]: /images/20221022/42a4ba242b3442ebbf1b379a2a05a128.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 8]: /images/20221022/64ae1099b9f94269be0100853f660f24.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 9]: /images/20221022/462b7f02d79542fdbadb654f9329ee6d.png
[20210412224834268.png]: /images/20221022/6ada5f1c632a41adbd7e54cc1729de26.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 10]: /images/20221022/39ff2afa8b2d45b1a39eff728db76970.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 11]: /images/20221022/70996ba88cd34844be12d351adab9694.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 12]: /images/20221022/4b7714a623cd4aa1bf77a0746bf73506.png
[2021041222580789.png]: /images/20221022/002eb2baafd04d808c35341cd3791c2f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 13]: /images/20221022/5d27dcc157ee4a52947da9f4153a3a7b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 14]: /images/20221022/0fcbaba7d6634c16a5ed7ffd1e5d59f4.png
[Java]: https://xinchen.blog.csdn.net/article/details/105068742
[Spring]: https://xinchen.blog.csdn.net/article/details/105086498
[Docker]: https://xinchen.blog.csdn.net/article/details/105086732
[kubernetes]: https://xinchen.blog.csdn.net/article/details/105086794
[Link 1]: https://xinchen.blog.csdn.net/article/details/105086850
[DevOps]: https://xinchen.blog.csdn.net/article/details/105086920