gradle

Gradle 构建工具

补充说明

gradle 用 Groovy/Kotlin DSL 描述构建，支持增量构建、缓存和多项目。项目应优先用 ./gradlew，确保所有人使用同一 Gradle 版本。

常用示例

gradle -v
./gradlew build
./gradlew test
./gradlew :app:build
./gradlew tasks
./gradlew dependencies
./gradlew --offline build
./gradlew --refresh-dependencies build
./gradlew --stacktrace build
./gradlew clean build --no-daemon
./gradlew wrapper --gradle-version 8.10

易错点与排错

• 系统 gradle 和 ./gradlew 可能不是同一版本；CI 和文档统一用 wrapper。
• Gradle daemon 会占内存；容器/CI 里常用 --no-daemon，但要接受更慢的启动。
• 配置缓存（configuration cache）对插件兼容性要求高；报错时先确认是否由它引起。
• 依赖版本冲突不会自动报错；用 dependencies 和 dependencyInsight 看实际解析结果。
• --refresh-dependencies 会绕过缓存，可能很慢；只在确实需要时用。
• Java toolchain 和运行 Gradle 的 JDK 是两件事；编译目标要显式配置。
• 构建缓存命中会跳过任务；输出缺失时先确认缓存键和输入声明。
• 多项目构建要确认任务路径（:app:build），否则可能在根项目空跑。

相关命令

• mvn — Maven 构建
• java — 运行时