TMDb-Compose-Playground：安卓架构范例

项目简介

TMDb-Compose-Playground 是一个模块化的 Android 应用工程，使用 Kotlin 与 Jetpack Compose 构建，数据来源为 TMDB（The Movie Database）。它同时承担两重角色：一个可以浏览影视内容的 App，以及一份可参考的现代 Android 架构实践样例。

主要功能

• 采用 MVVM 架构与 Repository 设计模式，工程按多模块（multi-modules）组织。
• 基于 Jetpack Compose 构建原生界面，使用 Navigation-Compose 在 composable 之间导航。
• 使用 Paging3 Compose 分页加载数据。
• 通过 Hilt 完成依赖注入，Room 提供基于 SQLite 的本地数据持久化。
• 使用 Kotlin Coroutines 处理异步任务，StateFlow 向收集者推送状态更新。
• Retrofit 负责类型安全的 HTTP 请求，Moshi / Gson 解析 JSON，OkHttp interceptor 记录请求与响应日志。
• Coil-compose 加载图片，Material Design 组件构建界面。
• 集成 GitHub Actions 持续集成。
• 测试：Repository 与 ViewModel 层有本地单元测试（Mockito-kotlin、Mockk、Turbine），页面使用 Compose UI Test 做 UI 测试。

安装与使用

1. 在 TMDB 申请 API Key。
2. 在项目的 local.properties 文件中添加：

tmdb_api_key=YOUR_API_KEY

3. 用 Android Studio 打开工程，构建并运行。

注意事项

• 必须自行配置 TMDB API Key 才能正常获取数据。
• 界面效果可参考仓库 README 中的 Screenshots 动图。
• 项目灵感来自 Jetsnack、Jetflix 与 Cinemax。
• 采用 MIT License 开源。

本作品整理自 GitHub 开源项目 alirezaeiii/TMDb-Compose-Playground，原作者 @alirezaeiii。中文介绍由 AI 根据项目 README 整理，以原仓库为准。