Skip to content

Home

Jump to bottom
Peakmain edited this page Jun 19, 2023 · 8 revisions

BasicLibrary

功能介绍

  • Activity Results API实现权限封装
  • MMKV的封装
  • 防止多次事件的处理
  • Retrofit封装实现网络解耦
  • 线程的切换，View的抖动效果
  • LiveData实现事件分发总线

怎样使用

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' }
		}
	}

but If it is a new version of Android studio,Add it in your root setting.gradle at the end of repositories:

dependencyResolutionManagement {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Step 2. Add the dependency

	dependencies {
	        implementation 'com.github.Peakmain:BasicLibrary:+'
	}

功能列表

一、集成BaseActivity

class XXActivity(override val layoutId: Int = 自定义布局) :
    BaseActivity<T : ViewDataBinding, E : BaseViewModel>() {
    override fun initView() {
    
    }
}
  • T一般是Databinding布局实现自动生成的类
  • E需要继承于BaseViewModel，之后会自动实现initModel方法
class MainViewModel : BaseViewModel() {
    override fun initModel() {

    }
}
  • initModel在initView之前，setContentView之后实现的方法
  • 之后可在activity中直接使用mViewModel来获取E的实例，无需初始化
  • 也可通过getViewModel(modelClass: Class)获取ViewModel，并多次获取是同一个ViewModel实例 
 Log.e("TAG","测试${getViewModel(MainViewModel::class.java)}")
 Log.e("TAG","测试${getViewModel(MainViewModel::class.java)}")

二、集成BaseFragment

class XXFragment(override val layoutId: Int = 自定义布局) :
    BaseFragment<T : ViewDataBinding, E : BaseViewModel>() {
    override fun initView(fragmentView:View) {
    
    }
}
  • 其他性质和BaseActivity一样，不再阐述

三、MMKV的使用

  • 初始化 在Application中添加如下代码即可
	MMKV.initialize(BasicLibraryConfig.getInstance().getApp().getApplication())//参数是Context
  • 使用 保存数据
 PreferencesUtils.getInstance(this).saveParams(key,value)//👈🏻key: String, objects: Any

获取数据

 PreferencesUtils.getInstance(this).getParam(key,defalutParams)//👈🏻key: String, defaultObject: Any?

四、防止多次点击事件的处理

立即处理

        mBinding.tvTitle.click{
            //todo 事件处理
        }

延时处理

        //或者
        mBinding.tvTitle.clickViewDelay{
            //todo 事件处理
        }

TextView事件的拆分

        mBinding.tvTitle.clickClipListener( mBinding.tvTitle,leftClick = {
              //todo drawableLeft的点击事件
        }){
            //todo drawableRight的点击事件
        }

五、关于线程切换

切换到主线程

        mBinding.tvTitle.ktxRunOnUiThread { 
        
         }

延迟delayMills切换到主线程

        mBinding.tvTitle.ktxRunOnUiThreadDelay(delayMills) { 
        
        }

延迟加载,默认是500ms

        mBinding.tvTitle.wait { 
            
        }

延迟加载，设置延迟时间

        mBinding.tvTitle.wait(600) {

        }

延迟加载，设置延迟时间和单位

        mBinding.tvTitle.wait(600,TimeUnit.SECONDS) {

        }

六、View的抖动效果

View.shakeAnimation( fromXDelta: Float = 0f,
                     toXDelta: Float = 5f,
                     fromYDelta: Float = 0f,
                     toYDelta: Float = 0f,
                     duration: Long = 500)

七、网络库的使用

  • 推荐在ViewModel中进行初始化
  • 创建Service

1.service就是Retrofit请求网络层的Service接口

private var api: WanAndroidApi = RetrofitManager.createService(WanAndroidApi::class.java,"https://wanandroid.com/")

2.如果想用自己的封装方法实现Service，可以调用以下方法

    private var api: WanAndroidApi = RetrofitManager.createService(WanAndroidApi::class.java) {
        //todo 自己创建的Service
    }
  • 请求网络 第一种写法
        RetrofitManager.createData(api.getList(0,10), object : ApiStatus<ApiModel<ProjectBean>>() {
            override fun before() {
                //todo 调用请求网络前
            }

            override fun error(exception: Exception) {
               //todo 返回错误
            }

            override fun success(t: ApiModel<ProjectBean>) {
              //返回成功
            }


        })

第二种写法

        RetrofitManager.createData(api.projectTree, {
            //todo before()
        }, {
            //todo success(
        }, {
            //todo error()
        })

八、LiveData实现事件分发总线

  • 注册或获取实例
val rxBus = RxBus.instance.register<Int>("test")
  • 发送数据
 rxBus.setData(100)
  • 接受数据
val value=rxBus.value

九、RecycleView在Binding的使用

class TestAdapter(data: MutableList<String>, layoutManager: LinearLayoutManager) :
    CommonRecyclerDataBindingAdapter<String, RecyclerAdpterTestBinding>(
        data,//👈🏻数据源
        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
    }

}

