Skip to content

Latest commit

 

History

History
109 lines (76 loc) · 9.38 KB

MVPArms.md

File metadata and controls

109 lines (76 loc) · 9.38 KB

MVPArms

Bintray Build Status API License QQGroup

一个整合了大量主流开源项目的 Android Mvp 快速搭建框架

Usage

New Project

如果你想构建一个全新的项目,直接将整个项目 clone (或者下载) 下来,再将 app 作为主 Module (建议将 arms Module 删除,并使用 Gradle 远程依赖本框架,便于更新),最后将项目包名改成自己的包名, app Module 包含可以直接使用的包结构,一个主流的 MVP+Dagger2+Retrofit+Rxjava 框架就这样轻松的构建成功了,现在你再参考 Mvp 包下的 UserActivity 的格式,使用 Template 自动生成 MVP , Dagger2 相关类,配合查阅 Wiki 文档 慢慢掌握本框架,看再多文章不如早点在项目中使用它,在实践中学习总是最快的

Old Project

老项目想引入此框架,可以参考 Wiki 文档 ,写的非常详细

Wiki

详细使用方法及扩展功能,请参照 Wiki

Notice

  • 意见收集

  • 更新日志

  • 常见 issues

  • 版本更新

  • 我们为什么要把 Dagger2 ,MVP 以及 Rxjava 引入项目中?

  • 看了上面的文章,对为什么使用这些技术应该比较了解了,使用这些技术对项目后期的维护和迭代特别是大型项目非常有帮助,但是在开发前期每写一个页面要多写很多 MVP,Dagger2 的类和接口,这对于开发前期确实比较头疼,现在本框架已经可以通过 Template 自动生成一些 MVP,Dagger2 的模版代码,现在大家可以非常轻松的使用本框架.

  • 使用此框架自带自动适配功能,请参考 AutoLayout 使用方法.

  • 此框架使用 RxPermissions 用于权限管理(适配 Android 6.0 ),并提供 PermissionUtil 工具类一行代码实现权限请求.

  • 作为通用框架,本框架不提供与 UI 有关的任何第三方库(除了 AutoLayout 屏幕适配方案).

Feature

  • 网络请求层: 如今主流的网络请求框架有 Volley,Okhttp,Retrofit (Android-async-http 停止维护了) ,因为这个库是基于 Rxjava , Retrofit 支持 Rxjava ,默认使用 Okhttp 请求网络(Okhttp 使用 Okio , Okio 基于 IO 和 NIO 性能优于 Volley , Volley 内部封装有 Imageloader ,支持扩展 Okhttp ,封装比 Okhttp 好,但是比较适合频繁,数据量小的网络请求),所以此库默认使用 Retrofit 作为网络请求层.

  • 图片加载: 因为图片加载框架各有优缺点,Fresco,Picasso,Glide 这些都是现在比较主流得图片加载框架,所以为了扩展性本框架提供一个统一的管理类 Imageloader ,使用策略者模式,开发者只用实现接口,就可以动态替换图片框架,外部提供统一接口加载图片,替换图片加载框架毫无痛点,并且为了快速实现,默认提供一个 Glide 的默认实现类,有其它需求可以参照 Wiki 替换为别的图片加载框架.

  • Model层: 优秀的数据库太多, GreenDao,Realm,SqlBrite(Square 公司出品,对 SQLiteOpenHelper 封装,提供响应式 Api 访问数据库), SqlDelight,Storio,DBFlow ,每个框架的使用方法都不一样,本框架只提供有一个管理类 RepositoryManager 里面默认封装了 RxCache (此框架根据 Retrofit Api 实现了缓存逻辑,并提供响应式接口), Retrofit 等与数据相关的框架,以后有其他需求如需使用数据库,就可以直接封装进 RepositoryManager ,本框架通过 Dagger2 向 Model 层注入 RepositoryManager,来提供给开发者数据处理的能力,这样的好处的是上层(Activity/Fragment/Presenter)不需要知道数据源的细节(来自于网络、数据库、亦或是内存等等),下层可以根据需求修改(缓存的实现细节)上下两层分离互不影响.

Functionality & Libraries

  1. MvpGoogle官方出品的Mvp架构项目,含有多个不同的架构分支(此为Dagger分支).
  2. Dagger2Google根据Square的Dagger1出品的依赖注入框架,通过Apt编译时生成代码,性能优于使用运行时反射技术的依赖注入框架.
  3. Rxjava提供优雅的响应式Api解决异步请求以及事件处理.
  4. RxAndroid为Android提供响应式Api.
  5. Rxlifecycle在Android上使用rxjava都知道的一个坑,就是生命周期的解除订阅,这个框架通过绑定activity和fragment的生命周期完美解决.
  6. RxCache是使用注解为Retrofit加入二级缓存(内存,磁盘)的缓存库.
  7. RxErroHandlerRxjava 的错误处理库,可在出现错误后重试.
  8. RxPermissions用于处理Android运行时权限的响应式库.
  9. RetrofitSquare出品的网络请求库,极大的减少了http请求的代码和步骤.
  10. Okhttp同样Square出品,不多介绍,做Android都应该知道.
  11. Autolayout鸿洋大神的Android全尺寸适配框架.
  12. GsonGoogle官方的Json Convert框架.
  13. ButterknifeJakeWharton大神出品的view注入框架.
  14. Androideventbus一个轻量级使用注解的Eventbus.
  15. TimberJakeWharton大神出品Log框架容器,内部代码极少,但是思想非常不错.
  16. Glide此库为本框架默认封装图片加载库,可参照着例子更改为其他的库,Api和Picasso差不多,缓存机制比Picasso复杂,速度快,适合处理大型图片流,支持gfit,Fresco太大了!,在5.0以下优势很大,5.0以上系统默认使用的内存管理和Fresco类似.
  17. LeakCanarySquare出品的专门用来检测AndroidJava的内存泄漏,通过通知栏提示内存泄漏信息.

Update

Acknowledgements

感谢本框架所使用到的所有三方库的 Author ,以及所有为 Open Sourece 做无私贡献的 DeveloperOrganizations ,使我们能更好的工作和学习,本人也会将业余时间回报给开源社区

About Me

License

 Copyright 2016, jessyan       
  
   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.