用途:自动化 Android 项目的 Gradle 任务,包括构建、测试、覆盖率与清理。
主要能力与命令:构建方面可执行 ./gradlew assembleDebug(debug APK)、./gradlew assembleRelease(release APK)、./gradlew installDebug(安装到设备)、./gradlew clean(清理缓存)、./gradlew clean assembleDebug(重新构建)。测试方面可执行 ./gradlew testDebugUnitTest(全部单元测试)、./gradlew test --tests ".ClassName"(单类)、./gradlew test --tests ".Class.method"(单方法)。覆盖率方面可执行 ./gradlew jacocoTestDebugUnitTestReport(报告位于 app/build/reports/jacoco/jacocoTestDebugUnitTestReport/html/index.html),以及 ./gradlew jacocoVerification 强制最低 80%。依赖方面可执行 ./gradlew dependencies、./gradlew :app:dependencies、./gradlew dependencyUpdates。
使用方式:结合命令工作流,如完整 CI 流程 ./gradlew clean testDebugUnitTest jacocoTestDebugUnitTestReport assembleDebug;快速迭代 ./gradlew assembleDebug -x lint -x test && ./gradlew installDebug;提交前检查 ./gradlew ktlintCheck testDebugUnitTest。脚本中可通过退出码与输出关键字判断失败原因。
适用场景:APK 构建、单元测试执行、覆盖率报告生成与阈值校验、构建缓存清理、依赖检查,以及 CI/CD(如 GitHub Actions)集成。
限制与排错:始终使用 Gradle wrapper(./gradlew),不要使用系统 Gradle;构建挂起可执行 ./gradlew --stop;缓存问题可执行 ./gradlew clean cleanBuildCache;内存不足在 gradle.properties 增加 org.gradle.jvmargs=-Xmx4g;版本冲突需在 build.gradle.kts 强制解析;构建慢可启用 org.gradle.parallel=true。资料中的版本兼容表与超时配置等更多细节暂未在此展开。