Home

Jump to bottom

鸡你太美 edited this page Oct 19, 2025 · 4 revisions

🏗 JetpackMvvm

JetpackMvvm 是一个基于 Jetpack 架构组件构建的 Android MVVM 快速开发框架，旨在帮助开发者快速搭建高质量、可维护、可扩展的应用。

✨ 框架特性

🧠 标准化 MVVM 架构设计
基于 ViewModel、LiveData、Flow、Repository 的分层体系，提供清晰、可维护的应用结构。
⚡ 协程驱动的响应式数据流
全面采用 Kotlin Coroutines 进行异步管理，天然支持挂起函数与结构化并发。
🔄 灵活的加载与状态管理机制
内置统一的页面状态切换（加载中 / 空 / 错误 / 成功），支持全局配置与自定义样式。
🧩 高度模块化的基类封装
提供 BaseActivity、BaseFragment、BaseViewModel 等基础实现，快速构建页面逻辑。
🪶 无侵入式视图绑定支持
兼容 ViewBinding 与 DataBinding，减少模板代码，让开发更轻量高效。
🌐 网络层可插拔设计
简洁而灵活的封装，可与 Retrofit、OkHttp 或任意网络框架无缝配合使用。
💎 丰富的便捷工具集
内置常用封装：本地自动缓存、Glide 图片加载、Gson 数据解析、日志打印等，开箱即用。
🌈 完整示例工程，助你快速上手
基于玩Android API 开发了一个示例,注释非常详细，App展示框架在真实项目中的使用方式与开发流程。

📚 文档导航

1. 快速开始

环境配置要求
框架初始化
第一个 MVVM 页面创建
基类引入指南

2. 基类功能介绍

BaseVmActivity / BaseVbActivity 使用指南
BaseVmFragment / BaseVbFragment 功能详解
BaseViewModel 核心功能
自定义标题栏、Loading弹窗、状态布局
懒加载和生命周期管理

3. 基于 LiveData 的网络请求封装

request DSL 详细使用指南
单次请求场景最佳实践
自动 Loading 状态管理
异常统一处理机制
串行和并行操作示例

4. 基于 Flow 的网络请求封装

requestFlow DSL 高级功能
实时数据流处理
复杂数据流组合
背压处理和性能优化
SharedFlow 配置详解

5. LiveData vs Flow 选择指南

两种方案对比分析
不同场景下的选择建议
混合使用策略
迁移路径指南

6. 常用功能封装

RecyclerView 快速构建和分页加载
自动本地缓存 (MMKV)
图片加载工具
JSON 解析扩展
Toast、Log 工具
启动优化管理
页面跳转和数据传递
Activity 栈管理

7. 常见问题

Fragment 中 LifecycleOwner 选择
自定义 Loading 对话框
状态布局正确使用
线程安全和 UI 更新
请求取消机制
自定义状态布局

8. 网络框架加入指南

支持的网络框架要求
Retrofit + OkHttp 集成示例
统一响应体处理
协程集成的优势