Gradle 常用命令

以下是 Gradle 构建工具常用的命令行操作指南,涵盖基础帮助、构建任务、依赖分析及日志控制等内容。

基础帮助与版本

  • 查看帮助信息

    gradle --help
  • 查看 Gradle 版本

    gradle -v
  • 查看所有任务及依赖关系

    gradle tasks --all
    注意:原文中 gradlle 为笔误,已修正为 gradle

构建与任务控制

  • 执行特定任务

    gradle [taskName]
  • 执行构建任务

    gradle build
  • 跳过测试进行构建

    gradle build -x test
  • 忽略失败任务继续执行

    gradle build --continue
  • 试运行构建(Dry Run)

    gradle -m build
    说明:-m 等同于 --dry-run,仅显示任务执行计划而不实际执行。
  • 生成构建性能报告

    gradle build --profile

    结果存储在 build/reports/profile 目录,文件名包含构建运行的时间戳。

    说明:原文路径 build/report/profile 已修正为标准路径 build/reports/profile
  • 清空构建产物

    gradle clean

    即清空 build 目录下所有编译、打包生成的文件。

依赖与项目配置

  • 查看特定配置的依赖关系

    gradle -q dependencies --configuration testCompile
    说明:-q 表示静默模式,仅输出必要信息。
  • 使用指定的构建文件调用任务

    gradle -b [file_path] [task]
  • 在指定目录执行任务

    gradle -q -p [dir] helloWorld
    说明:-p 用于指定项目根目录。

日志与调试

Gradle 的日志输出共分为 6 个级别:ERROR(错误)、QUIET(静默)、WARNING(警告)、LIFECYCLE(生命周期)、INFO(一般信息)、DEBUG(调试)。在执行任务时,可适时调整信息输出等级以便查看执行结果。

  • -q / --quiet
    启用静默级别。该级别下只会输出命令行显式打印的信息及错误信息。

    说明:原文 --quit 为笔误,已修正为 --quiet
  • -i / --info
    输出除 DEBUG 以外的所有信息(包含 INFO 级别)。
  • -d / --debug
    输出所有日志信息(包含 DEBUG 级别)。

    说明:原文 --dubug 为笔误,已修正为 --debug
  • -s / --stacktrace
    输出详细的错误堆栈信息。

其他功能

  • 启动 Gradle 图形界面

    gradle --gui

说明

  1. 版本兼容性gradle --gui 命令在 Gradle 4.0 及更高版本中已被移除,不再支持图形界面启动。
  2. 配置名称变更:命令中涉及的 testCompile 配置名称在 Gradle 3.4+ 版本中已废弃,建议在新版本中使用 testImplementation 等替代配置。
  3. 日志级别拼写:原文中 WARNGINGLIFECYLE 已分别修正为 WARNINGLIFECYCLE