🚀 从零搭建一个完整的 App

手把手带你从空项目搭建一个生产级架构的 App（资讯类），完整走一遍工程化流程。

一、项目规划

需求：资讯 App（首页列表、详情、收藏、搜索）

技术栈：Kotlin + Jetpack Compose + MVVM + Hilt + Room + Retrofit + Paging

二、工程搭建

1. 初始化项目

Android Studio → New Project → Empty Activity（Compose）
包名：com.example.news

2. 依赖管理（Version Catalog）

# gradle/libs.versions.toml
[versions]
kotlin = "2.0.0"
compose = "1.7.0"
hilt = "2.51.1"

[libraries]
androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }

3. 模块划分

:app（壳工程 + 页面）
:core:network（网络层）
:core:database（数据层）
:feature:home（首页业务）
:feature:detail（详情业务）

三、架构落地

数据层（Data Layer）

interface NewsRepository {
    fun getNewsList(page: Int): Flow<List<News>>
}

class NewsRepositoryImpl(
    private val api: NewsApi,
    private val dao: NewsDao
) : NewsRepository {
    override fun getNewsList(page: Int): Flow<List<News>> =
        flow {
            // 网络获取
            val remote = api.getNews(page)
            // 缓存入库
            dao.insertAll(remote)
            emit(remote)
        }.flowOn(Dispatchers.IO)
}

UI 层（Compose + ViewModel）

@HiltViewModel
class HomeViewModel @Inject constructor(
    private val repository: NewsRepository
) : ViewModel() {
    val uiState: StateFlow<HomeUiState> = repository.getNewsList(1)
        .map { HomeUiState.Success(it) }
        .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), HomeUiState.Loading)
}

四、工程实践

• Git：初始化仓库、约定式提交
• CI：GitHub Actions 自动构建
• 测试：Repository 单元测试 + 关键页面 UI 测试
• 多渠道：debug / release 变体配置

五、进阶方向

• 加入 Paging 3 分页
• 离线缓存策略（网络优先 / 缓存优先）
• 性能优化（列表性能、启动优化）
• 数据埋点与崩溃监控

📖 配套知识：架构设计 | 组件化 | CI/CD