Skip to content
The practice of MVI + Jetpack architecture in Android.
Kotlin
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper
mvi_rhine
sample Merge branch 'master' of https://github.com/qingmei2/MVI-Rhine Nov 4, 2019
screenshots update README and add screenshots. Apr 30, 2019
.gitignore init project. Jan 28, 2019
LICENSE Initial commit Jan 23, 2019
README.md Update README. Aug 1, 2019
README_EN.md
build.gradle update library version. Mar 17, 2019
dependencies.gradle refactor: use dagger.android instead of kodein. Aug 1, 2019
gradle.properties init project. Jan 28, 2019
gradlew
gradlew.bat init project. Jan 28, 2019
settings.gradle Rename mvi module and remove useless file. Feb 20, 2019

README.md

MVI-Rhine

English Documentation | 中文文档

通知

  • 如果编译遇到如下图的错误,请先参考下方【开始使用】,对项目进行配置:

出现这个问题的原因,最新版本的代码,需要开发者注册一个自己的OAuth Application,注册后,Github的API访问次数就能达到5000次/小时(之前的版本只有60次/小时),之前很多朋友反应在Debug过程中不够用,断点打了几次就被限制请求了,因此最新版本添加了这个配置的步骤,虽然麻烦了一小步,但是对于学习效率的提升,这点配置时间可以忽略不计。

概述

这个 Github客户端 的Android项目是基于 MVI (Model-View-Intent) 模式进行开发的,项目整体 业务逻辑UI的交互逻辑 全部交由 RxJava2 进行串联。

MVI 架构旨在使用 响应式函数式编程 (Reactive && Functional Programming), 这个架构的两个主要组件,ViewViewModel可以看作是函数,两者间通过RxJava相互输入和输出:

屏幕截图

三方组件

Android 官方架构组件 Jetpack

网络请求

依赖注入

响应式库

函数式库

其它

工具/插件

开始使用

  • 1.直接通过git命令行进行clone:
$ git clone https://github.com/qingmei2/MVI-Rhine.git
  • 2.注册你的GithubApp

首先打开这个链接,注册属于你的OAuth Application

注册完成后,记住下面的Client IDClient Secret,并配置到你的项目根目录的local.properties文件中:

CLIENT_ID = "xxxxxx"
CLIENT_SECRET = "xxxxxx"

大功告成,接下来点击编译并运行即可。🎉 🎉 🎉

如何入手学习这个项目?

如何使用Android Jetpack

如何使用Kodein进行依赖注入?

如何进阶学习RxJava

如何理解 MVI状态管理

感谢

🎨 项目中的UI设计部分参考了 gitme .

⭐️ 感谢 oldergod/android-architecture 项目对本项目的指导性作用.

License

The MVI-Rhine: Apache License

Copyright (c) 2019 qingmei2

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.