用途
快速搭建Mvvm架构的安卓(Android)项目
说明
基于jetpack包下的 lifecycle+room+ktcoroutines搭建
如下是内部集成的库
// 考虑到使用门槛，已注销，此库按需自己引入，
// 协程(它的Flow用来替换Rxjava，轻量而又强大)
# api "org.jetbrains.kotlinx:kotlinx-coroutines-android:xxx"
// Android兼容库
api 'androidx.multidex:multidex:xxx' // 解决最大方法数问题
api "androidx.startup:startup-runtime:xxx" // 负责App启动需做的初始化工作，方便使用者扩展无需继承RootApp
api 'androidx.appcompat:appcompat:xxx' // 官方兼容库，原生的已基本没人用，所以这里当然要引入了
api 'androidx.constraintlayout:constraintlayout:xxx' // 约束布局，考虑到官方极力推荐，AS相关布局都做了很多努力，也引入吧
api 'androidx.recyclerview:recyclerview:xxx' // 官方推荐的大多数的ListView和GridView的使用场景替代方案
api 'androidx.cardview:cardview:xxx' // 圆角矩形卡片UI，现在挺常见的场景，一并引入吧
// 下拉刷新，上拉加载
api 'com.scwang.smartrefresh:SmartRefreshLayout:xxx'
// recycler adapter 快速搭建
api 'com.github.CymChad:BaseRecyclerViewAdapterHelper:xxx'
// Android动态权限
api "org.permissionsdispatcher:permissionsdispatcher:xxx"
// ======如下是由原来的强引入改为按需自己引入方式
// 为了解耦已注销，按需自己引入：jetpack生命周期管理及数据库
# api 'androidx.lifecycle:lifecycle-extensions:xxx' 注意：此种扩展方式官方已过时，需要的自己查官方文档
# api 'androidx.room:room-runtime:xxx'
// ARouter路由解耦 和 Dagger 按需引用
// 说明：为了解耦，此库已注销引入，按需自己引入
# api 'com.alibaba:arouter-api:xxx' // 极力推荐要会用的一个库，不会的同学快去了解下
扩展库(按需导入)
网络请求
URL：https://jitpack.io/#Dazhi528/RootHttp
源码：https://github.com/Dazhi528/RootHttp
导入：implementation 'com.github.Dazhi528:RootHttp:Tag'
作用：基于kotlin协程和流(coroutines+flow+okhttp+Retrofit)封装的替代之前的RxJava网络请求方案
EventBus
URL：https://jitpack.io/#Dazhi528/RootBus
源码：https://github.com/Dazhi528/RootBus
导入：implementation 'com.github.Dazhi528:RootBus:Tag'
作用：LiveData实现的轻量级事件总线，支持粘性事件
一维码二维码扫描
URL：https://jitpack.io/#Dazhi528/ZxingScan
源码：https://github.com/Dazhi528/ZxingScan
导入：implementation 'com.github.Dazhi528:ZxingScan:Tag'
作用：扫描识别一维码或二维码
图片选择库
URL：https://jitpack.io/#Dazhi528/PictureSelector
源码：https://github.com/Dazhi528/PictureSelector
导入：implementation 'com.github.Dazhi528:PictureSelector:Tag'
作用：从相册选择图片或拍照选择图片，用于上传
常用视图库
URL：https://jitpack.io/#Dazhi528/RootView
源码：https://github.com/Dazhi528/RootView
导入：implementation 'com.github.Dazhi528:RootView:Tag'
作用：常用的自定义view
- 带删除内容的EditText: ViewClearEditText
- 带图片的TextView：ViewDrawableText
- 带图片的EditText：ViewDrawableEdit
- 带图片的Button：ViewDrawableButton
- 带图片的RadioButton：ViewDrawableRadioBt
Gradle
Step 1. Add the JitPack repository to your build file
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Step 2. Add the dependency
dependencies {
implementation 'com.github.Dazhi528:MvvmAndroidFrame:Tag'
}
考虑到挺火的第三方库blankj:utilcode不能部分引入，冗余太多，这里封装了几个常用工具类
RtCmn：常用方法类
RtSp：偏好存储类（copy第三方工具库：blankj:utilcode）
RtLog：统一管理日志
RtFile: 文件相关工具类（copy第三方工具库：blankj:utilcode）
RtStack：管理Acitvity堆栈
RtStatusBar：状态条控制类（沉浸式、状态条颜色修改等）
RtConfig:生命周期扩展引擎加载配置类
RtCode：常用加密及编码工具方法
RtCatch：全局捕获异常，防止崩溃，可处理重启等操作
RtView：封装点击防抖动方法(全局方法，可直接使用，见实例)
LinkedMap：按插入顺序排序，支持键值索引、移除和顺序迭代
美工喜欢用720*1280开发安卓，在这个分辨率下，2px=1dp
我们开发就根据美工给的这个原型图像素除以2就可以了，尺寸都
放到values/dimens.xml下，开发完成copy项目的main目录下的
screenMatchDP.jar文件到你项目的对应位置，然后在终端执行
第一个必须是360，即标准的720 X 1280，后面的是插件没生成，自己需要的
如下命令：
java -jar screenMatchDP.jar 360 120 160 240 320
美工开发IOS用iPhone6为标准； 屏幕宽度为375px，共有750个物理像素
二次封装的第三方permissionsdispatcher库，使用此库的框架，已集成动态权限，
需要申请什么权限直接调用permissionXXX()方法，例：permissionDhCcXj()，
详情跳入源码看已有权限
类似友盟统计等的一些库，需要写入BaseAcitvity生命周期方法中时，我们提供了
InteRootEngineLifecycle引擎加载接口，只有实现此接口，然后App类里调用
UtConfig.self().initEngineLifecycle(你的引擎)即可，实例中有加载实例
二次封装的第三方SmartRefreshLayout库
引入了第三方BaseRecyclerViewAdapterHelper库，可直接用
DecorationSpaceGridLinear
RootAdapter
- V 1.0.5 日期：20-11-30
- 官方viewBinding方案替换过时的kotlin-android-extensions方案
// 注释掉：apply plugin: 'kotlin-android-extensions'
// 添加如下：
android {
...
buildFeatures {
viewBinding = true
}
}
- V 1.1.3 日期：21-01-28
- 删除工具类 RtThread：防止小白线程池滥用，按需自定义
- 去除协程包引入，按需引入(有门槛，很多人都不会用到)
- 引入LinkedMap(链表哈希)数据结构；场景：按插入顺序排序，支持键值索引、移除和顺序迭代