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

扯了扯闲话，言归正传。公司要开发一个框架型的项目，本来想用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。目前尚未找到解决方案，先这么着吧。

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

哎，苦逼的程序猿。。。