用途:通过 Gradle 命令行(gradlew)编译 Android 工程,适用于本地构建、脚本和 CI/CD。
前置条件:已安装 JDK(Android 开发通常需 JDK 11 或 17,与项目 compileSdk/AGP 匹配);工程根目录存在 gradlew(或可生成 Gradle Wrapper);已配置 ANDROID_HOME,或在 local.properties 中设置 sdk.dir。
基本用法:进入含 build.gradle 或 build.gradle.kts 的工程根目录,执行 ./gradlew assembleDebug 打调试包,./gradlew assembleRelease 打发布包(需配置 signing),./gradlew build 做含测试的全量构建。Windows 使用 gradlew.bat,例如 gradlew.bat assembleDebug。
常用任务:assembleDebug 打 Debug APK;assembleRelease 打 Release APK;build 编译并跑测试,产出 Debug/Release;clean 清理 build 输出;installDebug 安装 Debug 到已连接设备或模拟器;bundleRelease 打 AAB(Google Play 上架用)。可执行 ./gradlew clean assembleDebug 或 ./gradlew clean build 清理后构建;用 ./gradlew tasks 查看所有任务,./gradlew tasks --group=build 仅看应用相关任务。
常见问题:找不到 gradlew 时,在工程根目录执行 gradle wrapper 生成(需本机已装 Gradle),或从其他 Android 项目复制 gradlew、gradlew.bat、gradle/wrapper/;sdk.dir 未配置时,创建 local.properties 并写入 sdk.dir=/path/to/Android/sdk,或设环境变量 ANDROID_HOME;JDK 版本不匹配时用 ./gradlew -version 查看所用 JVM,需与项目或 AGP 要求一致(如 JDK 17);依赖下载失败时检查网络与仓库配置(repositories 含 google()、mavenCentral() 等);CI 无交互时可加 -no-daemon、--no-build-cache 等,避免守护进程与缓存导致环境差异。签名配置、AAB、多渠道与 CI 建议见 reference.md。其他细节暂未提供。