4. 发布项目

在公司开发中，如果采取Maven这种项目构建方式的，一般都会架设一个Nexus Maven私服在公司服务器上，一些公司积累的资源组件和*库没有提供的资源，以及一些项目都会发布到私服中，然后开发人员可以通过Maven在具体开发时导入内部资源。那么既然现在要用gradle替换Maven，那么这个需求则需要满足，通过查看官方文档，可以通过引入'maven-publish'实现。具体添加的配置如下：

.......

apply plugin: 'maven-publish'//添加Maven发布插件

.......

//上传资源配置

uploadArchives {

     repositories {

        mavenDeployer {

           //上传资源到Maven私服

            repository(url: "http://localhost:8081/nexus/content/repositories/releases/") {

                authentication(userName:"admin",password:"admin123")

            }

        pom.version ="$project.version"

        pom.artifactId ="$project.name"

        pom.groupId ="$project.group"

     }

   }

}

通过添加以上配置，通过upload命令，已经可以把项目发布到我的本地私服http://localhost:8081/nexus/content/repositories/releases/中。但是问题又来了，这里我只能把项目发布到本地的releases库中，但是如果我这个项目还是dev版或者snapshot版怎么办？

这里就是体现gradle构建方式比maven灵活的地方。整个build.gradle文件其实就是一段groovy语言的代码。说到这里大家就都懂了吧，根据不同版本发布到不同的库，这不就是一个条件判断的事嘛。

将url提取为变量，加入相关判断代码，如下：

//默认发布到Maven Nexus私服的发行库

def nexusUrl ="http://localhost:8081/nexus/content/repositories/releases/"

//如果为快照版本发布到Maven Nexus私服的快照库

if(version.endsWith("-SNAPSHOT")) {

     nexusUrl ="http://localhost:8081/nexus/content/repositories/snapshots/"

}

......

uploadArchives {

......

        //上传资源到Maven私服

      repository(url: nexusUrl) {

             authentication(userName:"admin",password:"admin123")

       }

......

}

好了，现在所有版本号为"-SNAPSHOT"的都会被发布到快照库，而其他的则会发布到发行库，现在执行下upload看下效果吧。。。。

图4.1 upload命令执行结果

图4.2 Nexus

图4.3 资源详情

另外，在引入了'maven-publish'后，如果配置了mavenLocal()，在upload时也会把资源提交到本地Maven资源库中。

图4.4 本地资源库

总结

几个小时的试玩，说明不了什么问题，但是gradle的灵活性确实还是让我印象深刻，非常能体现它约定优于配置的原则。但是如果要玩转它还需要学习一定的groovy语言。和程序猿都了解XML相比，这里有个时间成本。并且由于非常灵活，而很有可能出现配置的混乱，但是总体还是觉得利大于弊。写腻了配置XML的方式，在配置里写代码，想着都有趣。。。

（四）：3.x新版本发布资源的方式

说来惭愧，敲代码这么多年都没写半篇文章，本来想着好好写一回笔记，结果因为工作繁忙、生活琐事又落下了（其实是笔者范懒 >_<!）。这下“初探”这词是没法用了，想着就是写写平常使用时的心得，就改叫“日常”吧。

  扯了扯闲话，言归正传。公司要开发一个框架型的项目，本来想用Maven的，我想着之前写过一个多项目的Gradle配置就拿来直接用了。由于强迫症又发了，上官网下个新版本，结果发现3.1版本的文档里多了以下两篇：

34. Ivy Publishing (new)
35. Maven Publishing (new)

lvy 暂时没用过，不提。这里写一下使用Gradle发布资源到 Maven 仓库的方式，在新版本中Gradle在“maven-publish”插件中增加了发布的功能，用来取代旧版本中Task的方式（旧版本发布方式详见上一篇：Gradle初探（三）：发布项目到Nexus资源库）。官方文档原文如下：

