简介

• KCommon快速开发框架是基于rxjava、rxcache、okhttp、retrofit、rxlifecycle等第三方库，采用mvp架构，使用kotlin语言开发的一个第三方库，配合一键生成mvp相关代码文件的Android Studio模板文件，可以使使用者快速开发，专注于代码逻辑，而非mvp相关的繁琐配置。并且集成了Loading、成功、失败和空页面的切换，同时还提供了对下拉刷新以及上拉加载更多的列表的模板（BaseRefreshAndLoadMoreActivity||BaseRefreshAndLoadMoreFragment）,省去了Android开发人员对相同类型代码的重复编写。

• 使用此开发框架需要的一些前置知识

  • 熟悉android中的mvp架构
  • 熟悉rxjava、rxcache、rxlifecycle等响应式编程框架
  • 熟悉okhttp、retrofit
  • 会复制快速开发模板到指定位置并使用

• KCommon提供了两种便于开发的模板

  • 以Base开头的BaseActivity和BaseFragment。这种适合通用的开发。具体的使用请参考相关的demo。
  • 以BaseRefreshAndLoadMore开头的BaseRefreshAndLoadMoreActivity和BaseRefreshAndLoadMoreFragment。这种适合列表展示的页面开发，具备下拉刷新和上拉加载更多数据的功能。具体的使用请参考相关的demo。

图片展示

• 总的演示

• 下拉刷新和上拉加载更多

• 空页面

• 在断网情况下加载缓存

• 网络请求错误并重新加载

基于Kotlin的使用说明（Java的使用具体参考java版本的demo）

• 导入依赖

  • 在根目录中的build.gradle文件中加入

  maven { url "https://jitpack.io" }

  • 在应用下的build.gradle文件中加入

• 在自定义的Application类中的onCreate方法中初始化CommonLibrary

//初始化KCommon

BuildConfig.APP_URL,            ApiService::class.java,            CacheService::class.java)

* 建议配合一键生成相关MVP类的Android Studio模板进行开发，可极大提高开发效率。模板位置 [Android Studio 快速开发模板](https://github.com/BlackFlagBin/KCommonTemplate)### 详细说明* CommonLibrary.instance.initLibrary()

/** * 初始化 * * @param context Application * @param baseUrl retrofit所需的baseUrl * @param apiClass retrofit使用的ApisService::Class.java * @param cacheClass rxcache使用的CacheService::Class.java * @param spName Sharedpreference文件名称 * @param isDebug 是debug环境还是release环境。debug环境有网络请求的日志，release反之 * @param startPage 分页列表的起始页，有可能是0，或者是2，这个看后台 * @param pageSize 分页大小 * @param headerMap 网络请求头的map集合，便于在网络请求添加统一的请求头，比如token之类 * @param errorHandleMap 错误处理的map集合，便于针对相关网络请求返回的错误码来做相应的处理，比如错误码401，token失效需要重新登录 * @param onPageCreateListener 对应页面activity或fragment相关生命周期的回调，便于在页面相关时机做一些统一处理，比如加入友盟统计需要在所有页面的相关生命周期加入一些处理 * @param onPageDestroyListener 对应页面activity或fragment相关生命周期的回调，便于在页面相关时机做一些统一处理，比如加入友盟统计需要在所有页面的相关生命周期加入一些处理 * @param onPageResumeListener 对应页面activity或fragment相关生命周期的回调，便于在页面相关时机做一些统一处理，比如加入友盟统计需要在所有页面的相关生命周期加入一些处理 * @param onPagePauseListener 对应页面activity或fragment相关生命周期的回调，便于在页面相关时机做一些统一处理，比如加入友盟统计需要在所有页面的相关生命周期加入一些处理 * */fun initLibrary(        context: Application,        baseUrl: String,        apiClass: Class<*>,        cacheClass: Class<*>,        spName: String = "kcommon",        isDebug: Boolean = true,        startPage: Int = 1,        pageSize: Int = 20,        headerMap: Map
    
     ? = null,        errorHandleMap: Map
     
       Unit>? = null,        onPageCreateListener: OnPageCreateListener? = null,        onPageDestroyListener: OnPageDestroyListener? = null,        onPageResumeListener: OnPageResumeListener? = null,        onPagePauseListener: OnPagePauseListener? = null)