Gradle作為編譯工具，理所當(dāng)然也要談?wù)?code>publish這塊吟税。Gradle提供了兩種發(fā)布方式蚌父，分別是ivy和maven撮慨，這里著重說(shuō)下maven的方式好了，這也是最常用的方式损晤。
PublishingExtension
Gradle提供出來(lái)的publishing閉包配置為：
publishing {
publications { ... }
repositories.maven { ... }
}
從前面的文章可知软棺，對(duì)應(yīng)的分別是兩個(gè)方法：
void repositories(Action<? super RepositoryHandler> configure)publications(Action<? super PublicationContainer> configure)
RepositoryHandler
repositories函數(shù)用來(lái)設(shè)置具體的RepositoryHandler實(shí)例（FlatDirectoryArtifactRepository，IvyArtifactRepository以及MavenArtifactRepository)沉馆。
repositories {
maven {
credentials {
username = "user"
password = "password"
}
url "https://xxx.com"
}
}
這里對(duì)應(yīng)的就是MavenArtifactRepository码党，分別調(diào)用方法setUrl(Object url)設(shè)置倉(cāng)庫(kù)地址以及方法credentials(Action<? super PasswordCredentials> action)設(shè)置倉(cāng)庫(kù)地址進(jìn)行登陸鑒權(quán)的用戶名和密碼。
PublicationContainer
同樣斥黑，publications用來(lái)創(chuàng)建PublicationContainer實(shí)例(IvyPublication以及MavenPublication)揖盘。
publications {
myPublication(MavenPublication) {
from components.java
artifact sourceJar
pom.withXml {
asNode().appendNode('description', 'A demonstration of Maven POM customization')
}
}
}
上述閉包配置作用在于創(chuàng)建兩個(gè)實(shí)現(xiàn)了MavenPublication接口的task。
-
publishMyPublicationToMavenLocal發(fā)布到本地倉(cāng)庫(kù) -
publishMyPublicationToMavenRepository發(fā)布到遠(yuǎn)程倉(cāng)庫(kù)锌奴。
理所當(dāng)然兽狭，這兩個(gè)task必須在build后執(zhí)行，因?yàn)樾枰?code>build后生成的jar或者aar包鹿蜀。
在前面task章節(jié)我們了解到這里需要進(jìn)行dependsOn配置箕慧。
tasks.whenTaskAdded { task ->
if (task.name == "publishMyPublicationToMavenLocal" ||
task.name == "publishMyPublicationToMavenRepository") {
task.dependsOn build
}
}
接下來(lái)，詳細(xì)了解具體的MavenPublication的配置選項(xiàng)茴恰。
MavenPublication
具體類為org.gradle.api.publish.maven.MavenPublication颠焦，詳細(xì)的方法可以自行查略，這里說(shuō)說(shuō)其中最為關(guān)鍵的幾個(gè)方法往枣。
-
void setGroupId(String groupId)設(shè)置groupID伐庭，對(duì)應(yīng)com.gradle:tools:1.0中的com.gradle粉渠。 -
void setArtifactId(String artifactId)設(shè)置artifactId，對(duì)應(yīng)com.gradle:tools:1.0中的tools圾另。 -
MavenArtifact artifact(Object source)添加MavenArtifact到publish任務(wù)中霸株。 -
void pom(Action<? super MavenPom> configure)配置Pom，對(duì)應(yīng)就是用來(lái)進(jìn)行遞歸依賴的Pom.xml中內(nèi)容集乔。
artifact
artifact方法是提供Object對(duì)象去件，具體是什么呢？主要是三種扰路。
-
artifact 'my-file-name.jar'具體的文件尤溜。 -
artifact sourceJar任務(wù)sourceJar輸出物，例如這里是對(duì)源碼進(jìn)行了打包的Jar包幼衰。 -
artifact source: sourceJar, classifier: 'src', extension: 'zip'通過(guò)source靴跛、classifier以及extension構(gòu)造的MavenArtifact實(shí)例，參數(shù)分別對(duì)應(yīng)源文件渡嚣，名稱類別(artifactId-classifier)以及擴(kuò)展名稱(.jar/.zip等)。
pom
pom方法通過(guò)傳遞一個(gè)MavenPom對(duì)象來(lái)添加對(duì)應(yīng)配置內(nèi)容到Pom.xml文件中肥印。
<dependencies>
<dependency>
<groupId>com.gradle</groupId>
<artifactId>design</artifactId>
<version>1.0</version>
<exclusions>
<exclusion>
<groupId>com.gradle</groupId>
<artifactId>support</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
org.gradle.api.artifacts.maven.MavenPom提供的get方法和xml中配置選項(xiàng)是一一對(duì)應(yīng)的识椰，例如getGroupId()、getArtifactId()等深碱。
這樣腹鹉，當(dāng)你發(fā)布出去的包被依賴的時(shí)候，所包含的Pom.xml中的com.gradle:design:1.0包也會(huì)依賴進(jìn)來(lái)敷硅，但是這個(gè)包所依賴的com.gradle:support卻除外不再依賴進(jìn)來(lái)功咒。
那我們?cè)趺慈?gòu)造一個(gè)這樣的MavenPom對(duì)象出來(lái)呢？有很多種方法绞蹦，這里提及一種最常見(jiàn)的方式力奋，MavenPom withXml(Action<XmlProvider> action)。
XmlProvider
可以通過(guò)xml文件格式進(jìn)行實(shí)現(xiàn)幽七。
pom.withXml({ XmlProvider xmlProvider ->
def dependenciesNode = xmlProvider.asNode().appendNode('dependencies')
def dependencyNode = dependenciesNode.appendNode('dependency')
dependencyNode.appendNode('groupId', "com.gradle")
dependencyNode.appendNode('artifactId', "com.tools")
dependencyNode.appendNode('version', "1.0")
//excludeRules是存儲(chǔ)org.gradle.api.artifacts.ExcludeRule對(duì)象的集合
if (excludeRules != null && excludeRules.size() > 0) {
def exclusionsNode = dependencyNode.appendNode('exclusions')
excludeRules.each { ExcludeRule rule ->
def exclusionNode = exclusionsNode.appendNode('exclusion')
exclusionNode.appendNode('groupId', rule.group)
exclusionNode.appendNode('artifactId', rule.module)
}
}
}
到此為止景殷，已經(jīng)可以完成對(duì)本地文件的發(fā)布(包含但不限于jar/aar/so等)，對(duì)應(yīng)的唯一依賴標(biāo)示為com.gradle:tools:1.0澡屡。
后續(xù)
Gradle提供的publish不僅僅可用于常規(guī)的jar猿挚、aar、so發(fā)布驶鹉，還可以發(fā)布一些我們?cè)谶M(jìn)行編譯的時(shí)候需要用到的腳本(python绩蜻、luna等)、配置信息等室埋，這些就需要針對(duì)編譯流程進(jìn)行各自的思考办绝。
