Kotlin實現MVP架構的Android快速開發框架

簡介

• KCommon快速開發框架是基於rxjava、rxcache、okhttp、retrofit、rxlifecycle等第三方庫，採用mvp架構，使用kotlin語言開發的一個第三方庫，配合一鍵生成mvp相關代碼文件的Android Studio模板文件，能夠使使用者快速開發，專一於代碼邏輯，而非mvp相關的繁瑣配置。而且集成了Loading、成功、失敗和空頁面的切換，同時還提供了對下拉刷新以及上拉加載更多的列表的模板（BaseRefreshAndLoadMoreActivity||BaseRefreshAndLoadMoreFragment）,省去了Android開發人員對相同類型代碼的重複編寫。Github地址

• 使用此開發框架須要的一些前置知識

  • 熟悉android中的mvp架構
  • 熟悉rxjava、rxcache、rxlifecycle等響應式編程框架
  • 熟悉okhttp、retrofit
  • 會複製快速開發模板到指定位置並使用

• KCommon提供了兩種便於開發的模板

  • 以Base開頭的BaseActivity和BaseFragment。這種適合通用的開發。具體的使用請參考相關的demo。
  • 以BaseRefreshAndLoadMore開頭的BaseRefreshAndLoadMoreActivity和BaseRefreshAndLoadMoreFragment。這種適合列表展現的頁面開發，具有下拉刷新和上拉加載更多數據的功能。具體的使用請參考相關的demo。
  • kotlin版本的demo java版本的demo

圖片展現

• 總的演示

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

• 空頁面

• 在斷網狀況下加載緩存

• 網絡請求錯誤並從新加載

基於Kotlin的使用說明（Java的使用具體參考java版本的demo）

• 導入依賴

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

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

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

• 在自定義的Application類中的onCreate方法中初始化CommonLibrary

//初始化KCommon
CommonLibrary.instance.initLibrary(this,

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<String, String>? = null,
        errorHandleMap: Map<Int, (exception: IApiException) -> Unit>? = null,
        onPageCreateListener: OnPageCreateListener? = null,
        onPageDestroyListener: OnPageDestroyListener? = null,
        onPageResumeListener: OnPageResumeListener? = null,
        onPagePauseListener: OnPagePauseListener? = null)