在平时的开发过程中,我们经常会需要使用到一些基础功能组件,比如Toast,比如Log等。
而这些功能组件,在开发时需要使用到的功能点其实相当有限,所以这也意味着,我们对此类组件的要求是:简单、轻量、易用!相对应的,此类组件的封装库,也应该尽量实现得轻巧精练
EasyAndroid即是专门针对此种需求所设计的一款基础组件集成库:
组件间独立存在,不相互依赖,若只需要集成库中的部分功能,可直接非常方便的copy源码进行使用。
因为是组件集成库,所以要求每个组件的设计尽量精练、轻巧。避免因为一个小功能而引入大量无用代码
- 添加jitpack仓库依赖
maven { url 'https://jitpack.io' }
- 添加依赖
implementation "com.github.yjfnypeu:EasyAndroid:$lastest_version"
- 初始化
在Application中调用初识化方法:
EasyAndroid.init(application)
然后即可直接使用
目前版本已集成以下部分组件库:
用于灵活的进行设备尺寸单位转换
支持全尺寸数值转换。
用法示例
// 转换10dp到px
EasyDimension.withDIP(10).toPX()
// 转换30sp到MM
EasyDimension.withSP(30).toMM()
用于对任意类型数据,进行格式化输出排版,结合log打印组件使用,使log输出展示更清晰
- 支持对
Set/List/Map/JSON/POJO数据进行格式化排版 - 支持最高长度过滤:避免打印超长数据时造成版面浪费
用法示例:
// 创建待格式化数据
val any:Any = create()
// 使用formatter实例进行格式化
val result:String = EasyFormatter.DEFAULT.format(any)
// 或者使用扩展函数。直接格式化
val result2:String = any.easyFormat()
用于简单的进行日志打印输出,支持格式化输出、自定义打印格式。
- 不阻塞:打印任务运行于独立线程中,避免大量打印数据时造成UI阻塞。
- 安全: 对打印任务做好了异常处理。不用担心出现crash问题
- 使用EasyFormatter对任意数据进行格式化排版
- 支持添加自定义规则
- 灵活、直观的进行输出样式定制
- 自动适配TAG. 也可手动指定。
- 使用开关。关闭线上包的日志输出。
- 使用'上边界'逻辑进行栈帧匹配,支持二次封装使用
用法示例:
val any:Any = create()// 创建待打印数据
EasyLog.DEFAULT.d(any)// 使用默认log实例进行数据打印. 以Log.d()的方式进行输出
any.easyLogE()// 使用扩展函数直接进行数据打印,以Log.e()的方式进行输出
用于进行Toast提示,可很简单的指定输出样式。
- 支持在任意线程下进行toast提示
- 非常方便的进行任意样式的定制
- 不管当前是否正在展示之前的数据。有新消息通知时,直接展示新消息,无需等待
用法示例:
val message:String = create()// 创建待提示数据
EasyToast.DEFAULT.show(message)// 使用系统样式进行输出
EasyToast.create(layoutID:Int, tvID:Int, duration:Int).show(message)// 使用自定义样式进行输出
对常规的反射操作进行封装。达到更便于使用反射的效果
用法示例:
// 以类名Test为例
class Test private constructor(private val name:String) {
private fun wrap(name:String):String = "包裹后的数据$name"
}
// 创建Reflect实例:
var reflect = EasyReflect.create(Test::class.java).instance("默认参数")
// 为name字段赋值:
reflect.setField("name", "EasyReflect")
// 读取name字段的值:"EasyReflect"
val value = reflect.getValue("name")
// 调用方法wrap方法,并传入参数value
reflect.call("wrap", value)
// 调用wrap方法,并获取返回值: "包裹后的数据EasyReflect"
val result = reflect.callWithReturn("wrap", value).get<String>()
用于解决onActivityResult业务逻辑臃肿的问题
- 业务解耦分离: 各自启动业务线处理各自的回调逻辑
- 去除requestCode: 进行启动时自动生成随机的requestCode, 不用再为每个启动任务分别配置请求码了。
- 防暴击: 防止快速点击时启动多个重复页面
用法示例:
EasyActivityResult.startActivity(activity, Intent(activity, DemoActivity::class.java),
{ resultCode:Int, data:Intent? ->
// 直接在此进行返回数据处理
})
提供的一种简单的MVP分层架构实现。
- 支持单页面绑定多个Presenter进行使用
- 支持P层进行生命周期派发
提供的一些其他零散的类库APIs
或者手动加入QQ群: 108895031