摘要：本文主要介紹如何一個(gè)由構(gòu)建的項(xiàng)目部署到網(wǎng)上大部分都是介紹如何將由構(gòu)建的項(xiàng)目部署到。申請(qǐng)賬號(hào)前往申請(qǐng)賬號(hào)。其中有和這兩個(gè)變量是定義在中的。這些信息不要加入到版本管理中。發(fā)布過(guò)程當(dāng)上述步驟全部完成時(shí)，可以直接執(zhí)行。

本文主要介紹如何一個(gè)由gradle構(gòu)建的項(xiàng)目部署到Maven Central.

網(wǎng)上大部分都是介紹如何將由maven構(gòu)建的項(xiàng)目部署到Maven Central。與Gradle相關(guān)的比較少。

前往 sonatype申請(qǐng)賬號(hào)。

申請(qǐng)完，Create Issue。

按照這個(gè)模板填。

這一塊比較簡(jiǎn)單，網(wǎng)上教程也比較多。

Create Issue結(jié)束后，官方會(huì)需要你證明你擁有相對(duì)應(yīng)的domain。

證明有以下3個(gè)途徑：

Add a TXT record to your DNS referencing this JIRA ticket: OSSRH-44681 (Fastest)

Setup a redirect to your Github page (if it does not already exist)

Send an email to [email protected] referencing this issue from a ... email address

證明完畢之后，你就可以發(fā)布包了。

你就可以做下面幾件事了：

Deploy snapshot artifacts into repository https://oss.sonatype.org/cont...

Deploy release artifacts into the staging repository https://oss.sonatype.org/serv...

Promote staged artifacts into repository "Releases"

Download snapshot and release artifacts from group https://oss.sonatype.org/cont...

Download snapshot, release and staged artifacts from staging group https://oss.sonatype.org/cont...

下面主要內(nèi)容基于 官方英文教程，加上一些個(gè)人構(gòu)建時(shí)候的一些收獲。

apply plugin: "maven"
apply plugin: "signing"

task javadocJar(type: Jar) {
    classifier = "javadoc"
    from javadoc
}

task sourcesJar(type: Jar) {
    classifier = "sources"
    from sourceSets.main.allSource
}

artifacts {
    archives javadocJar, sourcesJar
}

引入UploadArchives這個(gè)task，記住更改里面的個(gè)人相關(guān)信息。

其中有ossrhUsername和ossrhPassword這兩個(gè)變量是定義在gradle.properties中的。

uploadArchives {
    repositories {
        mavenDeployer {
            beforeDeployment { MavenDeployment deployment -> signing.signPom(deployment) }

            repository(url: "https://oss.sonatype.org/service/local/staging/deploy/maven2/") {
                authentication(userName: ossrhUsername, password: ossrhPassword)
            }

            snapshotRepository(url: "https://oss.sonatype.org/content/repositories/snapshots/") {
                authentication(userName: ossrhUsername, password: ossrhPassword)
            }

            pom.project {
                name "Example Application"
                packaging "jar"
                // optionally artifactId can be defined here 
                description "A application used as an example on how to set up 
                pushing its components to the Central Repository . "
                url "http://www.example.com/example-application"

                scm {
                    connection "scm:git:[email protected]:username/project.git"
                    developerConnection "scm:git:[email protected]:username/project.git"
                    url "https://github.com/username/project"
                }

                licenses {
                    license {
                        name "The Apache License, Version 2.0"
                        url "http://www.apache.org/licenses/LICENSE-2.0.txt"
                    }
                }

                developers {
                    developer {
                        id "manfred"
                        name "Manfred Moser"
                        email "[email protected]"
                    }
                }
            }
        }
    }
}

主要是將一些認(rèn)證信息填在這里。（這些信息不要加入到版本管理中)。

以下3個(gè)信息怎么來(lái)下一章節(jié)來(lái)講
signing.keyId=YourKeyId
signing.password=YourPublicKeyPassword
signing.secretKeyRingFile=PathToYourKeyRingFile

ossrhUsername=your-jira-id  你在sonatype申請(qǐng)的賬號(hào)的用戶名
ossrhPassword=your-jira-password  你在sonatype申請(qǐng)的賬號(hào)的密碼

windows中可以安裝gpg4win來(lái)生成相關(guān)信息。但是我個(gè)人在windows10中并沒(méi)有能夠打開(kāi)。
所以我使用了WSL來(lái)生成相關(guān)信息。如果你的系統(tǒng)是Linux也可以。

執(zhí)行gpg --gen-key, 按照提示的信息填入密碼，用戶名等信息，這些信息記錄下來(lái)。這里填入的密碼就是上面gradle.properties中的signing.password。

執(zhí)行gpg --list-keys, 可以看到

/root/.gnupg/pubring.gpg
pub   2048R/B98765 2018-12-08
uid                  
sub 2048R/A123456 

第一行便是對(duì)應(yīng)的公鑰文件位置，pug后面的B98765便是public key Id，這個(gè)id也就是上面gradle.properties中的signing.keyId

執(zhí)行 gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys B98765將公鑰發(fā)送到hkp://pool.sks-keyservers.net。

記錄下/root/.gnupg/中secring.png的位置，這個(gè)位置便是上面gradle.properties中的signing.secretKeyRingFile的值。

當(dāng)上述步驟全部完成時(shí)，可以直接執(zhí)行gradle uploadArchives。

如果你的版本是snapshot的，你可以直接在https://oss.sonatype.org/content/repositories/snapshots中看到你的包。

如果你的版本是release版本。
登錄https://oss.sonatype.org/#welcome,選擇Staging Repositories，然后在右邊用groupId去搜索。
這樣會(huì)找到你的項(xiàng)目。選中你的項(xiàng)目close然后confirm。過(guò)一會(huì)再來(lái)尋找一次該構(gòu)建，點(diǎn)擊Release在Confirm。過(guò)一會(huì)就應(yīng)該能在https://oss.sonatype.org/content/groups/public中看到你的項(xiàng)目了。

這里Close可能觸發(fā)一些錯(cuò)誤，可以點(diǎn)擊下方的Activity來(lái)查看錯(cuò)誤的原因。一般來(lái)說(shuō)，可能是并沒(méi)有javadoc和source導(dǎo)致的。