Gradle 与 Maven 命令等效对照

1. 引言：为什么需要了解Maven与Gradle的命令等效关系

Apache Maven和Gradle都是Java生态系统中广泛使用的构建自动化工具。许多项目可能从Maven开始，但随着项目复杂性的增长，团队可能会寻求Gradle提供的更高级的灵活性和性能优势。当你从Maven迁移到Gradle时，了解两个工具之间命令的等效关系至关重要，这可以显著减少学习曲线和迁移成本。

Gradle相比于Maven的主要优势包括：

  • 更灵活的构建模型：Gradle使用基于任务依赖关系图的可扩展构建模型，而Maven使用固定的线性阶段模型
  • 更好的性能：Gradle 3.0+引入了构建缓存、编译避免和改进的增量Java编译器，使得构建速度通常比Maven快2-10倍
  • 更强大的依赖管理：Gradle提供更精细的依赖控制机制，如依赖约束和版本锁定
  • 更丰富的脚本能力：使用Groovy或Kotlin DSL，可以编写更复杂和灵活的构建逻辑

本文将全面介绍Maven常用命令在Gradle中的等效命令，帮助你顺利完成从Maven到Gradle的迁移。

2. 基本命令等效关系

2.1 清理项目：clean命令

在Maven中，mvn clean命令用于清理项目，删除target目录等构建生成的文件。

在Gradle中，等效命令是：

gradle clean

Gradle的clean任务是Base插件的一部分（所有JVM语言插件如Java Plugin都会自动应用Base插件），它会删除build目录（Gradle的默认输出目录），实现与Maven相同的清理效果。

2.2 构建项目：compile和package命令

Maven使用mvn compile编译源代码，mvn package打包项目。

在Gradle中，等效命令是：

# 编译项目
gradle classes

# 构建和打包项目（但不运行测试）
gradle assemble

# 完整构建项目（包括运行测试）
gradle build

Gradle的Java插件提供了多个任务来处理不同的构建阶段：

  • compileJava：编译Java源代码
  • processResources：处理资源文件
  • classes：组合编译和处理资源（相当于Maven的compile阶段）
  • jar：创建JAR包
  • assemble：构建所有输出（相当于Maven的package阶段但不运行测试）
  • build：完整构建（包括验证和测试）

2.3 安装到本地仓库：install命令

Maven的mvn install命令将构建产物安装到本地Maven仓库（通常是~/.m2/repository）。

在Gradle中，有几种方式可以实现类似功能：

  1. 使用Maven插件（旧版，Gradle 7.0+已移除）：
# 在build.gradle中添加maven插件
apply plugin: 'maven'

# 然后运行
gradle install
  1. 使用Maven Publish插件（推荐方式）：
# 在build.gradle中添加插件
plugins {
    id 'maven-publish'
}

# 然后运行
gradle publishToMavenLocal

需要注意的是，Gradle构建并不强制要求"安装"构件，因为它提供了更合适的特性如项目间依赖和复合构建。只有在需要与Maven构建互操作时，才应使用publishToMavenLocal。

2.4 更新依赖：update命令

Maven的mvn update命令用于强制更新依赖。

在Gradle中，等效命令是：

gradle build --refresh-dependencies

这个命令会强制Gradle重新下载所有依赖项，忽略缓存。Gradle通常会自动获取所有所需的依赖，并在后续构建中重用缓存的结果，除非使用--refresh-dependencies标志。

3. 依赖管理比较

3.1 依赖声明对比

Maven使用XML格式声明依赖：

<dependencies>
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.12</version>
    </dependency>
</dependencies>

Gradle使用更简洁的DSL声明依赖：

dependencies {
    implementation 'log4j:log4j:1.2.12'
}

3.2 依赖范围/配置映射

Maven和Gradle使用不同的术语处理依赖范围：

Maven范围Gradle配置说明
compileimplementation编译时依赖，但不传递给消费者
compileapi编译时依赖，且传递给消费者
runtimeruntimeOnly仅运行时依赖
testtestImplementation测试编译时依赖
testtestRuntimeOnly测试运行时依赖
providedcompileOnly编译时需要但运行时不需要

