zbiext/Jetpack-Mvvm

使用Jetpack全家桶+Kotlin实现的Android社区App加音乐播放器。不写晦涩难懂的代码，尽量标清每一行注释，严格遵守六大基本原则，大量运用设计模式，此项目可快速帮你入手Kotlin、Jetpack。如果觉得对你有帮助，右上角点个star，事先谢过🍉🍉🍉

注意注意

as升级到4.2后jdk location默认是11，而本项目jdk 1.8所以有冲突，会报java.lang.NoClassDefFoundError: javax/xml/bind/JAXBException错误。具体解决方案 https://stackoverflow.com/questions/67410927/java-lang-noclassdeffounderror-javax-xml-bind-jaxbexception-after-updating-to-a

建议结合本人两篇关于架构的文章去理解项目

引入Jetpack架构后，你的App会发生哪些变化？

关于Android架构，你是否还在生搬硬套？

1. 背景

为了更深入的理解Jetpack中各个组件，在前段时间基于Jetpack MVVM实现了一版 WanAndroid。相比上一版的MVP增加了夜间模式和音乐播放器，播放器界面仿照网易云音乐。App中也大量的使用属性动画让界面简约而不简陋。先上图look一波

2. 应用技术

基础框架选用MVVM，选用的Jetpack组件包括Lifecycle、ViewModel、LiveData、DataBinDing、Navigation、Room。

项目基于Navigation由单Activity多Fragment实现，使用这种模式给我最直观的感受就是快，比如点击搜索进入搜索界面的衔接动画，在多Activity之间是不可能这么连贯的。

整个项目全部使用Kotlin语言，广泛应用了协程编写了大量的扩展函数。

关于每个模块的职责我是这样定义的：

Model

对应项目中Repository，做数据请求以及业务逻辑。

ViewModel

基于Jetpack中的ViewModel进行封装(友情提示：Jetpack ViewModel和MVVM ViewModel没有半毛钱关系，切勿将两个概念混淆)。在项目中VM层职责很简单，通过内部通过LiveData做数据存储，以及结合DataBinding做数据绑定。

View

尽量只做UI渲染。与MVP中不同，View是通过DataBinding与数据进行绑定，Activity或Fragment非常轻盈只专注于生命周期的管理，数据渲染基本全部由DataBinding+BindAdapter实现。

关于MVVM模版类的封装可至package com.zs.base_library.base(包名)下查看。

网络层

关于网络层继续使用OkHttp Retrofit，并对Retrofit多ApiService以及多域名进行了封装。

数据库

项目中历史记录是在本地数据库进行维护的，关于数据库使用了Jetpack中的Room。

主题切换

Android原生提供的夜间切换好像又API版本限制，所以就没有用。我个人在本地维护了两套主题，可动态切换。当前包含白天、夜间两套主题

3. 关于注释

我个人是非常喜欢写注释的，基本每一个复杂的功能都有对应的文字描述

项目中运用了大量的设计模式，每用到一种设计模式我都会结合当时场景进行解释，比如播放器中某个接口，我会这样写注释：

/**
 * des 所有的具体Player必须实现该接口,目的是为了让PlayManager不依赖任何
 *     具体的音频播放实现,原因大概有两点
 *
 *     1.PlayManager包含业务信息,Player不应该与业务信息进行耦合,否则每次改动都会对业务造成影响
 *
 *     2.符合开闭原则,如果需要对Player进行替换势必会牵连到PlayManager中的业务,因而造成不必要的麻烦
 *       如果基于IPlayer接口编程,扩展出一个Player即可,正所谓对扩展开放、修改关闭
 *
 * @author zs
 * @date 2020-06-23
 */
interface IPlayer {
    ....
    ....
}

/**
 * des 音频管理
 *     通过单例模式实现,托管音频状态与信息,并且作为唯一的可信源
 *     通过观察者模式统一对状态进行分发
 *     实则是一个代理,将目标对象Player与调用者隔离,并且在内部实现了对观察者的注册与通知
 * @author zs
 * @date 2020/6/25
 */
class PlayerManager private constructor() : IPlayerStatus {
     ....
     ....
}

写在最后

此项目中你很难看到不明不白的代码。Jetpack和Kotlin是大势所趋，既然拒绝不了那何不开心的拥抱。功能目前已完成90%，代码也在持续优化，欢迎大家关注、下载源代码，让我们共同学习、共同进步。