原文地址：https://docs.gradle.org/4.1/userguide/publishing_maven.html#sec:the_mavenpublish_plugin
为学习gradle上传中使用maven上传aar jar artifact至maven仓库（私服or mavenCentral）
ps:从一个程序员的角度翻译，应该更能让大家易于接受

目录

• [36.1. The “maven-publish” Plugin] maven-publish插件介绍
• [36.2. Publications]发版物
• [36.3. Repositories]仓库
• [36.4. Performing a publish]执行发布
• [36.5. Publishing to Maven Local]发布到本地Maven仓库
• [36.6. Generating the POM file without publishing]生成POM文件不依赖发版

本章介绍由“maven-publish”插件提供的新的Maven发布支持。 最终，这种新的出版支持将通过上传任务取代发布任务(及　maven_push 将取代 uploadArchives 任务)。

注意：此插件生成的生成的POM文件目前不受支持。 Gradle的未来版本可能会添加此功能。 请使用 Maven plugin 将您的工件发布到Maven Central。

如果您正在使用上传任务查找原始Maven发布支持的文档（上传至mavenCentral），请参阅Chapter 32, Publishing artifacts.。

36.1. The “maven-publish” Plugin（maven_publish插件介绍）

以Maven格式发布的能力由“maven-publish”插件提供。

“publishing”插件在名为 “publishing” 的 PublishingExtension类型的项目上创建了一个extension.此extension提供了一个命名发布的容器和一个命名仓库的容器。

“maven-publish”插件适用于 MavenPublication出版物和 MavenArtifactRepository存储库。

Example 36.1. Applying the ‘maven-publish’ plugin

build.gradle

apply plugin: 'maven-publish'

36.2. Publications(出版物介绍)

如果您不熟悉项目artifacts和配置，则应阅读 Chapter 32, Publishing artifacts这里介绍了基本的概念。 本章还介绍了使用不同于本章所述机制的“publishing artifacts”。 这里描述的发布功能最终将取代该功能。

对于“maven-publish”插件有任何影响，必须将MavenPublication 添加到该组发布中。 此出版物确定实际发布的artifacts以及相关POM文件中包含的详细信息。 可以通过添加组件，自定义工件以及直接修改生成的POM文件来配置发布。

36.2.1. Publishing a Software Component(发布软件组件)

将Gradle项目发布到Maven存储库的最简单的方法是指定要发布的SoftwareComponent。 目前可供出版的组件有：

在以下示例中，工件和运行时依赖关系取自Java插件添加的“java”组件。
Example 36.2. Adding a MavenPublication for a Java component

build.gradle

publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java
        }
    }
}

36.2.2. Publishing custom artifacts（上传自定义artifacts）

也可以显式地配置要包含在发布中的artifacts。 Artifacts通常作为原始文件提供，或作为AbstractArchiveTask (e.g. Jar, Zip)的实例提供。

对于每个自定义artifact，可以指定要用于发布的extension和classifier。 请注意，只有一个已发布的工件可以具有classifier，并且所有其他artifacts必须具有唯一的classifier/extension组合。

配置自定义artifacts如下：
Example 36.3. Adding additional artifact to a MavenPublication

build.gradle

task sourceJar(type: Jar) {
    from sourceSets.main.allJava
}

publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java

            artifact sourceJar {
                classifier "sources"
            }
        }
    }
}

有关如何自定义artifacts的更多信息，请参阅API文档中的MavenPublication 类。

36.2.3. Identity values in the generated POM(POM文件生成及配置)

生成的POM文件的属性将包含从以下项目属性派生的标识值：

• groupId　Project.getGroup()
  
• artifactId　Project.getName()
  
• version　Project.getVersion()
  

覆盖默认标识值很简单：在配置MavenPublication时，只需指定groupId，artifactId或版本属性即可。
Example 36.4. customizing the publication identity

build.gradle

publishing {
    publications {
        maven(MavenPublication) {
            groupId 'org.gradle.sample'
            artifactId 'project1-sample'
            version '1.1'

            from components.java
        }
    }
}

Maven将“groupId”和“artifactId”限制为有限的字符集（[A-Za-z0-9 _ \ – 。] +）），并且Gradle强制执行此限制。 对于’version’（以及artifact’extension’和’classifier’），Gradle将处理任何有效的Unicode字符。

明确禁止的唯一Unicode值是“\”，“/”和任何ISO控制字符。 提供的价值在出版初期得到验证。

注意：某些存储库将无法处理所有支持的字符。 例如，当在Windows上发布到文件系统支持的存储库时，’：’字符不能用作标识符。

36.2.4. Modifying the generated POM(修改生成的POM)

生成的POM文件可能需要在发布之前进行调整。 “maven-publish”插件提供了一个钩子来允许这样的修改。
Example 36.5. Modifying the POM file

build.gradle

publications {
    mavenCustom(MavenPublication) {
        pom.withXml {
            asNode().appendNode('description',
                                'A demonstration of maven POM customization')
        }
    }
}

在这个例子中，我们为生成的POM添加了一个’description’元素。 使用此钩子，您可以修改POM的任何方面。 例如，您可以将依赖关系的版本范围替换为用于生成构建的实际版本。

有关更多信息，请参阅API文档中的MavenPom.withXml(org.gradle.api.Action)。

实际上可以修改所创建的POM的任何方面。 这意味着也可以修改POM，使其不再是有效的Maven POM，因此在使用此功能时必须小心。