Gradle区分构建模块所需的依赖和构建依赖于该模块的模块所需的依赖，这种区分有助于更精细地控制依赖传递。

3.3 强制更新依赖

除了使用--refresh-dependencies标志外，Gradle还提供了其他方式来管理依赖更新：

  1. 使用动态版本：
dependencies {
    implementation 'org.springframework:spring-core:5.+'
}
  1. 使用依赖锁定（Gradle 4.8+）：
# 生成锁定文件
gradle dependencies --write-locks

# 使用锁定版本进行构建
gradle build --write-locks
  1. 使用Use Latest Versions插件：
# 检查哪些依赖有更新
gradle useLatestVersionsCheck

# 更新依赖到最新版本
gradle useLatestVersions

4. 高级构建功能等效

4.1 跳过测试

在Maven中，可以使用-DskipTests跳过测试：

mvn install -DskipTests

在Gradle中，等效命令是：

gradle build -x test

4.2 多模块项目构建

Maven使用父子POM结构处理多模块项目，而Gradle使用多项目构建：

Maven多模块构建：

mvn clean install -pl module1,module2 -am

Gradle等效命令：

gradle clean build :module1:build :module2:build --parallel

Gradle的多项目构建支持更灵活的任务执行和并行构建，可以提高构建性能。

4.3 构建生命周期对比

Maven基于固定的线性生命周期阶段（clean、compile、test、package、install等），而Gradle基于任务依赖关系图：

Maven阶段Gradle任务说明
cleanclean清理构建输出
compileclasses编译源代码
testtest运行单元测试
packageassemble打包构件
verifycheck运行所有验证任务
installpublishToMavenLocal安装到本地仓库
deploypublish发布到远程仓库

Gradle的生命周期任务（如assemble、check）是聚合任务，它们依赖于其他实际执行工作的任务，这种设计提供了更大的灵活性。

5. 发布构件到仓库

5.1 发布到本地仓库

如前所述，使用Maven Publish插件发布到本地仓库：

gradle publishToMavenLocal

5.2 发布到远程仓库

Maven中使用mvn deploy发布到远程仓库，Gradle中的等效命令是：

gradle publish

需要在build.gradle中配置发布信息和仓库：

plugins {
    id 'maven-publish'
    id 'signing' // 如果需要签名
}

publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java
            groupId = 'com.example'
            artifactId = 'my-library'
            version = '1.0.0'
            
            pom {
                name = 'My Library'
                description = 'A description of my library'
                url = 'https://github.com/example/my-library'
                
                licenses {
                    license {
                        name = 'Apache-2.0'
                        url = 'https://opensource.org/licenses/Apache-2.0'
                    }
                }
                
                developers {
                    developer {
                        id = 'developer1'
                        name = 'Developer Name'
                        email = 'developer@example.com'
                    }
                }
                
                scm {
                    connection = 'scm:git:git://github.com/example/my-library.git'
                    developerConnection = 'scm:git:ssh://github.com:example/my-library.git'
                    url = 'https://github.com/example/my-library'
                }
            }
        }
    }
    
    repositories {
        maven {
            name = 'OSSRH'
            url = 'https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/'
            credentials {
                username = project.findProperty('ossrhUsername')
                password = project.findProperty('ossrhPassword')
            }
        }
    }
}

signing {
    sign publishing.publications.mavenJava
}

5.3 处理SNAPSHOT版本

Maven支持SNAPSHOT版本，Gradle也完全支持：

version = '1.0.0-SNAPSHOT'

publishing {
    repositories {
        maven {
            url = 'https://maven.pkg.jetbrains.space/mycompany/p/projectkey/my-maven-repo'
            credentials {
                username = project.findProperty('usr')
                password = project.findProperty('pwd')
            }
        }
    }
}

需要注意的是，发布具有相同包版本的构件通常是不允许的，但带有SNAPSHOT前缀的构件可以发布到支持快照的仓库。

6. 迁移策略和最佳实践

6.1 自动迁移工具

Gradle提供了init任务，可以自动将现有的Maven构建转换为Gradle：