This chapter describes the new incubating Maven publishing support provided by the “maven-publish” plugin. Eventually this new publishing support will replace publishing via the Upload task.
If you are looking for documentation on the original Maven publishing support using the Upload task please see Chapter 31, Publishing artifacts.

1. 创建项目以新版本的方式发布

创建一个Gradle项目（以多项目Gradle为例）

build.gradle文件内容：

group 'z99' version '1.0-SNAPSHOT' subprojects { group 'z99' version '1.0-SNAPSHOT' // 引用的插件 apply plugin: 'java' apply plugin: 'maven' apply plugin: 'maven-publish' // 编译环境 sourceCompatibility = jdkVer targetCompatibility = jdkVer // 字符集 tasks.withType(JavaCompile) { options.encoding = encoding } // 资源库 repositories { mavenLocal() maven { // 啊哈，配上阿里云的资源库，速度杠杠的 url "http://maven.aliyun.com/nexus/content/groups/public/" } jcenter() mavenCentral() } // 依赖 dependencies { testCompile group: 'junit', name: 'junit', version: junitVer compile group: 'org.slf4j', name: 'slf4j-log4j12', version: slf4jLog4j12Ver // 添加 libs 文件夹下的 jar compile fileTree(dir: 'libs', include: ['*.jar']) } // 打包 publishing { publications { mavenJava(MavenPublication) { from components.java } } } // 如果是发行版本，则上传到发行库。否则上传到快照库。 def postfixUrl = "repository/maven-snapshots" if (project.version.endsWith("-RELEASE")) { postfixUrl = "repository/maven-releases" } // 发布到本地Maven库和远程Maven服务器 publishing { repositories { mavenLocal() maven { credentials { username ossUserName password ossPwd } url "$ossHost/$postfixUrl/" } } } }

gradle.properties文件内容：

# 基本信息配置 jdkVer=1.8 encoding=UTF-8 # 资源库配置 ossRepoUrl=http://127.0.0.1:9001/repository/maven-public/ # 用于上传的资源库配置 ossHost=http://127.0.0.1:9001 ossUserName=admin ossPwd=admin123 # 依赖包版本配置 junitVer=4.12 slf4jLog4j12Ver=1.7.21 servletApiVer=3.1.0

settings.gradle文件内容：

rootProject.name = 'gradle-demo' include 'sub-a', 'sub-b'

build之后，文件结构如下：

QQ图片20161027000602.png

QQ图片20161027000556.png

之后执行“publish”命令，则可以将两个子项目分别都发布到maven私服和本地maven资源库中。

命令执行控制台输出：

QQ图片20161027003023.png

Maven私服库：

QQ图片20161027003132.png

Maven本地库：

QQ图片20161027003211.png

2. 子项目单独配置时的发布

写到这里，其实流程和旧版用Task的步骤差不多，但是这是在多项目中，各版本用统一的版本号发布的情况，但实际开发中主项目下各子模块项目的版本号不可能一致，之前旧版时，这种情况下就会出现一个比较难受的写法，如下：

为了主配置文件简洁，我引入一个subprojects.gradle文件来专门写子模块的部分。
subprojects.gradle文件具体内容如下：

project(':sub-a') { version '1.0-SNAPSHOT' } project(':sub-b') { version '2.0-SNAPSHOT' }

然后再build.gradle中，去掉子项目的版本配置，在文件尾部加上

apply from: 'subprojects.gradle'

即可。

用旧版本的方式发布一下看看：

首先修改build.gradle，注释掉publish的部分，加上upload的代码：

// 打包 /*publishing { publications { mavenJava(MavenPublication) { from components.java } } }*/ // 如果是发行版本，则上传到发行库。否则上传到快照库。 def postfixUrl = "repository/maven-snapshots" if (project.version.endsWith("-RELEASE")) { postfixUrl = "repository/maven-releases" } // 发布到本地Maven库和远程Maven服务器 /*publishing { repositories { mavenLocal() maven { credentials { username ossUserName password ossPwd } url "$ossHost/$postfixUrl/" } } }*/ uploadArchives.repositories.mavenDeployer { repository(url: "$ossHost/$postfixUrl/") { authentication(userName: ossUserName, password: ossPwd) } pom.version = project.version pom.artifactId = project.name pom.groupId = project.group }

然后执行“upload”（注意：不是3.x版本的“publish”）命令执行发布，结果如下：

Paste_Image.png

纳尼，发生了什么？这就是旧版本的问题所在了，通过截图可以知道版本号的位置变成了“unspecified”，也就是说“pom.version = project.version”时拿不到版本号的信息，这原因就在于旧版本中upload的配置是作为一个task进行配置，而在主配置文件中，我是先配置了upload，才引用了子项目的配置文件，因此，要想配置生效则只能改为：

subprojects {
// 之前的其他配置
}
apply from: 'subprojects.gradle'
subprojects {
// upload的配置
}

如此才能正常上传发布（这里就不演示了），这写法对于代码强迫症重症患者简直不能忍啊，所以一度有想换回Maven的念头。直到发现了新版本中的publish之后。
那么新版本的中，只需在原主配置的末尾加上'apply from: 'subprojects.gradle''即可。发布后控制台显示成功，如下图所示：

Paste_Image.png

3. 子项目包含jar、war等不同打包方式时的发布方法

一般子项目中也存在既有纯java的项目，也有web项目的情况。在例子中，比如把子项目2改为web项目，现在做下列的修改。

subprojects.gradle文件内容：

project(':sub-a') { version '1.0-SNAPSHOT' // 打包 publishing { publications { mavenJava(MavenPublication) { from components.java } } } } project(':sub-b') { version '2.0-SNAPSHOT' apply plugin: 'war' dependencies { providedCompile group: 'javax.servlet', name: 'javax.servlet-api', version: servletApiVer } publishing { publications { mavenJava(MavenPublication) { from components.web } } } }

build.gradle文件内容：

group 'z99' version '1.0-SNAPSHOT' subprojects { group 'z99' // 引用的插件 apply plugin: 'java' apply plugin: 'maven' apply plugin: 'maven-publish' // 编译环境 sourceCompatibility = jdkVer targetCompatibility = jdkVer // 字符集 tasks.withType(JavaCompile) { options.encoding = encoding } // 资源库 repositories { mavenLocal() maven { // 啊哈，配上阿里云的资源库，速度杠杠的 url "http://maven.aliyun.com/nexus/content/groups/public/" } jcenter() mavenCentral() } // 依赖 dependencies { testCompile group: 'junit', name: 'junit', version: junitVer compile group: 'org.slf4j', name: 'slf4j-log4j12', version: slf4jLog4j12Ver // 添加 libs 文件夹下的 jar compile fileTree(dir: 'libs', include: ['*.jar']) } // 如果是发行版本，则上传到发行库。否则上传到快照库。 def postfixUrl = "repository/maven-snapshots" if (project.version.endsWith("-RELEASE")) { postfixUrl = "repository/maven-releases" } // 发布到本地Maven库和远程Maven服务器 publishing { repositories { mavenLocal() maven { credentials { username ossUserName password ossPwd } url "$ossHost/$postfixUrl/" } } } } // 引入子项目的配置 apply from: 'subprojects.gradle'

执行结果，如下图：

Paste_Image.png

要点就是一个是“from components.java”，另一个是“from components.web”，目前3.1版官方貌似只给了这两种。
有一点要注意的是publishing这个配置不能覆盖（或者是我没找到方法），我一开始是没有删去打包java的publishing配置，想直接在war的独立配置里直接配一个打包为war的publishing配置，结果报错，说是不能配置多个components。目前尚未找到解决方案，先这么着吧。

有点犯困了，后面写的有点草率。今天就这样吧，明天还得加班 >_<!。引用一句老婆常说的话结尾吧：

哎，苦逼的程序猿。。。

转载自：http://www.jianshu.com/u/c69205324efe