Gradle 常用的命令汇总

929 阅读2分钟

在 Gradle 中有很多命令,如果熟悉它们,不仅可以提升开发的效率,也可以帮助我们快速定位并解决编译相关的问题。这篇文章就介绍一下常用的 Gradle 的命令。

编译相关命令

./gradlew build 检查依赖并编译打包
./gradlew assembleDebug 编译并打出Debug包
./gradlew installDebug 编译打出Debug包并安装
./gradlew assembleRelease 编译并打出Release包
./gradlew installRelease 编译打出Release包并安装

清除命令

使用如下的清除命令,会清除构建目录(build)下的产物。等同于在 Android studio 中使用 Build -> Clean Project

./gradlew clean

如果想要强制更新最新依赖,清除构建并构建。需要使用如下的命令

./gradlew clean build --refresh-dependencies

任务相关的命令

./gradlew tasks 查看主要Task
./gradlew tasks --all 查看所有Task
./gradlew taskName 执行Task

依赖相关的命令

./gradlew dependencies 查看项目根目录下的依赖
./gradlew app:dependencies 查看app模块下的依赖

日志相关

gradle 的构建信息非常多,有时候我们需要根据日志级别来筛选有用的信息。Gradle 中日志级别如下:

-q,--quiet
仅记录错误。

-w,--warn
将日志级别设置为警告。

-i,--info
将日志级别设置为信息。

-d,--debug
调试模式。

如果想看到对应的日志信息,在后面加上对应的参数就行了。代码示例如下:

./gradlew assembleDebug --info  看编译过程中的日志信息

你还可以使用 -s,--stacktrace 或者 -S,--full-stacktrace 来打印堆栈的日志信息。需要注意的是,调试模式中,包括正常的stacktrace。

./gradlew assembleDebug --stacktrace 对于用户异常(如编译错误),也会打印出堆栈跟踪。
./gradlew assembleDebug --full-stacktrace 打印出所有异常的堆栈跟踪(非常冗长)。

性能相关的命令

./gradlew assembleDebug --profile:编译并输出性能报告,报告在build/reports/profile。
./gradlew assembleDebug --scan 编译并输出更详细的报告

--profile 效果如下:

屏幕截图 2025-01-04 182300.png

--scan 效果如下:

image.png

参考