Gradle:仅在发布到本地时更改工件名称

在Gradle构建工具中，有时你可能希望在发布到本地仓库时更改生成的工件的名称，以区分不同的构建环境或版本。这可以通过配置Gradle的maven-publish插件来实现。

基础概念

工件（Artifact）：在软件构建过程中生成的任何文件，如JAR、WAR、ZIP等，都可以被视为工件。

发布到本地仓库：指的是将构建好的工件安装到本地的Maven仓库中，这样其他项目可以引用这个本地仓库中的依赖。

类型与应用场景

类型：通常涉及修改JAR、WAR等文件的名称。
应用场景：当需要在本地进行调试或测试，同时又不想干扰到正式版本的工件时。

示例配置

以下是一个Gradle配置示例，展示了如何在发布到本地仓库时更改工件名称：

plugins {
    id 'java'
    id 'maven-publish'
}

group = 'com.example'
version = '1.0.0'

publishing {
    publications {
        maven(MavenPublication) {
            artifactId = 'my-library'
            from components.java

            // 仅在发布到本地时更改工件名称
            if (project.hasProperty('local')) {
                artifactId += '-local'
                version += '-SNAPSHOT'
            }
        }
    }
    repositories {
        maven {
            url = "$buildDir/repo"
            if (project.hasProperty('local')) {
                url = "$buildDir/local-repo"
            }
        }
    }
}

// 在命令行中使用 -Plocal 参数来触发本地发布配置