还在手动复制文件？快试试 Android Gradle 自动化任务：实现文件复制

在 Android 开发中，Gradle 是构建项目的核心工具。你是否遇到过这样的情况：

• 每次编译后都要手动复制某些文件，比如 皮肤包、配置文件 到 assets/ 目录？
• 想让这些操作自动化，减少重复劳动？

本文将带你用 Gradle 任务（Task） 轻松实现文件自动复制，并且 结合 Android Studio 的运行按钮 让它自动执行！

---

1. Gradle 任务是什么？为什么要用它？

Gradle 任务（Task）是 Gradle 构建系统的核心概念，它可以：
✅ 自动化文件操作（复制、移动、删除等）
✅ 结合构建流程，比如在 编译 APK 后执行某些任务
✅ 减少手动操作，提高开发效率

我们可以创建一个 Gradle 任务，让它在 每次运行 App 时自动复制文件，避免手动重复操作！🚀

---

2. 什么是 assembleDebug？点击 Android Studio 运行按钮=执行它！

如果你是 Android 开发新手，可能不知道 assembleDebug 是什么。其实它就是 你在 Android Studio 右上角点击绿色三角形按钮（Run 按钮）时执行的命令！

📌 assembleDebug 作用：

• 编译项目（Java/Kotlin → DEX）
• 打包资源文件（res、assets）
• 生成 Debug 版 APK，存放到 app/build/outputs/apk/debug/
• 安装并运行到模拟器/手机（如果使用 Run 按钮）

也就是说，每次你点击 Run 按钮，Gradle 都会执行 assembleDebug，我们可以在它执行完后，自动运行我们的自定义任务！

---

3. 编写 Gradle 任务，自动复制文件

在 app/build.gradle（Groovy DSL）或 app/build.gradle.kts（Kotlin DSL）中，添加以下代码：

💡 Groovy 版本

task copyFiles {
    def srcDir = file("${rootProject.rootDir}/source_directory") // 源文件目录
    def destDir = file("${rootProject.rootDir}/app/src/main/assets/target_directory") // 目标目录

    doLast {
        if (!destDir.exists()) {
            destDir.mkdirs() // 确保目标目录存在
        }

        copy {
            from fileTree(dir: srcDir, include: "**/*.config") // 复制所有 `.config` 文件
            into destDir
        }
        println("Files copied to: ${destDir}")
    }
}

解释：

• srcDir：定义源文件目录，存放需要复制的文件；
• destDir：目标目录，通常是 assets/ 目录，便于应用访问；
• doLast {}：确保任务在 Gradle 运行时执行；
• copy {}：使用 Gradle 提供的 copy 方法完成文件复制。

---

3.1. 让任务自动执行

如果希望在 assembleDebug 之后自动执行 copyFiles，可以添加如下代码：

tasks.whenTaskAdded { task ->
    if (task.name == "assembleDebug") {
        task.finalizedBy(copyFiles)
    }
}

这样，每次运行 ./gradlew assembleDebug 时，Gradle 都会自动执行 copyFiles 任务。

---

4. Kotlin DSL 版本

如果你的 build.gradle.kts 使用的是 Kotlin DSL，代码如下：

tasks.register<Copy>("copyFiles") {
    val srcDir = file("${rootProject.rootDir}/source_directory")
    val destDir = file("${rootProject.rootDir}/app/src/main/assets/target_directory")

    from(fileTree(srcDir).matching { include("**/*.config") }) // 复制所有 `.config` 文件
    into(destDir)

    doLast {
        println("Files copied to: $destDir")
    }
}

如果要在 assembleDebug 之后自动执行：

tasks.named("assembleDebug").configure {
    finalizedBy("copyFiles")
}

这样在构建 Debug 版本时，Gradle 会自动执行 copyFiles 任务。

---

5. 结论

通过 Gradle 自定义任务，我们可以让构建流程更加智能化，减少手动操作的成本。本文介绍的 文件复制 只是一个简单的示例，你还可以使用 Gradle 任务实现 文件打包、资源优化、自动化构建 等功能，帮助提升开发效率。

如果你在 Android 开发中有类似需求，不妨试试看！🚀