SimpleLib
🔥 simpleLib 是笔者开发历程中积累下来的能大幅提升效率的方法和约束整合。旨在 帮助基于该类库的开发者能够高效的完成 Android 项目搭建和开发
项目 持续迭代更新 中，会继续丰富类库功能。
基于 Java1.8 开发，深度依赖以下开源类库
data-binding RxJava glide okHttp Gson
项目基本结构
└── simplelib
├── Const.java 类库所需常量
├── LibCore.java 初始化核心
├── core
│ ├── JsonHelper.java Json转化
│ ├── ImageLoader.java 图片加载
│ ├── Logs.java 日志管理
│ ├── PrefHelper.java SharePreference管理
│ ├── Router.java 界面跳转路由
│ ├── RxBus.java 事件管理
│ ├── RxHelper.java RxJava线程调度
│ └── UiHelper.java 界面工具集合
├── http
│ ├── OkHttpHelper.java okHttp管理
│ ├── SslCertHelper.java ssl信任
│ ├── cookie cookie管理
│ └── intercaptor 拦截器
├── model
│ ├── DeviceInfo.java 设备信息
│ └── CommonEvent 事件载体
├── ui
│ ├── BindingAdapters.java dataBindingAdapter
│ ├── activity activity界面基类
│ ├── adapter 基础适配器
│ ├── fragment fragment界面基类
│ ├── interfaces 接口约束
│ └── web WebView的封装处理(腾讯x5)
├── util
│ ├── CallBacks.java 基础回调封装
│ ├── StringHelper.java 字符串工具类集合
│ ├── ThreadHelper.java 线程调度工具类集合
│ └── UrlUtil.java Url工具类集合
└── view 自定义view集合
如何使用
1. 引入依赖
// app/build.gradle 处添加依赖
implementation 'com.github.cchao:simpleLib:[last_version]'
或 clone 类库作为项目的子模块引用
2. 初始化类库
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
// 核心 初始化
LibCore.init(mContext, new LibCore.InfoSupport() {
// 使用Lib提供的 OkhttpClient 能获取基本的网络交互日志
public OkHttpClient getOkHttpClient() {
return OkHttpManager.getOriginClient();
}
public LibCore.ILogEvents getLogEvents() {
return new LibCore.ILogEvents() { /* 自定义日志上报规则 */};
}
public LibCore.RouterConfig getRouterConfig() {
return new LibCore.RouterConfig() { /* 自定义路由拦截规则 */};
}
});
// 自定义基础样式
LibCore.setLibConfig(new LibCore.LibConfig() { /* 自定义界面基础样式 */ });
}
}
类库说明
核心依赖
基础核心，进行初始化和依赖对象的注入, 由 InfoSupport 和 LibConfig 提供配置项
-
InfoSupport 返回基本且必须的参数
- getOkHttpClient 提供给上层调用，默认使用 SimpleLib 默认的 OkHttpClient 实例
- getLogEvents 日志事件回调，可以在这执行日志收集（比如 Bugly 收集）
- getRouterConfig 路由配置，如：某些需要登录权限的页面会调用配置中的跳转代码
-
LibConfig 配置关于样式上的自定义
- 自定义的配置项，比如加载对话框，标题栏，页面加载图，加载失败图等。非必选的，不配置的话 会返回默认的实现。
[图片上传失败...(image-72f37a-1575336981955)]
篇幅有限，更详细的配置范例移步 详细配置范例 查看
界面基础
ui目录提供了 基础的 BaseActivity 和 BaseFragment 实现，各级界面 Base 类通过接口实现 约束，方便子类业务交互调用
-
BaseView - 简单的界面交互操作，如：
showToastshowProgress - BaseStateView - 界面状态切换（加载、异常、空数据等）
- TitleBar - 配合 LibCore.LibConfig 提供标题栏操作
- EventSubscriber - 事件订阅回调接口
[图片上传失败...(image-1528df-1575336981955)]
网络交互
RxHelper 依赖 Rxjava 提供了线程切换和结合基础界面接口 BaseView/BaseStateView 的交互和状态切换
(执行 Error consumer 均会触发 Logs 的异常日志收集上报)
// 显示 加载框，开始发起网络请求
showProgress();
addSubscribe(RetrofitHelper.getApis().login(email, password)
.compose(RxHelper.toMain())
.subscribe((respBean -> {
hideProgress();
// 失败，弹出异常文案
if (respBean.isCodeFail()) {
showToast(respBean.getMsg());
return;
}
// 发送事件，登录成功
RxBus.get().postEvent(Constant.Code.LOG_IN);
}, RxUtil.getHideProgressError(this));
其他核心类
- Logs 日志类，包括日志输出与日志收集
- RxBus 基于 RxJava 的事件总线
- PrefHelper 对 SharedPreferences 基本操作
- RxHelper 对 RxJava 一些方法调用封装
- Router 对 Activity 跳转和传参的封装
- UiHelper 界面相关操作的整合
- JsonHelper - 对 Json 的操作
篇幅有限，更多的类库使用范例移步 核心类库使用范例 查看
ChangeLog
v1.2.0
- 新增滴滴 DoKit
v1.1.0
- 新增 JsonHelper（弃用GsonUtil）
- 新增 DevHelper 提供应用内的开发者选项（方便调试）
- 修改 WebViewFragment 使用 X5 内核做网页的解析
网友评论