当前位置：首页 > news >正文

Android 项目中如何在执行 assemble 或 Run 前自动执行 clean 操作？

news 2025/7/21 12:00:15

在日常开发中，我们经常需要在执行构建（assemble）或运行（Run）应用前，清理项目（clean），以避免缓存问题或资源冲突。但频繁手动执行 clean 命令比较繁琐。本文将介绍 三种主流方式，帮助你在执行构建/运行操作前自动完成 clean 任务。

🌱 背景知识：什么是 clean？

在 Android 项目中，./gradlew clean 会删除构建目录 build/ 下的所有缓存文件，从而强制 Gradle 进行全量重新构建。这对解决某些构建错误非常有效，但代价是构建时间显著增加。

📌 简要总结：clean 是一种构建前的重置手段，有用但不要滥用。

✅ 方法 1：命令行组合（最推荐）

这是最直接有效的方式，适用于临时清理构建缓存的场景：

# 清理并构建 Debug 包
./gradlew clean assembleDebug# 清理并安装运行 Debug 包
./gradlew clean installDebug

✅ 优点

简洁直接
不需要改动任何配置
不影响增量构建机制（不自动 clean）

❌ 缺点

每次都要手动输入命令
不适合日常调试时频繁使用

🛠️ 方法 2：配置 Android Studio 的 Run 前任务（推荐日常使用）

适合日常在 IDE 中点击 ▶️ 按钮自动执行 clean：

① 打开配置界面：

顶部工具栏 → Run/Debug Configurations…

② 添加 Before Launch Task：

点击 + → 选择 Run Gradle Task

③ 配置 clean：

选择模块（通常是 :app），输入任务名：clean

④ 调整顺序：

确保 clean 位于 Gradle-aware Make 之前：

⑤ 保存配置：

点击 Apply → OK 即可。

✅ 效果演示：

每次点击 ▶️ Run 时，执行顺序如下：

clean → Gradle 构建 → 安装应用 → 启动应用

🧱 方法 3：创建自定义 Gradle 任务（适用于脚本/CI）

如果你经常在脚本或 CI 中需要 clean + 构建的流程，可以定义组合任务：

📦 示例代码（放在模块级 `build.gradle`）：

// 自定义 clean + assembleDebug
task cleanAndBuild(type: GradleBuild) {group = 'build'description = 'Clean and then build'tasks = ['clean', 'assembleDebug']
}// 自定义 clean + 安装运行
task cleanRun(type: GradleBuild) {group = 'application'description = 'Clean and run app'tasks = ['clean', 'installDebug']
}

▶️ 使用方法：

# 构建
./gradlew cleanAndBuild# 构建 + 安装运行
./gradlew cleanRun

⚠️ 注意事项

项目	说明
🚫 慎用 `clean`	每次 clean 都会触发全量构建，编译耗时大幅增加
✅ 增量构建优势	Gradle 默认支持增量编译，频繁 clean 会浪费缓存带来的加速效果
🔍 何时需要 clean？	资源冲突、生成代码异常、缓存污染、无法重现 bug 时使用

✅ 总结建议

使用场景	推荐方式
临时排查构建问题	✅ 命令行组合（方法1）
Android Studio 日常调试	✅ Before Launch（方法2）
自动化脚本 / CI	✅ 自定义 Gradle 任务（方法3）

🔄 可视化对比图（选择方式一览）

方法	是否自动执行	是否适合 CI	是否适合本地调试	配置复杂度	增量构建保留
方法 1	❌ 否	✅ 是	✅ 是	⭐⭐⭐（低）	✅ 保留
方法 2	✅ 是	❌ 否	✅ 是	⭐⭐☆（中）	❌ 丢失
方法 3	✅ 是	✅ 是	✅ 是	⭐⭐☆（中）	❌ 丢失