Gradle Maven Push 项目教程

Gradle Maven Push 项目教程

1. 项目的目录结构及介绍

gradle-mvn-push/
├── gradle/
│   └── maven_push.gradle
├── gradlew
├── gradlew.bat
├── settings.gradle
└── README.md

• gradle/ 目录：包含项目的 Gradle 脚本文件，其中 maven_push.gradle 是用于发布到 Maven 仓库的主要配置文件。
• gradlew 和 gradlew.bat：分别是 Unix 和 Windows 系统下的 Gradle 包装器脚本，用于执行 Gradle 任务。
• settings.gradle：Gradle 项目的设置文件，定义了项目的名称和包含的模块。
• README.md：项目的说明文档，通常包含项目的基本信息和使用指南。

2. 项目的启动文件介绍

项目的启动文件主要是 gradlew 和 gradlew.bat。这两个文件是 Gradle 包装器脚本，允许你在没有安装 Gradle 的情况下运行 Gradle 任务。

• gradlew：适用于 Unix 系统（如 Linux 和 macOS）。
• gradlew.bat：适用于 Windows 系统。

使用方法：

./gradlew build

或

gradlew.bat build

3. 项目的配置文件介绍

项目的配置文件主要是 gradle/maven_push.gradle。这个文件包含了发布到 Maven 仓库的详细配置。

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
}

signing {
    required { gradle.taskGraph.hasTask("uploadArchives") }
    sign configurations.archives
}

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 'Gradle Maven Push'
                packaging 'jar'
                description 'A Gradle script to push artifacts to Maven.'
                url 'https://github.com/chrisbanes/gradle-mvn-push'

                scm {
                    connection 'scm:git:git://github.com/chrisbanes/gradle-mvn-push.git'
                    developerConnection 'scm:git:ssh://github.com/chrisbanes/gradle-mvn-push.git'
                    url 'https://github.com/chrisbanes/gradle-mvn-push'
                }

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

                developers {
                    developer {
                        id 'chrisbanes'
                        name 'Chris Banes'
                        email 'chris@android.com'
                    }
                }
            }
        }
    }
}

• apply plugin: 'maven' 和 apply plugin: 'signing'：应用 Maven 和签名插件。
• javadocJar 和 sourcesJar：生成 Javadoc 和源码 JAR 文件的任务。
• artifacts：定义要发布的构件。
• signing：配置签名信息。
• uploadArchives：配置发布到 Maven 仓库的详细信息，包括仓库 URL、认证信息和 POM 文件的详细配置。

通过以上配置，你可以将项目发布到 Maven 仓库。