发布模块的标识符（groupId，artifactId，version）是一个例外; 这些值不能在POM中使用withXML钩子修改。

36.2.5. Publishing multiple modules(发布多个模块)

有时，您可以从Gradle构建中发布多个模块，而无需创建单独的Gradle子项目。 一个例子是为您的库发布单独的API和实现jar。 使用Gradle这很简单：
Example 36.6. Publishing multiple modules from a single project

build.gradle

task apiJar(type: Jar) {
    baseName "publishing-api"
    from sourceSets.main.output
    exclude '**/impl/**'
}

publishing {
    publications {
        impl(MavenPublication) {
            groupId 'org.gradle.sample.impl'
            artifactId 'project2-impl'
            version '2.3'

            from components.java
        }
        api(MavenPublication) {
            groupId 'org.gradle.sample'
            artifactId 'project2-api'
            version '2'

            artifact apiJar
        }
    }
}

如果一个项目定义了多个出版物，那么Gradle将会将这些发布到定义的存储库中。 每个出版物必须具有如上所述的唯一身份。

36.3. Repositories(仓库)

出版物被发布到仓库。 发布到的存储库由 PublishingExtension.getRepositories()容器定义。
Example 36.7. Declaring repositories to publish to

build.gradle

publishing {
    repositories {
        maven {
            // change to point to your repo, e.g. http://my.org/repo
            url "$buildDir/repo"
        }
    }
}

用于声明存储库以进行发布的DSL是用于声明存储库以从 RepositoryHandler使用依赖关系的DSL。 但是，在Maven发布的上下文中，只能使用 MavenArtifactRepository存储库进行发布。

36.4. Performing a publish(执行发布)

“maven-publish”插件会自动为publisher.publications和publishing.repositories容器中的每个MavenPublication和MavenArtifactRepository组合创建一个PublishToMavenRepository任务。

创建的任务名为“发布”publish«PUBNAME»PublicationTo«REPONAME»Repository“。

Example 36.8. Publishing a project to a Maven repository

build.gradle

apply plugin: 'java'
apply plugin: 'maven-publish'

group = 'org.gradle.sample'
version = '1.0'

publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java
        }
    }
}
publishing {
    repositories {
        maven {
            // change to point to your repo, e.g. http://my.org/repo
            url "$buildDir/repo"
        }
    }
}

Output of gradle publish

> gradle publish
:generatePomFileForMavenJavaPublication
:compileJava
:processResources NO-SOURCE
:classes
:jar
:publishMavenJavaPublicationToMavenRepository
:publish

BUILD SUCCESSFUL in 0s
4 actionable tasks: 4 executed

在此示例中，创建名为“publishMavenJavaPublicationToMavenRepository”的任务，其类型为PublishToMavenRepository。 此任务已连接到发布生命周期任务。 执行“gradle publish”构建POM文件和要发布的所有工件，并将它们传输到存储库。

36.5. Publishing to Maven Local发布到本地maven仓库)

为了与本地Maven安装进行集成，有时将模块发布到本地.m2存储库中是有用的。 在Maven的说法中，这被称为“安装”模块。 “maven-publish”插件通过在publishing.publications容器中为每个 MavenPublication自动创建一个 PublishToMavenLocal任务来实现这一点。 每个这些任务都连接到publishToMavenLocal生命周期任务中。 你的publishing.repositories部分不需要mavenLocal。

创建的任务名为“publish«PUBNAME»PublicationToMavenLocal“。

Example 36.9. Publish a project to the Maven local repository

Output of gradle publishToMavenLocal

> gradle publishToMavenLocal
:generatePomFileForMavenJavaPublication
:compileJava
:processResources NO-SOURCE
:classes
:jar
:publishMavenJavaPublicationToMavenLocal
:publishToMavenLocal

BUILD SUCCESSFUL in 0s
4 actionable tasks: 4 executed

此示例中生成的任务名为“publishMavenJavaPublicationToMavenLocal”。 此任务已连接到publishToMavenLocal生命周期任务中。 执行“gradle publishToMavenLocal”构建POM文件和要发布的所有工件，并将它们“安装”到本地Maven存储库中。

36.6. Generating the POM file without publishing

有时在实际发布时为模块生成Maven POM文件是有用的。 由于POM生成由单独的任务执行，因此很容易实现。

生成POM文件的任务是GenerateMavenPom类型，并且根据发布的名称给出一个名称：“generatePomFileFor«PUBNAME»Publication“。 所以在下面的例子中，出版物名为“mavenCustom”，任务将被命名为“generatePomFileForMavenCustomPublication”。

Example 36.10. Generate a POM file without publishing

build.gradle

model {
    tasks.generatePomFileForMavenCustomPublication {
        destination = file("$buildDir/generated-pom.xml")
    }
}

Output of gradle generatePomFileForMavenCustomPublication

> gradle generatePomFileForMavenCustomPublication
:generatePomFileForMavenCustomPublication

BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed

发布模型的所有细节仍然在POM生成中考虑，包括组件，自定义工件以及通过pom.withXml进行的任何修改。

“maven-publish”插件利用了后期插件配置的一些实验支持，任何GenerateMavenPom任务将不会被构建，直到配置发布扩展。 当您尝试访问GenerateMavenPom任务时，确保发布插件配置的最简单的方法是将访问放置在模型块中，如上所述。
同样适用于任何尝试访问特定于发布的任务，如PublishToMavenRepository.。 这些任务应该在模型块内引用。

内容如有错误仅供参考，后续给出使用实例