# 在项目根目录运行
gradle init

这个命令会解析现有的POM文件并生成相应的Gradle构建脚本。对于多项目构建，Gradle还会创建设置脚本。

6.2 并行维护策略

在迁移过程中，建议并行维护Maven和Gradle构建：

  1. 保持旧的Maven构建和新的Gradle构建并存
  2. 开发验证机制确保两个构建产生相同的产物
  3. 逐步迁移，先验证关键输出如最终报告和发布的构件

6.3 插件迁移策略

迁移Maven插件时可以考虑以下选项：

  1. 使用Gradle等效插件：许多流行的Maven插件在Gradle中有等效插件
  2. 使用内置Gradle功能替换：有时可以用内置Gradle功能替代Maven插件
  3. 重新实现自定义插件：作为最后手段，可能需要通过自定义插件和任务类型重新实现Maven插件功能

6.4 依赖迁移策略

Gradle的依赖管理系统比Maven更灵活，但支持相同的仓库、声明依赖、范围（Gradle中的依赖配置）和传递依赖概念：

  1. 声明仓库：Gradle没有默认仓库，必须至少声明一个仓库
  2. 迁移依赖范围：将Maven依赖范围映射到Gradle配置
  3. 处理版本冲突：Maven使用"最接近"匹配算法，而Gradle选择最新版本，但可以通过依赖约束控制版本选择

7. 常见问题与解决方案

7.1 依赖版本冲突

Gradle默认选择最新版本的依赖，这可能导致与Maven构建不同的行为。可以通过依赖约束解决：

dependencies {
    implementation 'org.apache.httpcomponents:httpclient' // 未指定版本
    constraints {
        implementation('org.apache.httpcomponents:httpclient:4.5.3') {
            because('previous versions have a bug impacting this application')
        }
    }
}

7.2 构建性能优化

Gradle提供了多种构建性能优化方式：

  1. 使用构建缓存：缓存任务输出以便在后续构建中重用
  2. 使用并行执行：使用--parallel标志并行执行任务
  3. 使用增量编译：只重新编译更改的源文件
  4. 使用配置缓存：缓存任务图的计算结果（Gradle 6.6+）

7.3 离线构建支持

Gradle支持离线构建，确保成功编译不依赖于互联网连接：

# 启用离线模式
gradle build --offline

为了确保可靠的离线构建，可以考虑将依赖项存储在版本控制系统中或使用依赖锁定。

8. Gradle替代工具介绍

虽然Gradle是强大的构建工具，但也有其他替代方案：

  1. Apache Maven：传统的选择，具有简单易用的界面和便捷的功能
  2. Bazel：开源工具，擅长有效开发和测试软件，支持多语言
  3. Jenkins：提供完整的工作流自动化，消除手动管理
  4. CMake：值得信赖的开源平台，支持多种语言包括C++、Python等

选择合适的构建工具取决于项目需求、团队熟悉度和生态系统因素。

总结

本文全面介绍了Maven常用命令在Gradle中的等效命令，涵盖了从基本构建操作到高级发布功能的各个方面。通过理解这些等效关系，开发者可以更顺利地从Maven迁移到Gradle，利用Gradle提供的更高级的灵活性、性能和依赖管理功能。

核心命令总结

Maven命令Gradle等效命令说明
mvn cleangradle clean清理构建输出
mvn compilegradle classes编译源代码
mvn testgradle test运行单元测试
mvn packagegradle assemble打包构件（不运行测试）
mvn verifygradle check运行所有验证任务
mvn installgradle publishToMavenLocal安装到本地仓库
mvn deploygradle publish发布到远程仓库
mvn -DskipTestsgradle -x test跳过测试
mvn updategradle build --refresh-dependencies强制更新依赖

迁移到Gradle不仅仅是命令的简单替换，还需要理解Gradle的构建和高级特性。建议采用渐进式迁移策略，并行维护Maven和Gradle构建，确保迁移过程平稳可靠。通过充分利用Gradle的灵活性和性能优势，可以显著提高大型复杂项目的构建效率和可维护性。

最后更新: