Awesome

#XDroidMvp 轻量级的Android MVP快速开发框架

概述

XDroidMvp是XDroidAndroid快速开发框架的MVP版本，其使用方式类似于XDroid，大部分源码也来自XDroid。

XDroidMvp全新文档：https://github.com/limedroid/XDroidMvp/wiki

XDroidMvp主要会有这些特性：

无需写Contract！ 无需写Present接口！ 无需写View接口!

新增：

• Mvp实现
• RxJava & RxAndroid
• 权限适配 RxPermission
• 事件订阅默认采用 RxBus
• 网络交互：
  • Retrofit + rx
  • Https
  • 统一异常处理
  • 缓存
  • 支持多个baseUrl
  • 。。。。
• 无需担心rx内存泄漏

保留：

• 提供XActivity、XFragment、SimpleRecAdapter、SimpleListAdapter等基类，可快速进行开发
• 完整封装XRecyclerView，可实现绝大部分需求
• XStateController、XRecyclerContentLayout实现loading、error、empty、content四种状态的自由切换
• 实现了Memory、Disk、SharedPreferences三种方式的缓存，可自由扩展
• 内置了RxBus，可自由切换到其他事件订阅库
• 内置Glide，可自由切换其他图片加载库
• 可输出漂亮的Log，支持Json、Xml、Throwable等，蝇量级实现
• 内置链式路由
• 内置常用工具类：package、random、file...,提供的都是非常常用的方法
• 内置加密工具类 XCodec，你想要的加密姿势都有

先睹为快

你可以这么使用:

BasePagerFragment

public abstract class BasePagerFragment extends XFragment<PBasePager>{

   @Override
    public void initData(Bundle savedInstanceState) {
        getP().loadData(getType(), 1);	//调用P方法
    }

   public void showData(int page, GankResults model) {
        if (page > 1) {
            getAdapter().addData(model.getResults());
        } else {
            getAdapter().setData(model.getResults());
        }

        contentLayout.getRecyclerView().setPage(page, MAX_PAGE);

        if (getAdapter().getItemCount() < 1) {
            contentLayout.showEmpty();
            return;
        }
    }
    
	 @Override
    public PBasePager newP() {
        return new PBasePager();
    }}
    
    @Override
    public int getLayoutId() {
        return R.layout.fragment_base_pager;
    }

PBasePager

public class PBasePager extends XPresent<BasePagerFragment> {
    protected static final int PAGE_SIZE = 10;


    public void loadData(String type, final int page) {
        Api.getGankService().getGankData(type, PAGE_SIZE, page)
                .compose(XApi.<GankResults>getApiTransformer())
                .compose(XApi.<GankResults>getScheduler())
                .subscribe(new ApiSubcriber<GankResults>() {
                    @Override
                    protected void onFail(NetError error) {
                        getV().showError(error); //调用V方法
                    }

                    @Override
                    public void onNext(GankResults gankResults) {
                        getV().showData(page, gankResults);
                    }
                });
    }
}

Get Started

使用，仅需四步：

step1

clone 'XDroid'库到本地:

git clone https://github.com/limedroid/XDroidMvp.git

step2

将mvp作为依赖库，在您的app module 中 添加如下依赖:

compile project(':mvp')

step3

拷贝conf.gradle到您的项目根目录，并修改项目gradle文件下引入：

apply from: "conf.gradle"

并添加:

allprojects {
    repositories {
        jcenter()
        maven { url "https://jitpack.io" }
    }
}

step4

修改XDroidConf配置类，主要针对log、cache、router、imageloader。若采用默认配置，此步骤可略过.

第二种方式，通过JitPack引入

step1 在根目录的gradle文件中配置:

allprojects {
    repositories {
        jcenter()
        maven { url "https://jitpack.io" }
    }
}

step2 添加依赖:

dependencies {
	        compile 'com.github.limedroid:XDroidMvp:v1.5.0'
}

Demo效果

重要说明

• ButterKnife使用的是8.4.0版本，重点是 @BindView，可以去项目官网查看。
• Rxlifecycle使用的是1.0版本，具体如何使用可以查看官网。
• RxPermissions使用的是0.9.1版本，具体如何使用可以查看官网。
• retrofit，具体如何使用可以查看官网。

更新日志

• 2016-12-23，新增mvp、base、cache、event、imageloader、log、router
• 2016-12-25，新增rxJava、rxAndroid、rxlifecycle、rxpermission、rxbus、net(retrofit)
• 2016-12-26，新增网络异常统一处理
• 2016-12-28，重构MVP
• 2016-12-30，重构网络层
• 2016-12-31，新增Demo

TODO

• rx
• retrofit
• rxpermission
• rxbus
• cache
• wiki
• demo

About Me

Email : droidlover@126.com

XDroid交流群：153569290

XDroid MVC版本：XDroid

若您在使用过程中遇到任何问题，欢迎加入 153569290 群或者是邮件反馈，谢谢您的关注。XDroidMvp会持续维护，如果喜欢，记得star fork。