Capybara-Arch 一个Android 架构

CapybaraArch是Capybara系列里的一个Android架构，包含MVVM基础组件、网络请求、校验器（编写文档中）、埋点（开发中）。

按照惯例，先放上Github

• Github https://github.com/Ubitar/Capybara-Arch
  ————————————————————————————————————————————————————————

1、MVVM基础组件 基于Databinding的MVVM库

• Model、View、ViewModel职责明确，可通过实现其接口实现更多组件
• 整合 fragmentation 改（仅适配setMaxLifecycle，不兼容setUserVisibleHint()的情况）
• 提供简易 Controller 实现（控制显示加载框/显示提示消息/显示加载成功）

2、网络请求基于Retrofit的网络请求库

• 使用经典Retrofit+Rxjava组合
• 支持自定义Okhttp、自定义解析和错误统一处理
  
  

1、导入

repositories {
   jcenter()
}

MVVM库 ：

implementation 'com.ubitar.capybara:archcapybara-mvvm:1.2.0' 

//以下为其他必要的依赖
implementation 'androidx.lifecycle:lifecycle-extensions:2.2.0'

网络库：

implementation 'com.ubitar.capybara:archcapybara-network:1.2.0'

//以下为其他必要的依赖 可自定义版本
implementation 'io.reactivex.rxjava2:rxjava:2.2.8'
implementation 'io.reactivex.rxjava2:rxandroid:2.1.0'
implementation 'com.squareup.retrofit2:retrofit:2.5.0'
implementation 'com.squareup.retrofit2:adapter-rxjava2:2.5.0'
implementation 'com.squareup.retrofit2:converter-gson:2.4.0'
implementation 'com.google.code.gson:gson:2.8.6'

2、MVVM基础组件

不熟悉MVVM或想进一步了解的同学可以先看看这篇文章和精简demo
Capybara-MVVM 一个Android基础组件架构，面还是我在吹牛逼

(1) 架构与Fragmentation耦合使用，且对Fragmentation做出了修改，仅兼容SDK29 后更新的setMaxLifecycle控制生命周期，不兼容使用setUserVisibleHint控制生命周期，例如ViewPager1。

FragmentPagerAdapter中的setUserVisibleHint模式和setMaxLifecycle模式
拓展：Fragmentation如何兼容新版本的setMaxLifecycle
(2）框架中在 View和ViewModel 之间嵌入了Controller的机制，方便
image.png
image.png

3、网络请求

网络请求使用Retrofit封装，支持多个Host及添加拦截器，支持自定网络请求返回处理。

在Application中新增请求的Host，及其网络拦截器。

NetworkManager.getInstance().addServer(
      NetworkTag.DEFAULT_HOST_TAG, Server.create(Host.DEFAULT_HOST_URL, {
//            此处可以添加Logger拦截器或修改响应时间
//            it.addInterceptor(LoggerInterceptor())
//            it.addInterceptor(TokenInterceptor())
}))

编写Retrofit接口服务文件

interface Demo4Api {

    @FormUrlEncoded
    @POST("student/login")
    fun login(
        @Field("account") account: String,
        @Field("password") password: String
    ): Flowable<UserBean>
}

class DemoRepository : BaseRepository<Demo4Api>() {
    //确认接口路径文件
    override fun getApi(): Class<Demo4Api> {
        return Demo4Api::class.java
    }
    //设置服务标识，用以绑定Host
    override fun getServerTag(): String {
        return NetworkTag.DEFAULT_HOST_TAG
    }
    //网络请求中间预处理层，用于加密或转Map等轻处理
    fun login(account: String, password: String): Flowable<UserBean> {
        return repository.login(account, password)
    }
}

在model层请求网络

class DemoModel(
    private val viewModel: Demo4ViewModel
) : BaseModel(viewModel) {

    private val demoRepository = DemoRepository()

    fun toLogin(account: String, password: String) {
        demoRepository.login(account, password)
            .compose(SchedulerCompose.io2main())
            .compose()/转换数据数据
            .retryWhen(RetryWhenFunction(3000, 3))//网络问题重试请求
            .subscribe({
                    //得到数据后做处理
            })
    }

（未完，后续会补全优化文档）