《从零搭建现代 Android 模块化架构项目（2025 最新实践）》

🧭 一、前言

过去几年 Android 架构经历了从 MVC → MVP → MVVM → Clean Architecture 的演进。到了 2025 年，官方推荐的现代架构已经非常明确：

Kotlin + Jetpack ***pose + Hilt + Clean Architecture + Gradle Kotlin DSL + 多模块化

这种结构不仅提升构建速度与维护性，还能让团队多人并行开发更加高效。

本文将带你从零搭建一个完整的模块化项目结构，并附上所有关键代码与配置，开箱即用 ✅。

📚 二、项目目标结构

我们最终要得到一个这样的多模块结构：

project-root/
├── app/                      # 主壳工程（启动入口）
├── core/                     # 核心层
│   ├── core-***mon/          # 通用工具、常量、扩展函数
│   ├── core-***work/         # 网络封装（Retrofit + OkHttp）
│   ├── core-database/        # 数据层（Room / DataStore）
│   └── core-ui/              # 通用 ***pose UI 组件
├── feature/                  # 功能模块层
│   ├── feature-login/        # 登录模块
│   ├── feature-home/         # 首页模块
│   └── feature-profile/      # 个人中心模块
├── lib/                      # 通用业务库
│   └── lib-router/           # 路由与模块跳转
└── build-logic/              # Gradle 配置（高级工程化）

⚙️ 三、Step 1：创建项目

1. 打开 Android Studio → New Project
2. 选择 Empty ***pose Activity
3. 设置：
   • Language: Kotlin
   • Minimum SDK: 24+
   • Name: ModularApp

完成后运行确认项目可正常启动。

🧱 四、Step 2：配置 Kotlin DSL + 版本统一管理

🧩 settings.gradle.kts

pluginManagement {
    repositories {
        google()
        mavenCentral()
    }
}

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

rootProject.name = "ModularApp"
include(":app")

🧩 新建文件 gradle/libs.versions.toml

统一依赖与版本管理：

[versions]
kotlin = "2.2.20"
***pose = "1.9.3"
***pose-material = "1.4.0"
hilt = "2.57.2"
retrofit = "3.0.0"
coil = "2.7.0"

[libraries]
***pose-ui = { module = "androidx.***pose.ui:ui", version.ref = "***pose" }
***pose-material3 = { module = "androidx.***pose.material3:material3", version.ref = "***pose-material" }
hilt-android = { module = "***.google.dagger:hilt-android", version.ref = "hilt" }
hilt-***piler = { module = "***.google.dagger:hilt-***piler", version.ref = "hilt" }
retrofit = { module = "***.squareup.retrofit2:retrofit", version.ref = "retrofit" }
coil-***pose = { module = "io.coil-kt:coil-***pose", version.ref = "coil" }

🧩 五、Step 3：配置主模块（app）

app/build.gradle.kts：

plugins {
    id("***.android.application")
    id("org.jetbrains.kotlin.android")
    id("***.google.dagger.hilt.android")
    kotlin("kapt")
}

android {
    namespace = "***.example.modularapp"
    ***pileSdk = 35

    defaultConfig {
        applicationId = "***.example.modularapp"
        minSdk = 24
        targetSdk = 35
        versionCode = 1
        versionName = "1.0"
    }

    buildFeatures {
        ***pose = true
    }

    ***poseOptions {
        kotlin***pilerExtensionVersion = libs.versions.***pose.get()
    }
}

dependencies {
    implementation(libs.***pose.ui)
    implementation(libs.***pose.material3)
    implementation(libs.coil.***pose)
    implementation(libs.retrofit)
    implementation(libs.hilt.android)
    kapt(libs.hilt.***piler)
}

🧩 六、Step 4：创建子模块

你可以使用 Android Studio → New → Module，或手动创建以下结构：

例如：core-***mon/build.gradle.kts

plugins {
    id("***.android.library")
    id("org.jetbrains.kotlin.android")
}

android {
    namespace = "***.example.core.***mon"
    ***pileSdk = 34
}

dependencies {
    implementation(kotlin("stdlib"))
}

然后在 settings.gradle.kts 注册：

include(":core:core-***mon")
include(":core:core-***work")
include(":feature:feature-login")

🧩 七、Step 5：模块依赖管理规则

示例：

// app/build.gradle.kts
dependencies {
    implementation(project(":feature:feature-login"))
    implementation(project(":core:core-***mon"))
}

🧩 八、Step 6：接入 Hilt 依赖注入

App.kt：

@HiltAndroidApp
class App : Application()

AndroidManifest.xml：

<application
    android:name=".App"
    android:label="@string/app_name"
    android:theme="@style/Theme.ModularApp" />

🧩 九、Step 7：添加 ***pose 界面

MainActivity.kt

@AndroidEntryPoint
class MainActivity : ***ponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            MaterialTheme {
                HomeScreen()
            }
        }
    }
}

// 示例 UI：
@***posable
fun HomeScreen() {
    Column(
        modifier = Modifier.fillMaxSize(),
        horizontalAlignment = Alignment.CenterHorizontally,
        verticalArrangement = Arrangement.Center
    ) {
        Text("Wel***e to Modular App")
    }
}

🧩 十、Step 8：可选 - 路由与组件化（ARouter）

lib-router/build.gradle.kts

dependencies {
    implementation("***.alibaba:arouter-api:1.5.2")
    kapt("***.alibaba:arouter-***piler:1.5.2")
}

初始化（App.kt）：

if (BuildConfig.DEBUG) {
    ARouter.openLog()
    ARouter.openDebug()
}
ARouter.init(this)

使用：

ARouter.getInstance()
    .build("/feature/login")
    .navigation()

🧰 十一、进阶优化建议

📘 十二、最终项目技术栈总结

🚀 十三、一句话总结

✅ ***pose 时代的现代 Android 工程化项目标准栈：
Kotlin + Hilt + ***pose + Clean Architecture + 多模块化 + Gradle Kotlin DSL

📊 十四、模块依赖架构图（Mermaid 图）

✨ 十五、结语

当项目从单体结构演进为模块化架构后，不仅能提升构建速度与可维护性，还能让不同业务团队并行开发、独立发布。

如果你正计划重构项目结构，这套 2025 最新模块化模板可以作为你的最佳起点 🚀。