Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imyyq-star/MVVMArchitecture
MVVM 框架，采用 Kotlin+Jetpack，可自由配置功能，欢迎 star，fork，issue
https://github.com/imyyq-star/MVVMArchitecture
android architecture databinding glide jetpack kotlin mvvm retrofit2
Last synced: 8 days ago
JSON representation
MVVM 框架，采用 Kotlin+Jetpack，可自由配置功能，欢迎 star，fork，issue
- Host: GitHub
- URL: https://github.com/imyyq-star/MVVMArchitecture
- Owner: imyyq-star
- License: apache-2.0
- Created: 2020-06-14T04:12:10.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-02-27T12:38:00.000Z (over 2 years ago)
- Last Synced: 2024-08-01T18:33:36.767Z (3 months ago)
- Topics: android, architecture, databinding, glide, jetpack, kotlin, mvvm, retrofit2
- Language: Kotlin
- Homepage:
- Size: 413 KB
- Stars: 245
- Watchers: 2
- Forks: 75
- Open Issues: 2
-
Metadata Files:
- Readme: ReadMe.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://jitpack.io/#imyyq-star/MVVMArch) [](https://github.com/imyyq-star/MVVMArchitecture/blob/master/LICENSE)
**框架已发布到 jitpack 远程仓库中**，可以根据 [Wiki - 通过远程仓库引入框架](https://github.com/imyyq-star/MVVMArchitecture/wiki/0%E3%80%81%E9%80%9A%E8%BF%87%E8%BF%9C%E7%A8%8B%E4%BB%93%E5%BA%93%E5%BC%95%E5%85%A5%E6%A1%86%E6%9E%B6)。
也可以不通过远程仓库，直接引入源码，**如需引入源码，请参照 [Wiki - 通过 submodule 引入框架](https://github.com/imyyq-star/MVVMArchitecture/wiki/1%E3%80%81%E9%80%9A%E8%BF%87%20submodule%20%E5%BC%95%E5%85%A5%E6%A1%86%E6%9E%B6)**
以 MVVMArchitecture 作为公共基础模块，搭建组件化架构，参见 [MVVMArchModularization](https://github.com/imyyq-star/MVVMArchModularization) 示例，相关文章参见 [一种更好的组件化方式](https://juejin.im/post/6886635469464698887/)
# 简介
本框架设计遵循以上架构图，框架的好处**就是经过尽可能的封装，让开发变得更便捷，同时也更稳定，更安全，代码也更统一，更干净等等**。你只需经过简单的几个步骤，就能很快的上手，MVVM 的分层方式可以看看这篇：[MVVMArchitecture，一款可配置的 MVVM 框架](https://www.jianshu.com/p/87fabd2523b4)，或自行搜索相关的知识点，这里就不展开叙述了。
本框架为了方便开发者而对常用的功能进行了封装。框架主体代码使用 Kotlin 编写，小部分工具代码使用 Java 编写，兼容 Kotlin 和 Java，兼容 Rx 和 协程。
下面我们通过一些举例来认识框架的好处，详细使用方法可参考 [Wiki](https://github.com/imyyq-star/MVVMArchitecture/wiki) 或 [MVVMArchitectureSample](https://github.com/imyyq-star/MVVMArchitectureSample)。
# 举例
下面的举例，都是我在从事 Android 开发过程中遇到的实际问题，并不是凭空瞎想的，我们一个一个的来看。
## 1. 应用的大小问题
APK 的大小向来是一个敏感的点，越小则被用户接受的可能性就越大，但在开发中，我们不可避免的要引入第三方库，那么就意味着 APK 的大小也会变大，这也是正常的。
不过有一点我没法忍的是：如果我的项目很小，只需要用到框架中的一小部分基础功能，并不需要其他的功能，比如我不需要请求网络数据，可是开发框架却因为封装了 Retrofit2 而导致部分或全部相关代码也被打进去 APK 包里了，但是这部分代码我是根本用不到的。或者是，我的项目很大，但我也可能没有用到框架的某一部分，这个问题就很难忍了。如果你没有引入源码，想改都没办法。
所以我期望的是：**框架可以给很小的项目使用，也可以给很大的项目使用，可以在不修改源码的情况下，通过配置文件去禁用某些功能，从而保证 APK 包的干净。**
**本框架的第一个要点就是尽可能的可定制化，不需要的功能，不仅不会打包到 APK 中，甚至连对象实例都不会创建，尽可能为封装的功能提供：全局开启/关闭，和局部开启/关闭**。
## 2. 框架的更新和更改问题
在 Android 中，想使用已经提交到远程仓库的第三方库，根据文档 implementation 即可，这样做的好处当然是很多的，可对于**基础框架类型**的开发库来说，我认为有一定的限制。
首先基础框架是属于应用中的底层架构，很多功能都是基于框架而来的，牵一发而动全身，如果有一天你发现了在某种条件下出现了某些 Bug，而框架却没有处理到（任何框架都有可能有问题），此时你要么把源码引入进来自行修改，要么找作者修改后再更新。这种方式都需要一个过程，不太灵活。
其次是没有源码，你也没法为框架做开源贡献，遇到问题可能自己解决了就懒得再去下载源码，然后修改后贡献给框架了。
最后是也许你的项目是需要交付源码出去的，客户可能会要求你除去项目中无用的代码或减少 APK 的大小。
**本框架第二个独特的点，在于项目即可通过远程仓库引入，也可通过 git submodule，让框架以源码引入的方式，成为你项目中的子仓库**。
根据自己的需要去选择。
## 3. 生命周期的问题
在 Jetpack 出来之前，生命周期的处理还是比较麻烦的，有了 Jetpack 后，我们可以通过 LiveData 和 DataBinding 来关联数据和界面，这样生命周期就安全了。
框架的基础就是封装了 Activity/Fragment/XML 和 ViewModel 等基类，这是框架最基础的。
将 Jetpack 提供的 ViewModel 类作为 MVVM 中的 VM 层，它负责执行耗时操作和更新视图等业务逻辑。Activity/Fragment/XML 作为 V 层，负责展示页面和接收用户操作等视图相关的操作。
他们之间的关系和数据流动如下：
这样就将 V 和 VM 安全的关联起来了，Activity/Fragment/XML 都持有 VM 的实例，VM 的数据流向 V 是通过 LiveData 和 DataBinding。
可以在这个基础上做很多封装，常见的一个例子：打开一个界面后执行网络请求，在请求还没有完成前，用户就退出了界面，此时通过封装可以让 VM 感知 V 的生命周期，在 V destroy 的时候 cancel 掉网络请求，避免资源的浪费。
## 4. 图片加载的问题
图片加载我个人推荐使用 Glide，如果你喜欢用其他的，可以参照 Glide 的封装方式自行封装。在没有经过封装前，可能你需要写这样的代码：
```java
Glide.with(imageView.getContext())
.load(url)
.apply(new RequestOptions().placeholder(placeholderRes))
.into(imageView)
```
而利用 DataBinding，我们可以做到这样：
```xml
```
mImageUrl 是一个 LiveData，或 ObservableField，你只需要控制 mImageUrl 的图片链接，其他的框架帮你实现了。
## 5. 请求服务器数据的问题，使用 Rx 还是 协程 的问题
如果你是用 Kotlin 开发项目，异步操作当然首选协程啦，协程是可以替代 Rx 的。但是如果你使用 Java 开发，那么就只能使用 Rx 了，在请求服务器数据这一块，甚至你都不用使用什么 Rx 或协程，直接用 Retrofit 自带的 Callback 也是可以的，缺点就是对数据的处理没那么灵活了。
使用什么方式去获取服务器数据，其实不是关键，协程、Rx、Callback 这三种框架都提供了支持。
关键是在于请求回来的数据如何处理？数据解析 Retrofit 已经帮我们解析成对象，我们要关注的是如何操作解析后的对象。
一般来说服务器接口返回的数据都有通用字段的（如果没有的话，恐怕你遇到的是远古后端团队），比如如下示例：
```json
{
"errorCode": 0,
"errorMsg": "",
"data": []
}
```
**以上字段名称其实极大可能不同团队是不一样的，字段类型也可能是不一样的，甚至一个应用中不同接口的格式都不统一，这种恶心的情况我也是遇到过的**，但是不管怎么说，通常都会有以上 3 种类型的字段：code 状态码，msg 状态信息，data 数据。我们需要对这几种类型进行封装，提供一个通用接口，如下：
```kotlin
/**
* 实体基类必须实现这个接口并复写其中的方法，这样才可以使用 BaseViewModel 中的协程方法，还有使用 CommonObserver 或 HttpRequest 类中的功能也必须实现此接口
*/
interface IBaseResponse {
fun code(): Int?
fun msg(): String?
fun data(): T?
fun isSuccess(): Boolean
}
```
然后你就可以基于这个接口来定义你的数据基类啦，如下：
```kotlin
data class BaseEntity(
var data: T?,
var errorCode: Int?,
var errorMsg: String?
) : IBaseResponse {
override fun code() = errorCode
override fun msg() = errorMsg
override fun data() = data
override fun isSuccess() = errorCode == 0
}
```
看到没？变化的只是 BaseEntity 的字段，而接口方法将他们统一了，不管服务端接口返回的数据多么妖孽都能 Hold 住。
这样我们就可以对数据进行统一的处理啦，只要写好了基类，接下来的网络请求过程你就不需要再去判断请求结果是正确还是错误的了，框架会统一处理并在相应的地方把结果给到你，你只需要处理结果就行了。**具体的去看 Wiki 和示例吧。**
## 6. 加载中对话框的问题
通常来说，在进行耗时操作时，都会向用户展示相关的信息，比如：
以上这种是对话框形式的，还可能是内嵌形式的，比如：
框架中也进行了封装，可以自定义相关 Ui，**同时也提供了全局开启/关闭，和局部开启/关闭的功能**，为什么呢？因为 Loading 的显示和隐藏，是和界面相关的，通过 LiveData 来操作，可能有些应用根本不需要这个功能，或者说应用中只有某些页面需要，这样就可以最大程度的避免实例创建或引入某些不需要的库。
**注意：全局开启/关闭，和局部开启/关闭的功能是框架的普遍功能，只要你觉得能想到的，都可以尝试去做，比如 Activity 的侧滑返回功能，VM 启动和结束界面的功能等，详见 GlobalConfig 配置类**
## 7. 应用前后台监听的问题
有了 Jetpack，我们可以通过 ProcessLifecycleOwner 来监听应用的前后台，无需再去对 activity 计数了，框架提供了 AppStateTracker 类来监听。
除了 AppStateTracker 外，还有许多工具类可用，比如数据库 RoomUtil 类，AppActivityManager 管理类等。
## 8. DataBinding 的问题
DataBinding 是用来实现 MVVM 架构的一个非常好的方式，但它不是必须的。而且它是一个一直被人嫌弃的技术，我个人在熟悉 DataBinding 之前，也挺嫌弃它的，所以一直用 LiveData 多写点代码让 UI 响应数据的更改。
后来随着框架封装的深入使用，才发现 DataBinding 真香，它不仅可以消灭 findViewById，还可以和 LiveData 联动，**最重要的是：DataBinding 可以让你少写很多代码。**
本框架是推荐同学们首选使用 DataBinding 的，但可能有些同学对 DataBinding 还不是很熟悉，使用此框架时只用到了它能解决 findViewById 的功能，甚至使用 Kotlin 开发的，直接用 kotlin-android-extensions 就解决 findViewById 了。
如果你不想使用 DataBinding，对于解决 findViewById 我是不推荐使用 kotlin-android-extensions 的，它的可读性不好，最好使用 ViewBinding 来解决。
因此框架提供了对单纯 ViewBinding 的支持，将基类分成了 DataBindingBaseActivity/ViewBindingBaseActivity 和 DataBindingBaseFragment/ViewBindingBaseFragment，按需继承相关基类即可。也就是说如果你不熟悉 DataBinding，那可以继承自 ViewBindingBaseXxxxx，这样就只帮你解决 findViewById 的问题，具体的 V 和 VM 数据交互和响应就得自己做了。
个人推荐把 DataBinding 学起来，告别 setText、setOnClickListener 等样板无聊的代码。可以看看本人的文章：[DataBinding，让人又爱又恨的一个框架](https://juejin.im/post/6857815150565687303/)
## 9. 更多使用
以上只是列了下部分的问题，详细使用详见 [Wiki](https://github.com/imyyq-star/MVVMArchitecture/wiki) 或 [MVVMArchitectureSample](https://github.com/imyyq-star/MVVMArchitectureSample)。
# 交流 QQ 群 828441270
如果你有任何疑问，有更好的封装想法，有更好的代码技巧，欢迎入群一起讨论，我们的**目的是更好的代码，更快的开发速度，更优雅的风格，更早下班撩妹的工作方式**
**另外，如果你发现问题，欢迎提交合并或提 Issue，或者是有相关的建议或不明确的功能点也可以在群里提**。