众所周知,在Android中如果我们想要实现动态权限获取,只需要调用ActivityCompat.requestPermissions(activity/fragment,permissions,requestCode)
,然后在activity/fragment
中重写onRequestPermissionsResult
来响应请求结果即可,当然我们也可以通过RxPermissions
、easypermissions
等第三方库实现,简单而便捷。
可如今却有一个小问题,就是在新的API中,onRequestPermissionsResult
已被弃用,取而代之的是Activity Result API
,但大多数第三方库仍然使用旧的解决方案。
因此,假设你想要不使用已被弃用的onRequestPermissionsResult
,大概率就只能自己通过Activity Result API
实现了,经过实践,我发现如果项目中全部使用Activity Result API
代替原有方法,会存在大量样板代码,而且registerForActivityResult
要求必须在fragment
或activity
的Lifecycle
达到CREATED
之前创建,所以也无法进行按需加载,于是便做了一个开源Library项目,方便大家集成后,一行代码实现基于Activity Result API的动态权限获取。
1.实现思路:
相对比原来的onRequestPermissionsResult
,Activity Result API
使用起来更加的便捷友好,我们只需要简单的封装和实现权限理由相关的逻辑,即可方便的调用。
唯一的难度在于:根据https://developer.android.com/training/basics/intents/result?hl=zh-cn,registerForActivityResult
要求必须在fragment
或activity
的Lifecycle
达到CREATED
之前创建,这意味着我们无法进行按需加载,而且每次都要创建实例,无法通过静态方法进行一键调用。
经过研究,这里我们通过创建一个专用的fragment
来解决上述的问题:
在调用动态权限获取的时候,我们创建一个空布局的fragment
,并在这个fragment
的onCreate中进行registerForActivityResult
,从而满足创建条件并实现按需加载;另外为了提高效率,我们也做了实例池避免这个专用fragment
的重复创建问题,并实现了自动的生命周期管理。
2.集成方式:
allprojects {
repositories {
...
maven { url 'https://www.jitpack.io' }
}
}
// 注意:本Library基于androidx
implementation 'com.gitee.arcns.arc-fast:permission:1.12.0'
3.使用方式:
- 简单获取权限
FastPermissionUtil.request(
activity, // or fragment
Manifest.permission.CAMERA,
Manifest.permission.READ_EXTERNAL_STORAGE,
...
) { allGranted: Boolean, result: Map ->
// allGranted:是否全部权限获取成功
// result:各个权限的获取结果,key为permission,value为获取结果(Granted:同意;Denied:拒绝;DeniedAndDonTAskAgain:拒绝且不再询问)
if (allGranted) {
// 全部权限获取成功
}
}
- 获取权限,并在必要时弹出权限解释说明
FastPermissionUtil.request(
fragment = this,
FastPermissionRequest(Manifest.permission.CAMERA,"应用需要相机权限用于扫描"),
FastPermissionRequest(Manifest.permission.READ_EXTERNAL_STORAGE,"应用需要储存权限用于选择扫描图片"),
) { allGranted, result ->
if (allGranted) {
// 全部权限获取成功
}
}
- 使用自定义的弹出权限解释说明弹窗
FastPermissionUtil.showAlertDialog = {activity,message,positiveButton,onPositiveButton,negativeButton,onNegativeButton ->
// 弹出自定义弹窗
MyAlertDialogBuilder(activity)
.setMessage(message)
.setNegativeButton(negativeButton) { _, _ -> onNegativeButton.invoke() }
.setPositiveButton(positiveButton) { _, _ -> onPositiveButton.invoke() }
.show()
}
项目地址:
https://github.com/Arcns/arc-fast
https://gitee.com/arcns/arc-fast
作者:
Arcns