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

常见场景

• 作为java库的开发者，如何让其他项目用上自己的java库？常用方式是上传到内网环境的Nexus3私服，其他java项目用maven或gradle从Nexus私服下载这个java库使用：

• 上述过程是一名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》
2. 《群晖DS218+做maven私服(nexus3)》
3. 《Nexus3常用功能备忘》

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

Nexus3上创建帐号

1. 以管理员身份登录Nexus3，按照下图操作新增一个帐号，用来执行上传下载操作：

1. 帐号基本信息如下，注意两个红框中的配置，状态是激活，角色您可以视情况而定，我这里为了简单就用了管理员角色：

1. 最后点击底部的Create local user按钮完成创建；

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

1. 一般咱们会用到两种类型的仓库：release和snapshot，先创建release的，操作如下：

1. 类型选择maven2(hosted)：

1. 需要设置的参数如下图，这里我起的名字是my-release，注意Version policy一定要选择Release：

1. 点击底部的Create respository即可创建仓库；
2. 接着创建snapshot类型的仓库，名字是my-snapshot，详情如下所示，注意Version policy一定要选择Snapshot，并且允许重复部署：

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

将二方库部署到Nexus3

1. 接下来的操作在您的二方库工程上进行，我这里用的是一个典型父子结构的gradle工程，该工程详情请参考《Gradle构建多模块SpringBoot应用》，下图红框中的democlient就是二方库模块，这里面只有一个Student类，咱们要做的就是将democlient模块构建成jar并部署到Nexus3的仓库中：

1. 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：

1. 确认您项目的version，我这里是1.0.0-SNAPSHOT，如下图红框，所以构建出的jar会上传的my-snapshot仓库：

1. 设置完毕后双击下图红框中的按钮，即可开始编译和构建：

1. 构建完成后控制台输出如下，可见会先做编译打包再上传：

1. 去Nexus3看看，点击下图位置查看仓库内容：

1. 如下图，jar已经上传成功，这里有多个是因为我这边执行了多次uploadArchives任务：

上传到my-release仓库

• 篇幅所限，就不展示上传到my-release仓库的过程了，因为和前面上传到my-snapshot的操作是一样的，唯一的不同就是项目version中不要有snapshot，如下图，这样就能上传到my-release仓库：

• 需要注意的是，之前创建my-release仓库时，其Deployment policy选项为Disable redeploy，即不允许同一个version重复提交，因此同一个version只能成功上传一次，如果再次上传会报错，如下图：

使用仓库的内容

使用仓库的方法很简单，首先确保使用者的电脑能够访问到仓库，再在项目中配置仓库地址和jar坐标就行了，如下图红框：

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