Awesome
<p align="center"> PokemonGo <img src='http://cdn.51git.cn/2020-07-15-34.png'></p>
<p align="center"> 神奇宝贝 (PokemonGo) 基于 Jetpack + MVVM + Repository + Paging3 + Kotlin Flow 的实战项目 </p> <p align="center"> 这是一个小型的 App 项目,涉及到技术:Paging3(network + db),Dagger-Hilt,App Startup,DataBinding,Room,Motionlayout,Kotlin Flow,Coil,JProgressView 等等。 </p> <p align="center"> <a title="GitHub Stars" target="_blank" href="https://github.com/hi-dhl/PokemonGo/stargazers"> <img alt="GitHub Stars" src="https://img.shields.io/github/stars/hi-dhl/PokemonGo.svg?label=Stars&style=social"> </a> <a title="GitHub Forks" target="_blank" href="https://github.com/hi-dhl/PokemonGo/network/members"> <img alt="GitHub Forks" src="https://img.shields.io/github/forks/hi-dhl/PokemonGo.svg?label=Forks&style=social"> </a> </p> <p align="center"> <a href="https://github.com/hi-dhl"><img src="https://img.shields.io/badge/GitHub-HiDhl-4BC51D.svg?style=flat"></a> <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/license-Apache2.0-blue.svg?style=flat"></a> <img src="https://img.shields.io/badge/language-kotlin-orange.svg"/> <img src="https://img.shields.io/badge/platform-android-lightgrey.svg"/> </p> <p align="center"> PokemonGo 动态效果图如下所示,如果动图无法查看,请点击这里查看 <a href="http://cdn.51git.cn/2020-07-14-15946978385391.gif"> 动态效果图</a> | <a href="http://img.hi-dhl.com/Pokemon.png"> 静态图</a></p> <p align="center"> <img src="http://img.hi-dhl.com/Pokemon.png"/> </p>PokemonGo 更新记录
2020-12-05:
- upgrad kotlin plugin to 1.4.2
- delete Kotlin synthetics
- delete kotlin-android-extensions
2020-09-27:
- 使用 ConflatedBroadcastChannel 实现 DB 搜索
- 使用 StateFlow 实现 NetWork 搜索
- 增加了 Kotlin 常用操作符
debounce
、filter
、flatMapLatest
、distinctUntilChanged
的使用
以上更新对应分析文章:
2020-07-26:
- 增加了使用 sealed 在 Flow 基础上封装成功或者失败处理
- 自定义 RemoteMediator 实现数据库和网络加载数据( RemoteMediator 是 Paging3 当中重要成员 )
以上更新对应分析文章:
2020-07-23:
- Flow 在 MVVM 当中的使用
- Activity 、Fragment、ViewModel 结合 Flow 三种使用方式
- Flow 的异常处理
- 增加 Fragment 1.2.0 上重要的更新: 通过 Fragment 的构造函数传递参数,以及 FragmentFactory 和 FragmentContainerView 的使用
- ......
以上更新对应分析文章:
2020-07-14:
- 自定义 RemoteMediator 实现 network + db 的混合使用 ( RemoteMediator 是 Paging3 当中重要成员 )
- 使用 Data Mapper 分离数据源 和 UI
- Kotlin Flow 结合 Retrofit2 + Room 的混合使用
- Kotlin Flow 与 LiveData 的使用
- 使用 Coil 加载图片
- 使用 ViewModel、LiveData、DataBinding 协同工作
- 使用 Motionlayout 做动画
- App Startup 与 Hilt 的使用
- ......
关于 PokemonGo 项目分析的文章请查看 神奇宝贝 眼前一亮的 Jetpack + MVVM 极简实战
如果这个仓库对你有帮助,请仓库右上角帮我 star 一下,非常感谢。
项目 PokemonGo 涉及到的技术
- Gradle Versions Plugin:检查依赖库是否存在最新版本
- Kotlin Flow:flow 是对 Kotlin 协程的扩展,让我们可以像运行同步代码一样运行异步代码
- JetPack
- Paging3(network + db):用到了 Paging3 中的
RemoteMediator
用来实现 network + db - Dagger-Hilt (2.28-alpha):依赖注入框架
- App Startup:设置组件初始化顺序
- DataBinding:以声明方式将可观察数据绑定到界面上
- Room:在 SQLite 上提供了一个抽象层,流畅地访问 SQLite 数据库
- LiveData:在底层数据库更改时通知视图
- ViewModel:以注重生命周期的方式管理界面相关的数据
- Andriod KTX:编写更简洁、惯用的 Kotlin 代码
- Paging3(network + db):用到了 Paging3 中的
- 项目架构
- MVVM 架构
- Repository 设计模式
- Data Mapper 数据映射
- Retrofit2 & OkHttp3:用于请求网路数据
- Coil:基于 Kotlin 开发的首个图片加载库
- material-components-android:模块化和可定制的材料设计 UI 组件
- Motionlayout :MotionLayout 是一种布局类型,可帮助您管理应用中的动画
- Timber: 日志打印
- JProgressView :一个小巧灵活可定制的进度条,支持图形:圆形、圆角矩形、矩形等等
以上技术栈对应之前写的技术文章:
- Jetpack 最新成员 AndroidX App Startup 实践以及原理分析
- Jetpack 成员 Paging3 实践以及源码分析(一)
- Jetpack 新成员 Paging3 网络实践及原理分析(二)
- Jetpack 新成员 Hilt 实践(一)启程过坑记
- Jetpack 新成员 Hilt 实践之 App Startup(二)进阶篇
- Jetpack 新成员 Hilt 与 Dagger 大不同(三)落地篇
- 全方面分析 Hilt 和 Koin 性能
- [译][2.4K Star] 放弃 Dagger 拥抱 Koin
- 项目中封装 Kotlin + Android Databinding
- 为数不多的人知道的 Kotlin 技巧以及 原理解析(一)
- 为数不多的人知道的 Kotlin 技巧以及 原理解析(二)
如何检查依赖库的版本更新
在项目的根目录下执行以下命令。
./gradlew dependencyUpdates
会在当前目录下生成 build/dependencyUpdates/report.txt 文件,内容如下所示:
The following dependencies have later release versions:
- androidx.swiperefreshlayout:swiperefreshlayout [1.0.0 -> 1.1.0]
https://developer.android.com/jetpack/androidx
- com.squareup.okhttp3:logging-interceptor [3.9.0 -> 4.7.2]
https://square.github.io/okhttp/
- junit:junit [4.12 -> 4.13]
http://junit.org
- org.koin:koin-android [2.1.5 -> 2.1.6]
- org.koin:koin-androidx-viewmodel [2.1.5 -> 2.1.6]
- org.koin:koin-core [2.1.5 -> 2.1.6]
Gradle release-candidate updates:
- Gradle: [6.1.1 -> 6.5.1]
会列出所有需要更新的依赖库的最新版本,并且 Gradle Versions Plugin 比 AndroidStudio 所支持的更加全面:
- 支持手动方式管理依赖库最新版本检查
- 支持 ext 的方式管理依赖库最新版本检查
- 支持 buildSrc 方式管理依赖库最新版本检查
- 支持 gradle-wrapper 最新版本检查
- 支持多模块的依赖库最新版本检查
- 支持多项目的依赖库最新版本检查
MVVM 架构
PokemonGo 基于 MVVM 架构和 Repository 设计模式,如今几乎所有的 Android 开发者至少都听过 MVVM 架构,在谷歌 Android 团队宣布了 Jetpack 的视图模型之后,它已经成为了现代 Android 开发模式最流行的架构之一。
<p align="center"> <img src="http://cdn.51git.cn/2020-07-12-159453363449491.jpg"/> </p>Jetpack 的视图模型的 MVVM 架构由 View + DataBinding + ViewModel + Model 组成。
TODO
- 加入更多 Jetpack 成员
- 设计更多的实用场景
- 增加单元测试
- 增加 Motionlayout 的使用
- ......
联系我
- 个人微信:hi-dhl
- 公众号:ByteCode,包含 Jetpack ,Kotlin ,Android 10 系列源码,译文,LeetCode / 剑指 Offer / 多线程 / 国内外大厂算法题 等等一系列文章
最后推荐我一直在更新维护的项目和网站:
-
计划建立一个最全、最新的 AndroidX Jetpack 相关组件的实战项目 以及 相关组件原理分析文章,正在逐渐增加 Jetpack 新成员,仓库持续更新,欢迎前去查看:AndroidX-Jetpack-Practice
-
LeetCode / 剑指 offer / 国内外大厂面试题 / 多线程 题解,语言 Java 和 kotlin,包含多种解法、解题思路、时间复杂度、空间复杂度分析<br/>
<image src="http://cdn.51git.cn/2020-10-04-16017884626310.jpg" width = "500px"/> -
最新 Android 10 源码分析系列文章,了解系统源码,不仅有助于分析问题,在面试过程中,对我们也是非常有帮助的,仓库持续更新,欢迎前去查看 Android10-Source-Analysis
-
整理和翻译一系列精选国外的技术文章,每篇文章都会有译者思考部分,对原文的更加深入的解读,仓库持续更新,欢迎前去查看 Technical-Article-Translation
-
「为互联网人而设计,国内国外名站导航」涵括新闻、体育、生活、娱乐、设计、产品、运营、前端开发、Android 开发等等网址,欢迎前去查看 为互联网人而设计导航网站
感谢
中文:
- PokemonGo 使用了 PokeAPI
- 感谢 Pokedex 、 Kotlin-Pokedex 、 gradle-versions-plugin 和 Jetpack 等等开源项目
English:
- PokemonGo use PokeAPI data
- Thanks to the Pokedex 、 Kotlin-Pokedex 、 gradle-versions-plugin and Jetpack open source project