README_ZH.md

MVVM-Rhine

Android端 MVVM + Jetpack 架构组件的Github客户端。

English Documentation | 中文文档

通知

关于项目的起源，请参考笔者的这篇文章：

使用MVVM尝试开发Github客户端及对编程的一些思考

屏幕截图

三方组件

Android官方架构组件

• DataBinding: Declaratively bind observable data to UI elements.

• Lifecycle: Create a UI that automatically responds to lifecycle events.

• LiveData: Build data objects that notify views when the underlying database changes.

• ViewModel: Store UI-related data that isn't destroyed on app rotations. Easily schedule asynchronous tasks for optimal execution.

• Room: Access your app's SQLite database with in-app objects and compile-time checks.

• Navigation: Handle everything needed for in-app navigation.

• Paging: Makes it easier for you to load data gradually and gracefully within your app's RecyclerView.

网络请求

• Retrofit2: Type-safe HTTP client for Android and Java by Square, Inc.

• OkHttp: An HTTP+HTTP/2 client for Android and Java applications.

依赖注入

• Kodein-DI: Painless Kotlin Dependency Injection

响应式库

• RxKotlin: RxJava bindings for Kotlin

• RxJava2: A library for composing asynchronous and event-based programs using observable sequences for the Java VM

• RxAndroid: RxJava bindings for Android

• RxBinding: RxJava binding APIs for Android's UI widgets.

• RxPermissions: Android runtime permissions powered by RxJava2.

• RxWeaver: A lightweight and flexible error handler tools for RxJava2.

• AutoDispose: Automatic binding+disposal of RxJava 2 streams.

函数式库

• Arrow: Functional companion to Kotlin's Standard Library.

其它

• Glide: An image loading and caching library for Android focused on smooth scrolling

• Timber: A logger with a small, extensible API which provides utility on top of Android's normal Log class.

工具/插件

• MVVM-Rhine-Template: Activity or Fragment code generation template for MVVM-Rhine.

开始使用

• 直接通过git命令行进行clone:

$ git clone https://github.com/qingmei2/MVVM-Rhine.git

如何入手学习这个项目？

如何使用Android Jetpack？

• Android官方架构组件Lifecycle：生命周期组件详解&原理分析
• Android官方架构组件LiveData: 观察者模式领域二三事
• Android官方架构组件ViewModel:从前世今生到追本溯源
• Android官方架构组件Paging：分页库的设计美学
• Android官方架构组件Navigation：大巧不工的Fragment管理框架
• Android官方架构组件DataBinding双向绑定篇: 观察者模式的殊途同归

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

• 告别Dagger2，在Kotlin项目中使用Kodein进行依赖注入
• 【译】Android开发从Dagger2迁移至Kodein的感受

如何进阶学习RxJava？

• 理解RxJava（一）：基本流程源码分析
• 理解RxJava（二）：操作符流程原理分析
• 理解RxJava（三）：线程调度原理分析
• 理解RxJava（四）Subject用法及原理分析

• 解决RxJava内存泄漏（前篇）：RxLifecycle详解及原理分析
• 解决RxJava内存泄漏（后篇）：Android架构中添加AutoDispose解决RxJava内存泄漏

如果您依然不满意这个项目中的代码风格, 欢迎体验笔者关于状态管理的最新实践，个人而言更趋近于理想中的设计:

MVI-Rhine: 基于Jetpack + MVVM, 更加响应式&函数式的编程实践

感谢

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

⭐ 项目参考了 rx-mvvm-android 并对其部分代码进行了引用.

License

The MVVM-Rhine: Apache License

Copyright (c) 2018 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.