關於我對Gradle的翻譯，以Github上的專案及http://gradledoc.qiniudn.com 上的文件為準。如發現翻譯有誤的地方，將首先在以上兩個地方更新。因時間精力問題，部落格中發表的譯文基本不會同步修改。

另外，目前Gradle1.12版本的文件我電腦上已經翻譯到第六十三章，所以該版本的翻譯也進入校稿階段，校稿的方式可以為到該專案https://github.com/msdx/gradledoc 提交issue或者是pull request。

第五十二章. Maven 外掛

此章節還在完善中。

Maven 外掛添加了將專案部署到 Maven 倉庫的支援。

52.1. 用法

要使用 Maven 外掛，請在構建指令碼中包含以下語句：

示例 52.1. 使用 Maven 外掛

build.gradle

apply plugin: 'maven'

52.2. 任務

Maven 外掛定義了以下任務：

表 52.1. Maven 外掛 - 任務

52.3. 依賴管理

Maven 外掛不定義任何依賴配置。

52.4. 約定屬性

Maven 外掛定義了下列約定屬性：

表 52.2. Maven 外掛 - 屬性

52.5. 約定方法

Maven 外掛提供了用於建立 POM 的工廠方法，如果你需要一個 POM 檔案但是沒有上傳到 Maven 倉庫的場景，這個工廠方法將非常有用。

示例 52.2. 建立一個單獨的 pom。

build.gradle

task writeNewPom << {
    pom {
        project
            inceptionYear '2008'
            licenses {
                license {
                    name 'The Apache Software License, Version 2.0'
                    url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    distribution 'repo'
                }
            }
        }
    }.writeTo("$buildDir/newpom.xml")
}

除其他事項外，Gradle支援和polyglot Maven同樣的生成器語法。如果要了解關於 Gradle Maven POM 物件的更多資訊，請參閱MavenPom。請參見： MavenPluginConvention

52.6. 與 Maven 倉庫的互動

52.6.1. 介紹

通過 Gradle你可以部署到遠端 Maven 倉庫，或者是安裝到你的本地 Maven 倉庫。這包括所有的 Maven 元資料操縱，並且 Maven snapshot一樣可用。事實上，Gradle 的部署是 100%相容 Maven的，因為我們在hood下使用的是本地的 Maven Ant 任務。

如果你沒有一個POM檔案，部署到 Maven 倉庫只有一半的樂趣。幸運的是 Gradle 可以使用它的依賴資訊為你生成這個 POM。

52.6.2. 部署到 Maven 倉庫

讓我們假設你的專案只是產生預設的 jar 檔案。現在你想要將這個 jar 檔案部署到遠端 Maven 倉庫。

示例 52.3. 上傳檔案到遠端 Maven 倉庫

build.gradle

apply plugin: 'maven'

uploadArchives {
    repositories {
        mavenDeployer {
            repository(url: "file://localhost/tmp/myRepo/")
        }
    }
}

就這些了。呼叫uploadArchives任務將生成 POM，並將部署構件和 POM 到指定的倉庫。

如果你需要支援檔案之外的其他協議，那麼你還需要再做一些事情。在這種情況下，我們必須將委派本地的Maven程式碼給第三方庫實現。具體是哪些庫，將取決於你需要的協議。表 52.3. “Maven 部署的協議jar”列出了可用的協議以及相應的庫（這些庫又有具有傳遞依賴，而這些依賴也有其自己的傳遞依賴）。^[19] 舉個例子，要使用ssh協議，你可以：

示例 52.4. 通過 SSH 上傳檔案

build.gradle

configurations {
    deployerJars
}

repositories {
    mavenCentral()
}

dependencies {
    deployerJars "org.apache.maven.wagon:wagon-ssh:2.2"
}

uploadArchives {
    repositories.mavenDeployer {
        configuration = configurations.deployerJars
        repository(url: "scp://repos.mycompany.com/releases") {
            authentication(userName: "me", password: "myPassword")
        }
    }
}

Maven deployer有很多配置選項。這個配置通過一個 Groovy builder 來完成。這個配置樹的所有元素都是 Java beans。你可以傳一個map到bean元素中，來配置簡單的屬性。如果要新增另一個bean元素到它的parent，你可以使用一個閉包。在上例中repository和authentication都是這樣的 bean 元素。表 52.4，"MavenDeployer 的配置元素"列出了可用的 bean 元素，以及 javadoc 中相應類的連結。在javadoc 中你可以看到可能的屬性，這些屬性你可以設定為特定的元素。

在 Maven 中你可以定義倉庫和snapshot倉庫。如果沒有定義任何snapshot 倉庫，release和snapshot都將部署到repository元素中。否則，snapshots將部署到snapshotRepository元素中。

表 52.3. Maven 部署的協議 jars

52.6.3. 安裝到本地倉庫

Maven 外掛將install任務新增到你的專案。這個任務依賴於archives配置的所有archives任務。它將這些archives安裝到你的本地 Maven 倉庫中。本地倉庫的預設位置是否在 Maven settings.xml中被重新定義，這項任務也會考慮到。

52.6.4. Maven POM 生成

當部署一個artifact 到一個 Maven 庫時，Gradle 會自動為它生成一個POM。下表展示了用於POM的groupId，artifactId，version和packaging元素的預設值。這些dependency元素由project 的依賴宣告所建立。

表 52.5. Maven POM 生成的預設值

在這裡， uploadTask和archiveTask分別指向上傳和分別生成archive的任務（例如uploadArchives和jar）。archiveTask.baseName預設為project.archivesBaseName，後者預設為project.name。

當你將archiveTask.baseName設定為非預設值時，請確保將uploadTask.repositories.mavenDeployer.pom.artifactId設定為相同的值。否則，在相同的構建中，這個專案可能會被其他專案所生成的POMs 中錯誤的 artifact ID所引用到。

生成的 POMs 可以在<buildDir>/poms看到。它們可以通過MavenPom API 進一步定製化。例如，你可能希望部署到 Maven 倉庫中的artifact 有不同的版本，或者是不同於 Gradle 生成的artifact 的名稱。如果要自定義這些你可以這樣做：

示例 52.5. pom定製

build.gradle

uploadArchives {
    repositories {
        mavenDeployer {
            repository(url: "file://localhost/tmp/myRepo/")
            pom.version = '1.0Maven'
            pom.artifactId = 'myMavenName'
        }
    }
}

如果要向 POM 新增其他的內容，可以使用pom.project 生成器。通過這個生成器，Maven POM 參考中列出的任何元素都可以被新增進來。

示例 52.6. pom 的生成器型別自定義

build.gradle

uploadArchives {
    repositories {
        mavenDeployer {
            repository(url: "file://localhost/tmp/myRepo/")
            pom.project {
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                        distribution 'repo'
                    }
                }
            }
        }
    }
}

注：groupId，artifactId，version和packaging應該始終直接在pom物件上設定。

示例 52.7. 修改自動生成的內容

build.gradle

[installer, deployer]*.pom*.whenConfigured {pom ->
    pom.dependencies.find {dep -> dep.groupId == 'group3' && dep.artifactId == 'runtime' }.optional = true
}

如果你有超過一個的artifact 要釋出，那麼要做的事情就會有些不同。請參閱第 52.6.4.1 節，“一個專案多個構件”。

要為 Maven installer（見第 52.6.3 條，“安裝到本地資源庫”) 自定義設定，你可以：

示例 52.8. Maven installer 的自定義

build.gradle

install {
    repositories.mavenInstaller {
        pom.version = '1.0Maven'
        pom.artifactId = 'myName'
    }
}