如何使用 Gradle 7.0 发布到 Maven Repo

Question

我正在寻找有关如何使用 Gradle 7.0 将库发布到公共 Maven 存储库的工作文档。

我已经在 Maven 注册了一个帐户（实际上是 Sonatype），并跳过了验证环节，所以看起来已经准备好了。我尝试过手动发布，但准备自动化。

Maven 文档适用于 Gradle 6 及更低版本。所需的特定模块已从 Gradle 中删除，并且对此有明确的信息。“maven”已被删除，您必须使用“maven-publish”。看来一切都变了，Maven 上的文档对于 Gradle 7 来说已经没用了

据我所知，Gradle 的文档是错误的。它说要包含以下内容才能应用该插件：

plugins {
    id 'maven-publish'
}

足够好，但文档随后说有任务，但这些任务不存在。该文档声称有：

• generatePomFileForPubNamePublication - 没有generatePomFile任务
• publishPubNamePublicationToRepoNameRepository - 也不在那里
• publishPubNamePublicationToMavenLocal - 我有“publishToMavenLocal”，是同一件事吗？
• 发布- 有一个任务，但它什么也不做。它说它“成功”，但什么也没做。
• publishToMavenLocal - 它存在，但是当我运行它时，它什么也不做。据记录，它会在 users/USER/.m2 文件夹中创建文件，但实际上那里没有放置任何内容。

但是，以下是我可以通过运行任务 --all 获得的任务：

Build tasks
-----------
assemble - Assembles the outputs of this project.
build - Assembles and tests this project.
buildDependents - Assembles and tests this project and all projects that depend on it.
buildNeeded - Assembles and tests this project and all projects it depends on.
classes - Assembles main classes.
clean - Deletes the build directory.
jar - Assembles a jar archive containing the main classes.
javadocJar - Assembles a jar archive containing the main javadoc.
sourcesJar - Assembles a jar archive containing the main sources.
testClasses - Assembles test classes.

Documentation tasks
-------------------
javadoc - Generates Javadoc API documentation for the main source code.

Help tasks
----------
buildEnvironment - Displays all buildscript dependencies declared in project ':purpleLib'.
dependencies - Displays all dependencies declared in project ':purpleLib'.
dependencyInsight - Displays the insight into a specific dependency in project ':purpleLib'.
help - Displays a help message.
javaToolchains - Displays the detected java toolchains.
outgoingVariants - Displays the outgoing variants of project ':purpleLib'.
projects - Displays the sub-projects of project ':purpleLib'.
properties - Displays the properties of project ':purpleLib'.
tasks - Displays the tasks runnable from project ':purpleLib'.

Publishing tasks
----------------
publish - Publishes all publications produced by this project.
publishToMavenLocal - Publishes all Maven publications produced by this project to the local Maven cache.

Verification tasks
------------------
check - Runs all checks.
test - Runs the unit tests.

Other tasks
-----------
compileJava - Compiles main Java source.
compileTestJava - Compiles test Java source.
components - Displays the components produced by project ':purpleLib'. [deprecated]
dependentComponents - Displays the dependent components of components in project ':purpleLib'. [deprecated]
model - Displays the configuration model of project ':purpleLib'. [deprecated]
processResources - Processes main resources.
processTestResources - Processes test resources.

我知道需要更多配置。我已经破解了一些东西，并让publishToMavenLocal在.m2文件夹中创建文件，但在任何情况下我都不能真正发布，所以我重新开始，按照书本，但是这本书似乎完全被破坏了。

有谁有发布到 Maven 时可以使用的 Gradle 7 构建文件的工作示例吗？

为了完整起见，我当前的 gradle.build 文件是：

/*
 build for the purple utilities library
 */
 
plugins {
    // the "id" commands below find an existing pluging code, 
    // create an instance of it, and put into the project.
    id 'java-library';
    id 'maven-publish';
}
java {
    withJavadocJar()
    withSourcesJar()
}
project.repositories {
    // Use Maven Central for resolving dependencies.
    mavenCentral();
}; 

project.version '3.0';
project.description = "Purple utilities for web programming";
project.group = 'com.purplehillsbooks.purple';
project.archivesBaseName = 'purple';

project.dependencies({

    // Use JUnit test framework.
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.3.1'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.3.1'
    
    compileOnly 'org.apache.tomcat:tomcat-catalina:8.5.46'
})


project.test {
    useJUnitPlatform()
}

也许我必须降级到 Gradle 6？我一直在尝试让事情能够与 7 一起工作，但是 Gradle 人员提供的文档似乎非常糟糕。搜索非常困难，因为 10 个命中中的 9 个是关于从 Maven 检索，而不是发布，其余的都是随机片段，大多数时候只适用于 Gradle 6。但是如果没有对 Gradle 之前的工作有深入的经验，通常会被不可能说清楚。如果你有一个可行的例子，将会非常有帮助。

不幸的是，这是我第一次尝试自动发布到 Maven，所以我没有旧的工作示例可供使用，也没有 Gradle 过去如何执行此操作的经验。我已经阅读了 Gradle 的所有文档，但其中大部分都没有描述我可以运行什么，所以它毫无用处，而且我发现自己怀疑它是否正确。

Answer 1

最终需要的设置：

publishing {
    publications{

        mavenJava(MavenPublication){

            groupId = 'com.xxxxx.yyyy'
            artifactId = 'purple'
            version = '3.0'
            from components.java

            pom {
                name = 'purple'
                description = 'A set of useful utility classes for web applications.'
                url = 'https://github.com/xxxxx/yyyy'
                inceptionYear = '2017'

                licenses {
                    license {
                        name = 'MIT License'
                        url = 'http://www.opensource.org/licenses/mit-license.php'
                    }
                }
                developers {
                    developer {
                        id = 'xxxxx'
                        name = 'xxxxx'
                        email = 'gradle@xxxx.com'
                    }
                }
                scm {
                    connection='scm:git:git:github.com/agilepro/purple.git'
                    developerConnection='scm:git:https://github.com/agilepro/purple.git'
                    url='https://github.com/agilepro/purple'
                }
            }
        }
    }

    repositories {
        maven {
            name = "OSSRH"
            url = "https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/"
            credentials {
                username = project.ossrhUsername
                password = project.ossrhPassword
            }
        }
    }
}

signing {
    sign publishing.publications.mavenJava
}

需要进行设置publish才能显示某些任务。这mavenJava不是方法调用，而是在任务和签名中使用的对象的标识符。用户名和密码放置在未签入存储库的项目文件中。