📐 3 · Gradle 多模块配置

📁 settings.gradle.kts · 模块注册

多模块架构下，根目录 settings.gradle.kts 统一声明所有子模块：

// 根目录 settings.gradle.kts
pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

rootProject.name = "MultiModuleCompose"

// 模块注册 —— 中小学生也能看懂的命名 😊
include(":app")
include(":core:ui")
include(":core:network")
include(":feature:home")
include(":feature:profile")
include(":feature:settings")
include(":library:common")

🔗 模块间依赖声明

每个模块的 build.gradle.kts 通过 project() 引用其他模块：

implementation(project(":feature:home"))

implementation(project(":core:ui"))

implementation(project(":core:network"))

implementation(project(":library:common"))

无模块依赖

✅ 推荐使用 implementation 避免依赖泄漏

📦 版本目录 (Version Catalog)

在 gradle/libs.versions.toml 中集中管理依赖版本，告别硬编码：

# gradle/libs.versions.toml
[versions]
compose-bom = "2024.12.01"
kotlin = "2.0.21"
agp = "8.5.2"
retrofit = "2.9.0"
compose-compiler = "1.5.15"

[libraries]
compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "compose-bom" }
compose-ui = { group = "androidx.compose.ui", name = "ui" }
compose-material3 = { group = "androidx.compose.material3", name = "material3" }
retrofit-core = { group = "com.squareup.retrofit2", name = "retrofit", version.ref = "retrofit" }
kotlin-stdlib = { group = "org.jetbrains.kotlin", name = "kotlin-stdlib", version.ref = "kotlin" }

[plugins]
android-application = { id = "com.android.application", version.ref = "agp" }
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

在模块中引用版本目录：

// app/build.gradle.kts
plugins {
    alias(libs.plugins.android.application)
    alias(libs.plugins.kotlin.android)
    alias(libs.plugins.compose.compiler)
}

dependencies {
    implementation(platform(libs.compose.bom))
    implementation(libs.compose.ui)
    implementation(libs.compose.material3)
    implementation(libs.retrofit.core)
    implementation(project(":feature:home"))
}

🧭 模块依赖架构 SVG