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

欢迎访问我的GitHub

这里分类和汇总了欣宸的全部原创(含配套源码):https://github.com/zq2599/blog_demos

常见场景

  • 作为java库的开发者,如何让其他项目用上自己的java库?常用方式是上传到内网环境的Nexus3私服,其他java项目用maven或gradle从Nexus私服下载这个java库使用:
    Gradle项目的jar发布到私有仓库_第1张图片
  • 上述过程是一名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,按照下图操作新增一个帐号,用来执行上传下载操作:
    Gradle项目的jar发布到私有仓库_第2张图片

  2. 帐号基本信息如下,注意两个红框中的配置,状态是激活,角色您可以视情况而定,我这里为了简单就用了管理员角色:
    Gradle项目的jar发布到私有仓库_第3张图片

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

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

  1. 一般咱们会用到两种类型的仓库:release和snapshot,先创建release的,操作如下:
    Gradle项目的jar发布到私有仓库_第4张图片
  2. 类型选择maven2(hosted)
    Gradle项目的jar发布到私有仓库_第5张图片
  3. 需要设置的参数如下图,这里我起的名字是my-release,注意Version policy一定要选择Release
    Gradle项目的jar发布到私有仓库_第6张图片
  4. 点击底部的Create respository即可创建仓库;
  5. 接着创建snapshot类型的仓库,名字是my-snapshot,详情如下所示,注意Version policy一定要选择Snapshot,并且允许重复部署:
    Gradle项目的jar发布到私有仓库_第7张图片
  • 好了,设置完成,接下来进入开发环节,先把二方库部署到刚刚新建的仓库中,再在另一个应用中使用这个二方库;

将二方库部署到Nexus3

  1. 接下来的操作在您的二方库工程上进行,我这里用的是一个典型父子结构的gradle工程,该工程详情请参考《Gradle构建多模块SpringBoot应用》,下图红框中的democlient就是二方库模块,这里面只有一个Student类,咱们要做的就是将democlient模块构建成jar并部署到Nexus3的仓库中:
    Gradle项目的jar发布到私有仓库_第8张图片
  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:
    Gradle项目的jar发布到私有仓库_第9张图片
  2. 确认您项目的version,我这里是1.0.0-SNAPSHOT,如下图红框,所以构建出的jar会上传的my-snapshot仓库:
    Gradle项目的jar发布到私有仓库_第10张图片
  3. 设置完毕后双击下图红框中的按钮,即可开始编译和构建:
    Gradle项目的jar发布到私有仓库_第11张图片
  4. 构建完成后控制台输出如下,可见会先做编译打包再上传:
    Gradle项目的jar发布到私有仓库_第12张图片
  5. 去Nexus3看看,点击下图位置查看仓库内容:
    Gradle项目的jar发布到私有仓库_第13张图片
  6. 如下图,jar已经上传成功,这里有多个是因为我这边执行了多次uploadArchives任务:
    Gradle项目的jar发布到私有仓库_第14张图片

上传到my-release仓库

  • 篇幅所限,就不展示上传到my-release仓库的过程了,因为和前面上传到my-snapshot的操作是一样的,唯一的不同就是项目version中不要有snapshot,如下图,这样就能上传到my-release仓库:
    Gradle项目的jar发布到私有仓库_第15张图片
  • 需要注意的是,之前创建my-release仓库时,其Deployment policy选项为Disable redeploy,即不允许同一个version重复提交,因此同一个version只能成功上传一次,如果再次上传会报错,如下图:
    Gradle项目的jar发布到私有仓库_第16张图片

使用仓库的内容

使用仓库的方法很简单,首先确保使用者的电脑能够访问到仓库,再在项目中配置仓库地址和jar坐标就行了,如下图红框:
Gradle项目的jar发布到私有仓库_第17张图片

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

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

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

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

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

你可能感兴趣的:(java服务端,java,gradle,nexus3)