EasyAndroid 是一个android完整的安装开发框架,已经应用于几个生产项目。
EasyAndroid 不是脱离其你原来熟悉的开发框架而另起一套,它只是将原来的流程极大地简化,所以他完全兼容其他开发框架。同时也会兼容Google后续的升级。需要的同学可以放心使用。
github地址:https://github.com/chen397254698/EasyAndroid
EasyAndroid
一个完整基于kotlin的安卓开发框架,采用了mvvm设计模式。涵盖了:
1、基于retrofit2封装的通过kotlin协程实现的网络框架
2、基于阿里开源arouter修改的api-router实现项目模块化
3、基于glide的图片加载缓存框架
4、基于room实现的往来数据缓存加载
5、基于step实现的数据异步提交
6、基于PreferenceHolder实现的本地数据快速存储
7、基于mlist实现的简单复杂列表的快速开发扩展等等。。
本框架几乎涵盖了开发所需的所有模块组件。简单fork之后就可以基于框架快速开发。
暂时先提交完整的框架代码,后续要完善本框架的用法。
框架说明:
1. 下载运行
- 下载项目
- 点击Sync Now 同步项目,下载对应的第三方库, 项目使用的gradle比较新,下载时间可能略长,要耐心等待
- 运行项目app
2. 简单页面创建
效果图对应代码
创建步骤
- 新建 SimpleFirstFragment 继承 BaseSimpleFragment
- 添加注解 @Launch
- 设置布局contentLayoutId 为自己创建的布局文件 例如 R.layout.fragment_1
- 实现 initAndObserve 初始化方法
在 initAndObserve 初始化方法 中可以设置toolbar样式 设置页面内容 设置点击事件等
页面跳转操作非常简单 startPage(SimpleSecondFragment::class) 其中 SimpleSecondFragment 就是对应页面的文件
,复杂跳转操作,带参数跳转等后面还将展开说明。
3. toolbar的灵活设置于扩展(支持线性布局,约束布局,帧布局,不再支持相对布局)
对于页面的顶部的toolbar 页面提供了一个非常灵活的ToolbarView,结合代码模板输入在fragment 中 too 即可一行搞定。对于复杂的toolbar也可以非常方便的扩展,无需修改布局内容。
//设置toolbar
toolbar.run {
//toolbar 标题
center("简单页面")
//toolbar 左侧返回图标
left(R.mipmap.ic_back) { activity?.finish() }
}
4. retrofit2+网络请求 (导入快捷模板代码 android studio-> File -> Import Setting -> 项目根目录下的setting.zip -> 导入模板代码)
定义接口,接口包含了请求方式@POST、suspend协程、请求URL、请求参数BaseRequest和结果返回BaseResponse
通过模板代码快速输入 req 完成网络请求
网络返回需要根绝实际返回字段名称进行映射, data 通过注解 @SerializedName("result") 可以映射接收 result的内容
status 200..289 表示成功回到success 300..399表示错误,默认会将网络返回的消息toast 400..499 表示网络异常 状态具体的对应需要根据实际接口进行调整,
可以新建一个Response自定义返回结果