Android Gradle命令行有哪些常用参数和技巧？

Android Gradle命令行是Android开发中不可或缺的工具，它通过Gradle构建系统实现了自动化编译、打包、测试等任务的高效执行，开发者可以通过命令行直接与Gradle交互，灵活控制构建流程，适用于CI/CD集成、批量处理或IDE界面无法满足的复杂场景，以下从基础命令、高级配置、常见场景及问题解决等方面展开详细说明。

基础命令行操作

Android Gradle命令行的核心在于gradlew脚本（Windows环境下为gradlew.bat），它封装了Gradle的执行逻辑，并自动处理依赖下载、环境配置等前置工作，基础命令格式为./gradlew [任务名]，

• 构建项目：./gradlew build会执行编译、测试、打包等所有任务，生成APK/AAB文件位于app/build/outputs目录。
• 清理构建缓存：./gradlew clean删除build目录,解决因缓存导致的编译异常。
• 安装应用到设备：./gradlew installDebug将Debug版本的APK安装到已连接的Android设备或模拟器。
• 生成构建报告：./gradlew assembleRelease --profile会生成包含构建耗时、内存使用的报告，文件位于build/reports/profile。

通过-p参数可指定项目路径，如./gradlew -p /path/to/project build,适用于多模块项目中的子模块操作。

任务管理与依赖控制

Gradle采用任务（Task）作为最小执行单元，可通过./gradlew tasks查看所有可用任务,其中分类包括：

• 构建类型：如assembleDebug、assembleRelease,分别对应不同构建配置。
• 变体（Variant）：Android插件会根据产品风味（flavor）和构建类型自动生成任务，如demoDebug assemble。
• 自定义任务：在build.gradle中通过task myTask { ... }定义,可通过命令行直接调用。

依赖控制方面，可通过./gradlew dependencies查看依赖树，分析冲突或冗余依赖。./gradlew app:dependencies --configuration implementation仅显示implementation作用域的依赖，若需强制更新依赖，可使用./gradlew --refresh-dependencies build,重新下载所有远程依赖。

高级配置与参数优化

命令行支持丰富的参数组合,以实现精细化构建控制：

• 并行构建：通过./gradlew --parallel build启用多任务并行执行，需在gradle.properties中配置org.gradle.parallel=true。
• 内存优化：对于大型项目，可调整JVM内存参数，如./gradlew -Dorg.gradle.jvmargs="-Xmx4g -XX:MaxPermSize=512m" build。
• 构建变体选择：通过-P参数动态配置属性，如./gradlew assemble -Pflavor=demo，需配合build.gradle中的productFlavors定义。
• 跳过测试：./gradlew assembleDebug -x test可跳过测试任务,加速调试流程。

以下为常用参数速查表：
| 参数 | 作用 | 示例 |
|——|——|——|
| --continue | 任务失败时继续执行后续任务 | ./gradlew --continue build |
| --info | 显示详细构建日志 | ./gradlew --info assemble |
| --stacktrace | 输出错误堆栈信息 | ./gradlew --stacktrace build |
| -P | 传递项目属性 | ./gradlew -Pversion=1.0 assemble |

常见场景实践

1. CI/CD集成：在Jenkins、GitLab CI等工具中，可通过脚本执行./gradlew clean assembleRelease生成发布包，并结合-P参数实现动态版本控制。
2. 多模块项目构建：在包含多个模块的Android项目中，使用./gradlew :module:task格式指定模块任务，如./gradlew :app:test仅执行app模块的测试。
3. 签名配置：通过命令行传递签名信息，避免硬编码在脚本中，

   ./gradlew assembleRelease -Pandroid.injected.signing.store.file=/path/to/keystore.jks \
   -Pandroid.injected.signing.store.password=xxx \
   -Pandroid.injected.signing.key.alias=alias \
   -Pandroid.injected.signing.key.password=xxx

问题排查与调试

构建失败时,可通过以下命令定位问题：

• 日志分析：./gradlew build --info --debug输出最详细的日志，包含依赖解析、编译过程。
• 任务耗时分析：使用./gradlew build --profile生成的报告，可视化各任务耗时,优化构建瓶颈。
• 依赖冲突解决：通过./gradlew app:dependencies --configuration compileClasspath | grep "conflict"定位冲突依赖，并使用exclude规则排除。

相关问答FAQs

Q1: 如何在命令行中查看某个特定任务的执行详情？
A: 可通过./gradlew app:tasks --all查看所有任务及其描述，找到目标任务后，使用./gradlew app:taskName --info执行并查看详细信息，查看mergeDebugResources任务的执行过程，可运行./gradlew app:mergeDebugResources --info,日志会显示资源合并的文件列表和耗时。

Q2: 为什么执行./gradlew build时提示“Could not find or load main class org.gradle.launcher.daemon.bootstrap.GradleDaemon”？
A: 该错误通常由Gradle Daemon进程异常导致，解决方案有两种：一是强制停止所有Daemon进程，执行./gradlew --stop后重新构建；二是检查JAVA_HOME环境变量是否正确指向JDK安装目录，Android项目需要JDK而非JRE，可通过echo $JAVA_HOME（Linux/macOS）或echo %JAVA_HOME%（Windows）验证路径配置。