Gradle任务克隆依赖库后首次构建失败，二次构建成功如何解决？

这个问题我之前也碰到过——核心原因就是Gradle的配置阶段会提前扫描并解析所有项目依赖，而你写的exec克隆任务是在执行阶段才运行的。首次构建时，依赖库还没被克隆出来，Gradle找不到它们，自然就抛出依赖解析错误；二次构建时依赖已经存在，所以能正常运行。

下面给你几个靠谱的解决方案，按推荐程度排序：

方案1：在settings.gradle中提前克隆依赖库（最推荐） #

settings.gradle是Gradle执行流程中最早运行的脚本，它会在所有项目模块配置之前执行。在这里处理依赖库的克隆，能确保Gradle解析app模块依赖时，本地已经存在对应的库文件。

示例代码如下：

// settings.gradle
// 封装一个克隆工具方法，避免重复代码
def cloneRepoIfMissing(String repoUrl, String targetFolder) {
    def targetDir = file(targetFolder)
    if (!targetDir.exists()) {
        println "开始克隆依赖库：$repoUrl -> $targetFolder"
        exec {
            commandLine "git", "clone", repoUrl, targetFolder
            // 如果需要克隆特定分支，可以加参数：commandLine "git", "clone", "-b", "main", repoUrl, targetFolder
        }
    } else {
        println "依赖库 $targetFolder 已存在，跳过克隆"
    }
}

// 克隆你的两个依赖库（替换成实际的仓库地址和文件夹名）
cloneRepoIfMissing("https://github.com/your-team/dependency-lib1.git", "dependency-lib1")
cloneRepoIfMissing("https://github.com/your-team/dependency-lib2.git", "dependency-lib2")

// 最后别忘了include这些本地模块，让Gradle识别它们
include ':app', ':dependency-lib1', ':dependency-lib2'

这样配置后，每次构建前都会先检查依赖库是否存在，不存在就自动克隆，完全避免了首次构建的依赖缺失问题。

方案2：将克隆逻辑移至Gradle配置阶段（不推荐，影响构建速度） #

如果你不想修改settings.gradle，也可以把克隆逻辑直接放到app模块的build.gradle的配置阶段（也就是任务外面的代码块），这样克隆会在依赖解析前执行。

但要注意：配置阶段的代码每次构建都会运行，哪怕依赖库已经存在，会稍微拖慢构建速度，所以只适合临时场景。

示例代码：

// app/build.gradle
// 在配置阶段执行克隆（任务外部的代码）
def cloneDependencies() {
    def repos = [
        ["https://github.com/your-team/dependency-lib1.git", "../dependency-lib1"],
        ["https://github.com/your-team/dependency-lib2.git", "../dependency-lib2"]
    ]
    repos.each { repoInfo ->
        def repoUrl = repoInfo[0]
        def targetPath = repoInfo[1]
        def targetDir = file(targetPath)
        if (!targetDir.exists()) {
            exec {
                commandLine "git", "clone", repoUrl, targetPath
            }
        }
    }
}

// 调用克隆方法
cloneDependencies()

// 后续的依赖配置
dependencies {
    implementation project(':dependency-lib1')
    implementation project(':dependency-lib2')
    // 其他依赖...
}

方案3：让构建任务依赖克隆任务（仅适用于非本地模块依赖） #

如果你的依赖不是本地模块（比如克隆后发布到本地Maven仓库再引入），可以让构建前置任务依赖克隆任务，确保克隆完成后再开始解析依赖。

示例代码：

// app/build.gradle
task cloneDeps {
    doLast {
        // 克隆逻辑和之前一样
        exec { commandLine "git", "clone", "your-repo-url", "target-folder" }
    }
}

// 让preBuild任务（所有Android构建的前置任务）依赖克隆任务
preBuild.dependsOn(cloneDeps)

// 假设克隆后将库发布到本地Maven，然后引入
dependencies {
    implementation 'com.your.lib:dep1:1.0.0'
}

但如果是本地模块依赖（implementation project(':xxx')），这个方案可能还是会失败——因为Gradle在配置阶段就会检查:xxx模块是否存在，而克隆任务是在执行阶段才运行的，配置阶段时模块还不存在，依然会报错。所以这种方法只适合非本地模块的场景。

内容的提问来源于stack exchange，提问作者Golan Shay