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
。
拓展:Fragmentation如何兼容新版本的setMaxLifecycle
(2)框架中在 View和ViewModel 之间嵌入了Controller的机制,方便
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({
//得到数据后做处理
})
}
(未完,后续会补全优化文档)