从零搭一个项目

模块化:它买的不是「整洁」,是编译时间

先把动机说清楚,因为「模块化」这个词被讲得太玄了。

三条铁律

NIA 的模块图遵守三条规则,它们不是品味问题,每条都对应一种具体的事故:

下面这个 Demo 里,初始状态就是 NIA 的那张图。你可以往里加边 —— 试试 「制造一个循环」,或者手动加一条 :feature:news → :feature:bookmarks, 看它会怎么骂你:

build-logic:消灭那重复了 20 遍的 40 行

分了模块之后,你会立刻撞上一个新问题。每个 feature 模块的 build.gradle.kts 都长这样:

// :feature:news/build.gradle.kts —— 然后 :feature:bookmarks 里一模一样
// 再然后 :feature:settings 里还是一模一样……
plugins {
    id("com.android.library")
    id("org.jetbrains.kotlin.android")
    id("org.jetbrains.kotlin.plugin.compose")
    id("com.google.devtools.ksp")
    id("com.google.dagger.hilt.android")
}
android {
    compileSdk = 36
    defaultConfig { minSdk = 24 }
    compileOptions { /* …… */ }
    buildFeatures { compose = true }
}
dependencies {
    implementation(project(":core:data"))
    implementation(project(":core:designsystem"))
    implementation(libs.androidx.lifecycle.runtime.compose)
    implementation(libs.hilt.android)
    ksp(libs.hilt.compiler)
    // …… 再来二十行
}

复制粘贴二十遍。然后有一天你要升 compileSdk —— 改二十个文件,漏一个。

build-logic 是这个问题的解:把重复的那坨配置,写成一个你自己的 Gradle 插件。

// build-logic/convention/src/main/kotlin/AndroidFeatureConventionPlugin.kt
class AndroidFeatureConventionPlugin : Plugin<Project> {
    override fun apply(target: Project) = with(target) {
        // 把上面那四十行,在这里写一次
        pluginManager.apply("myapp.android.library")
        pluginManager.apply("myapp.android.compose")
        pluginManager.apply("myapp.hilt")

        dependencies {
            add("implementation", project(":core:data"))
            add("implementation", project(":core:designsystem"))
            add("implementation", libs.findLibrary("androidx.lifecycle.runtime.compose").get())
        }
    }
}

于是每个 feature 模块的构建脚本,缩成了这四行:

// :feature:news/build.gradle.kts —— 全文如下
plugins {
    alias(libs.plugins.myapp.android.feature)
}
android { namespace = "com.example.feature.news" }

一份可以直接抄的版本目录

下面这份 gradle/libs.versions.toml,版本号全部取自本书那三个真实项目 2026 年 7 月的实测值 —— 不是我编的,是从它们仓库里的版本目录抄出来的。

[versions]
# —— 构建工具链(取自 Now in Android) ——
agp = "9.0.0"
kotlin = "2.3.0"                  # Mihon 已经上到 2.4.0 了,也很稳

# —— Compose(取自 Mihon,是目前最新的 BOM) ——
composeBom = "2026.06.01"

# —— 导航:Navigation 3(2025-11 转正,当前稳定版) ——
navigation3 = "1.1.3"

# —— Jetpack ——
lifecycle = "2.11.0"
room = "2.8.3"                    # NIA 在用
hilt = "2.59"                     # NIA 在用

# —— Kotlin 生态 ——
coroutines = "1.11.0"
serialization = "1.11.0"

# —— 网络与图片 ——
okhttp = "5.4.0"                  # Mihon 在用(注意:5.x 了)
coil = "3.5.0"                    # Coil 3 是多平台的

[libraries]
androidx-navigation3-runtime = { module = "androidx.navigation3:navigation3-runtime", version.ref = "navigation3" }
androidx-navigation3-ui      = { module = "androidx.navigation3:navigation3-ui",      version.ref = "navigation3" }
androidx-lifecycle-viewmodel-compose = { module = "androidx.lifecycle:lifecycle-viewmodel-compose", version.ref = "lifecycle" }
androidx-lifecycle-runtime-compose   = { module = "androidx.lifecycle:lifecycle-runtime-compose",   version.ref = "lifecycle" }
androidx-room-runtime = { module = "androidx.room:room-runtime", version.ref = "room" }
hilt-android  = { module = "com.google.dagger:hilt-android",          version.ref = "hilt" }
hilt-compiler = { module = "com.google.dagger:hilt-android-compiler", version.ref = "hilt" }
okhttp = { module = "com.squareup.okhttp3:okhttp", version.ref = "okhttp" }
coil-compose = { module = "io.coil-kt.coil3:coil-compose", version.ref = "coil" }

[plugins]
android-application = { id = "com.android.application", version.ref = "agp" }
kotlin-android      = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
kotlin-compose      = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
# ↑ 注意:Compose 编译器现在跟着 kotlin 的版本号走(第 2 章)
kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }
hilt = { id = "com.google.dagger.hilt.android", version.ref = "hilt" }

项目骨架长什么样

MyApp/
├─ build-logic/                     ← convention plugin 住这儿(模块 > 5 个才需要)
│   └─ convention/
│       └─ AndroidFeatureConventionPlugin.kt
├─ gradle/
│   └─ libs.versions.toml           ← 上面那份
├─ app/                             ← 只是个壳:拼装 + entryProvider + Application
├─ feature/
│   ├─ news/                        ← 每个 feature 一个模块,彼此不相识
│   ├─ bookmarks/
│   └─ settings/
└─ core/
    ├─ navigation/                  ← 只放 @Serializable 的路由 key。谁都能依赖
    ├─ designsystem/                ← 主题、颜色、可复用组件
    ├─ data/                        ← Repository 实现。feature 只跟它打交道
    ├─ database/                    ← Room。只有 :core:data 能碰它
    ├─ network/                     ← Retrofit / Ktor。只有 :core:data 能碰它
    └─ model/                       ← 纯 Kotlin data class,不依赖任何人

注意 :core:database 和 :core:network 的位置:只有 :core:data 能依赖它们。 这样一来,「数据是从库里来的还是从网上来的」这个决定,被彻底封死在 :core:data 内部 —— 这正是第 5 章那个 SSOT 结构在模块层面的样子。上面的 Demo 里,你把 :app 直连到 :core:database,它就会警告你,原因就在这儿。

最后一张表:你该选哪一档

这是整本书的交付物。

结语:你其实没落下多少

回头看这六章。你离开了一年半,而真正需要你重新学的东西,列出来是这样:

• 一套新的导航 API —— 但它比旧的简单,因为它把返回栈还给了你。
• 一个可以删代码的编译器改进 —— 强跳过让你删掉那些 @Immutable。
• 一个新的 DI 选项 —— 而 Hilt 依然是默认答案。
• 两条平台强制 —— edge-to-edge 和大屏不锁方向。

就这些。而没变的东西是:

• 三层分层。
• 单向数据流。
• 唯一真相。
• Repository 返回 Flow。
• 状态提升。

▲ 回到图纸目录