Android Studio模块化项目Gradle构建报错：Missing ExternalProject for :

错误原因 #

你新建的模块文件夹没有被Gradle识别为子项目——Gradle不会自动扫描目录添加子项目，必须在根目录的settings.gradle.kts中显式声明，这就是报错的核心原因。

修复步骤 #

1. 在settings.gradle.kts中注册子项目 #

假设你新建的文件夹名为build-logic（这是Gradle集中管理依赖的常规命名），打开根目录的settings.gradle.kts，添加以下代码：

include(":build-logic")

如果你的文件夹名字不是这个，替换成你实际的文件夹名称即可。

2. 完善build-logic模块的build.gradle.kts配置 #

你的现有配置缺少必要的仓库和插件依赖，修改为如下内容（版本号按需调整）：

plugins {
    `kotlin-dsl`
}

repositories {
    google()
    mavenCentral()
    gradlePluginPortal() // 必须添加，用于获取Gradle插件依赖
}

dependencies {
    // Android Gradle插件，版本和你项目中使用的保持一致
    implementation("com.android.tools.build:gradle:7.4.2")
    // Kotlin Gradle插件
    implementation("org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.20")
}

// 配置JVM工具链，适配Android Studio要求的版本
kotlin {
    jvmToolchain(11)
}

3. 创建集中依赖声明文件 #

在build-logic/src/main/kotlin目录下（如果目录不存在手动创建），新建一个Dependencies.kt文件，用来统一管理版本号和依赖：

// 统一管理版本号
object Versions {
    const val kotlin = "1.8.20"
    const val coreKtx = "1.9.0"
    const val appcompat = "1.6.1"
}

// 统一管理依赖坐标
object Dependencies {
    val coreKtx = "androidx.core:core-ktx:${Versions.coreKtx}"
    val appcompat = "androidx.appcompat:appcompat:${Versions.appcompat}"
    // 可以继续添加其他依赖，比如material、retrofit等
}

4. 在业务模块中引用集中管理的依赖 #

比如在app模块的build.gradle.kts中，直接引用声明好的依赖：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
}

android {
    // 你的Android项目配置（compileSdk、defaultConfig等）
}

dependencies {
    implementation(Dependencies.coreKtx)
    implementation(Dependencies.appcompat)
    // 其他业务依赖也可以按这种方式引用
}

完成以上步骤后，重新执行Gradle构建，错误即可解决，同时实现了所有模块统一引用集中声明的依赖和版本。

内容的提问来源于stack exchange，提问作者Prateek Gaur