十、获取协程的全局异常

       GlobalCoroutineExceptionHandler().coroutineExceptionCallback={ context, exception->
            //context:CoroutineContext
	    //exception:Throwable
        }

十一、BindingAdapter的使用

  • ①、设置view的visibility是View.VISIBLE还是View.Gone
	app:visibilityOrGone="@{!vm.isShow}"//true表示View.Visible,false则表示View.Gone
  • ②、设置view的visibility是View.VISIBLE还是View.InVisibile
	app:visibilityOrInVisible="@{vm.isShow}"//true表示View.Visible,false则表示View.InVisbile
  • ③、防止多次重复点击
	app:clickDelayTime="@{vm.delayTime}"//设置点击事件的延迟时间,参数为long类型
	app:click="@{vm.clickListener}"//设置点击事件的事件处理
  • ④、textView的drawableLeft和drawableRight的点击事件
	app:drawableLeftClick=""//drawableLeft的点击事件
	app:drawableRightClick=""//drawableRight的点击事件

十二、Activity Results API实现权限封装

是否授予权限
//判断单个权限
PkPermission.isGranted(android.Manifest.permission.CAMERA)
//判断多个权限
PkPermission.isGranted(
        arrayOf(
            android.Manifest.permission.ACCESS_FINE_LOCATION,
            android.Manifest.permission.ACCESS_COARSE_LOCATION,
            android.Manifest.permission.ACCESS_BACKGROUND_LOCATION
        )
    )
是否拒绝了权限，并且没有选择"Never ask again"
            if (PkPermission.shouldShowRequestPermissionRationale(fragment, arrayOf(permission))) {
                //拒绝了权限，但是没有选择"Never ask again"
                requestSinglePkPermission(fragment, permission)
            } else {
                //两种情况：1、从来没有申请过此权限 2、申请过权限并且选择"Never ask again"选项
                if (isFirstTimeAsking(arrayOf(permission))) {
                    ToastUtils.showLong("第一次申请权限")
                    firstTimeAsking(arrayOf(permission), false)
                    requestSinglePkPermission(fragment, permission)
                }else{
                    ToastUtils.showLong("权限之前被拒绝，并且用户选择不再提示")
                }
            }
申请单个权限
            PkPermission.request(this, android.Manifest.permission.CAMERA, object : OnPermissionCallback {
                override fun onGranted(permissions: Array<String>) {
                    Log.e("TAG", "授予了权限:$permission")
                }

                override fun onDenied(permissions: Array<String>, never: Boolean) {
                    Log.e("TAG", "是否永久:$never 拒绝了${permission}权限")
                }

            })
申请多个权限
PkPermission.request(this, location, object : OnPermissionCallback {
        override fun onGranted(permissions: Array<String>) {
            //权限被授予了
        }

        override fun onDenied(permissions: Array<String>, never: Boolean) {
            if (never) {
                //权限被永久拒绝了
            } else {
                //权限第一次被拒绝
            }
        }
    })
跳转app设置界面
PkPermission.toAppSetting(this@MainActivity)

关于我

Clone this wiki locally