BasicLibrary
- BasicLibrary是基于kotlin+jetpack+mvvm封裝的一套框架,提高Android開發(fā)效率
- 集成了自己封裝的BasicUI庫(kù),關(guān)于BasicUI大家可以看我之前寫的文章BasicUI常用UI組件和實(shí)用工具類封裝,提高Android開發(fā)的效率
還包括:
- MMKV的封裝
- 防止多次點(diǎn)擊事件的處理
- Retrofit封裝實(shí)現(xiàn)網(wǎng)絡(luò)解耦
- 線程的切換,View的抖動(dòng)效果
- LiveData實(shí)現(xiàn)事件分發(fā)總線
- 項(xiàng)目地址:https://github.com/Peakmain/BasicLibrary
怎樣使用
Step 1. Add the JitPack repository to your build file
Add it in your root build.gradle at the end of repositories:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Step 2. Add the dependency
dependencies {
implementation 'com.github.Peakmain:BasicLibrary:1.0.2'
}
功能列表
1、集成BaseActivity
class XXActivity(override val layoutId: Int = 自定義布局) :
BaseActivity<T : ViewDataBinding, E : BaseViewModel>() {
override fun initView() {
}
}
- T一般是Databinding布局實(shí)現(xiàn)自動(dòng)生成的類
- E需要繼承于BaseViewModel,之后會(huì)自動(dòng)實(shí)現(xiàn)initModel方法
class MainViewModel : BaseViewModel() {
override fun initModel() {
}
}
- initModel在initView之前,setContentView之后實(shí)現(xiàn)的方法
- 之后可在activity中直接使用mViewModel來(lái)獲取E的實(shí)例,無(wú)需初始化
- 也可通過(guò)getViewModel(modelClass: Class<E>)獲取ViewModel,并多次獲取是同一個(gè)ViewModel實(shí)例
Log.e("TAG","測(cè)試${getViewModel(MainViewModel::class.java)}")
Log.e("TAG","測(cè)試${getViewModel(MainViewModel::class.java)}")
2、集成BaseFragment
class XXFragment(override val layoutId: Int = 自定義布局) :
BaseFragment<T : ViewDataBinding, E : BaseViewModel>() {
override fun initView(fragmentView:View) {
}
}
- 其他性質(zhì)和BaseActivity一樣,不再闡述
3、MMKV的使用
- 初始化
在Application中添加如下代碼即可
try {
TaskDispatcher dispatcher = BasicLibraryConfig.Companion.getInstance().getApp().getDispatcher();
dispatcher.start();
} catch (Exception e) {
e.printStackTrace();
}
- 使用
保存數(shù)據(jù)
PreferencesUtils.getInstance(this).saveParams(key,value)//????key: String, objects: Any
獲取數(shù)據(jù)
PreferencesUtils.getInstance(this).getParam(key,defalutParams)//????key: String, defaultObject: Any?
- 關(guān)于啟動(dòng)優(yōu)化——啟動(dòng)器TaskDispatcher大家可以看我之前關(guān)于BasicUI的wiki:有向無(wú)環(huán)圖實(shí)現(xiàn)啟動(dòng)器優(yōu)化
4、防止多次點(diǎn)擊事件的處理
立即處理
mBinding.tvTitle.click{
//todo 事件處理
}
延時(shí)處理
//或者
mBinding.tvTitle.clickViewDelay{
//todo 事件處理
}
TextView事件的拆分
mBinding.tvTitle.clickClipListener( mBinding.tvTitle,leftClick = {
//todo drawableLeft的點(diǎn)擊事件
}){
//todo drawableRight的點(diǎn)擊事件
}
5、關(guān)于線程切換
切換到主線程
mBinding.tvTitle.ktxRunOnUiThread {
}
延遲delayMills切換到主線程
mBinding.tvTitle.ktxRunOnUiThreadDelay(delayMills) {
}
延遲加載,默認(rèn)是500ms
mBinding.tvTitle.wait {
}
延遲加載,設(shè)置延遲時(shí)間
mBinding.tvTitle.wait(600) {
}
延遲加載,設(shè)置延遲時(shí)間和單位
mBinding.tvTitle.wait(600,TimeUnit.SECONDS) {
}
5、View的抖動(dòng)效果
View.shakeAnimation( fromXDelta: Float = 0f,
toXDelta: Float = 5f,
fromYDelta: Float = 0f,
toYDelta: Float = 0f,
duration: Long = 500)
6、網(wǎng)絡(luò)庫(kù)的使用
- 推薦在ViewModel中進(jìn)行初始化
- 創(chuàng)建Service
1.service就是Retrofit請(qǐng)求網(wǎng)絡(luò)層的Service接口
private var api: WanAndroidApi = RetrofitManager.createService(WanAndroidApi::class.java,"https://wanandroid.com/")
2.如果想用自己的封裝方法實(shí)現(xiàn)Service,可以調(diào)用以下方法
private var api: WanAndroidApi = RetrofitManager.createService(WanAndroidApi::class.java) {
//todo 自己創(chuàng)建的Service
}
- 請(qǐng)求網(wǎng)絡(luò)
第一種寫法
RetrofitManager.createData(api.getList(0,10), object : ApiStatus<ApiModel<ProjectBean>>() {
override fun before() {
//todo 調(diào)用請(qǐng)求網(wǎng)絡(luò)前
}
override fun error(exception: Exception) {
//todo 返回錯(cuò)誤
}
override fun success(t: ApiModel<ProjectBean>) {
//返回成功
}
})
第二種寫法
RetrofitManager.createData(api.projectTree, {
//todo before()
}, {
//todo success(
}, {
//todo error()
})
7、LiveData實(shí)現(xiàn)事件分發(fā)總線
- 注冊(cè)或獲取實(shí)例
val rxBus = RxBus.instance.register<Int>("test")
- 發(fā)送數(shù)據(jù)
rxBus.setData(100)
- 接受數(shù)據(jù)
val value=rxBus.value
8、CommonRecyclerDataBindingAdapter RecycleView在Binding的使用
class TestAdapter(data: MutableList<String>, layoutManager: LinearLayoutManager) :
CommonRecyclerDataBindingAdapter<String, RecyclerAdpterTestBinding>(
data,//????數(shù)據(jù)源
R.layout.recycler_adpter_test,//??自定義布局
DefaultAdapterFooterConfig<String,RecyclerAdpterTestBinding>(layoutManager).item//??是否顯示加載更多,如果為null,則不顯示加載更多,可自定義,可參考DefaultAdapterFooterConfig的源碼
) {
override fun convert(
holder: BaseLibraryViewHolder<RecyclerAdpterTestBinding>,
itemData: String,
position: Int
) {
val binding = holder.itemDataBinding
binding.vm = itemData
}
}
9、獲取協(xié)程的全局異常
GlobalCoroutineExceptionHandler().coroutineExceptionCallback={ context, exception->
//context:CoroutineContext
//exception:Throwable
}
10、BindingAdapter的使用
- ①、文本添加*前綴
app:asteriskPrevText=""http://文本的名字
app:asteriskColor=""http://星號(hào)的顏色
- ②、設(shè)置image的url圖片
app:loadUrl=""http://參數(shù)url
- ③、設(shè)置view的visibility是View.VISIBLE還是View.Gone
app:visibilityOrGone="@{!vm.isShow}"http://true表示View.Visible,false則表示View.Gone
- ④、設(shè)置view的visibility是View.VISIBLE還是View.InVisibile
app:visibilityOrInVisible="@{vm.isShow}"http://true表示View.Visible,false則表示View.InVisbile
- ⑤、防止多次重復(fù)點(diǎn)擊
app:clickDelayTime="@{vm.delayTime}"http://設(shè)置點(diǎn)擊事件的延遲時(shí)間,參數(shù)為long類型
app:click="@{vm.clickListener}"http://設(shè)置點(diǎn)擊事件的事件處理
- ⑥、textView的drawableLeft和drawableRight的點(diǎn)擊事件
app:drawableLeftClick=""http://drawableLeft的點(diǎn)擊事件
app:drawableRightClick=""http://drawableRight的點(diǎn)擊事件
關(guān)于我
- 簡(jiǎn)書(http://m.itdecent.cn/u/3ff32f5aea98)
- 我的GitHub地址(https://github.com/Peakmain)