[Android]实现一个权限申请类
导言
在引入了动态权限申请之后，Android的权限申请就变得尤为繁琐，若是按照原有的方法一板一眼地进行申请，样板代码未免太多。因此本篇文章就使用ActivityResult API，来实现一个简单的权限申请类来帮助我们简化权限申请的过程。
在此之前，你可能需要了解一些关于ActivityResult API相关的知识：使用Activity Result API 清爽地请求权限 和 启动Activity。
前置知识
在介绍正式的实现过程之前还是先简单介绍一下ActivityResult API，这是AndroidX中的内容，旨在解耦Activity的职责，避免Activity中出现的大量的集中的回调代码的出现。
该API有两个重要的概念：Launcher（启动器），Contract（契约）。其中，启动器是真正帮我们去执行操作（比如申请权限）的类，而契约类则规定了启动器的行为，比如说申请权限还是启动另一个Activity。但是在我们今天的这个主题下，只需要关注申请权限这一个行为就OK了，所以也无需太过关注契约类。
除此之外，还需要注意的一点是ActivityResult 的启动器 必须要在宿主的生命周期到达 CREATED 之前就创建完毕，所以我们在设计申请类的时候必须把这一点考虑进去。
具体实现
权限检查
首先我们从简单地做起，一个权限相关的工具类必备的就是权限的检查，这个我们用原有的方法就可以了，代码如下：
//检查权限fun checkPermission(context:Context,target:Array<String>):Boolean {for (permission in target) {val result = ContextCompat.checkSelfPermission(context,permission)if (result != PackageManager.PERMISSION_GRANTED) {return false}}return true}
核心设计
关于权限申请的权限的设计，由于有Launcher的存在，所以我们有存储Launcher的诉求，自然而然我们会想到用一张HashMap去存储。之后我们需要考虑的就是如何将权限，宿主。启动器这三者映射起来，所以可以用一张二维的HashMap去存储。具体结构是这样：一个宿主对应一张HashMap，该HashMap中一个权限对应一个Launcher，如下图所示：
我们用这么一个HashMap去存储对应的关系：
private val ownerMap = mutableMapOf<ComponentActivity,MutableMap<String,ActivityResultLauncher<String>>>()
注册启动器 & 注销注册器
有了上边所说的Map来存储映射关系之后，我们就需要填充这张Map了，具体来说就是注册启动器的过程，这个过程也十分简单，主要就是依次找对应项，如果对应项不存在的话就新创建一项进行填充：
//注册启动器fun registerLauncher(owner: ComponentActivity, permission:String, callback:ActivityResultCallback<Boolean> = Empty_Callback) {val launcher = owner.registerForActivityResult(ActivityResultContracts.RequestPermission(),callback)if (!ownerMap.containsKey(owner)) {ownerMap[owner] = mutableMapOf()}ownerMap[owner]!!.put(permission,launcher)//注册一个事件自动移除启动器owner.lifecycle.addObserver(object :LifecycleEventObserver{override fun onStateChanged(source: LifecycleOwner, event: Lifecycle.Event) {if (event == Lifecycle.Event.ON_DESTROY) {unRegisterLauncher(owner,permission)Log.d(TAG, "onStateChanged: Removed")}}})}
这里比较特殊的一点是为了防止内存泄漏的问题，若宿主的生命周期已经达到onDestroy则会自动将二次映射的数据项进行移除。注销注册器的代码如下所示：
//注销启动器fun unRegisterLauncher(context: Context,permission: String) {if (ownerMap.containsKey(context) && ownerMap[context]!!.containsKey(permission)) {ownerMap[context]!!.remove(permission)}}
完整代码
最后，给出完整的代码，如下所示：
object PermissionUtil {//若不需要回调，使用此空实现public val Empty_Callback = object :ActivityResultCallback<Boolean> {override fun onActivityResult(result: Boolean) {}}private const val TAG = "PermissionUtil"private val ownerMap = mutableMapOf<ComponentActivity,MutableMap<String,ActivityResultLauncher<String>>>()//注册启动器fun registerLauncher(owner: ComponentActivity, permission:String, callback:ActivityResultCallback<Boolean> = Empty_Callback) {val launcher = owner.registerForActivityResult(ActivityResultContracts.RequestPermission(),callback)if (!ownerMap.containsKey(owner)) {ownerMap[owner] = mutableMapOf()}ownerMap[owner]!!.put(permission,launcher)//注册一个事件自动移除启动器owner.lifecycle.addObserver(object :LifecycleEventObserver{override fun onStateChanged(source: LifecycleOwner, event: Lifecycle.Event) {if (event == Lifecycle.Event.ON_DESTROY) {unRegisterLauncher(owner,permission)Log.d(TAG, "onStateChanged: Removed")}}})}//申请权限fun requestPermission(context: Context,permission: String):Boolean {val launcher = ownerMap[context]?.get(permission)if (launcher == null) {Log.e(TAG, "Launcher 未注册！")return false} else {launcher.launch(permission)Log.d(TAG, "requestPermission: 请求ing")return (checkPermission(context, arrayOf(permission)))}}//检查权限fun checkPermission(context:Context,target:Array<String>):Boolean {for (permission in target) {val result = ContextCompat.checkSelfPermission(context,permission)if (result != PackageManager.PERMISSION_GRANTED) {return false}}return true}//注销启动器fun unRegisterLauncher(context: Context,permission: String) {if (ownerMap.containsKey(context) && ownerMap[context]!!.containsKey(permission)) {ownerMap[context]!!.remove(permission)}}}
Update｜更新
使用示例
class MainActivity : AppCompatActivity() {val viewBinding by lazy {ActivityMainBinding.inflate(layoutInflater)}init {//申请权限注册PermissionUtil.registerLauncher(this,Manifest.permission.READ_EXTERNAL_STORAGE)}......
}
2024.1.18
为了优化权限申请的流程，直接将启动器申请权限的部分通过Lifecycle注入到了宿主的生命周期中，这样在注册完启动器之后就无需再手动调用方法申请权限，更新后的完整代码：
object PermissionUtil {//若不需要回调，使用此空实现public val Empty_Callback = object :ActivityResultCallback<Boolean> {override fun onActivityResult(result: Boolean) {}}private const val TAG = "PermissionUtil"private val ownerMap = mutableMapOf<ComponentActivity,MutableMap<String,ActivityResultLauncher<String>>>()//注册启动器fun registerLauncher(owner: ComponentActivity, permission:String, callback:ActivityResultCallback<Boolean> = Empty_Callback) {val launcher = owner.registerForActivityResult(ActivityResultContracts.RequestPermission(),callback)if (!ownerMap.containsKey(owner)) {ownerMap[owner] = mutableMapOf()}ownerMap[owner]!!.put(permission,launcher)owner.lifecycle.addObserver(object :LifecycleEventObserver{override fun onStateChanged(source: LifecycleOwner, event: Lifecycle.Event) {//自动为宿主注入申请权限的操作if (event == Lifecycle.Event.ON_CREATE) {PermissionUtil.requestPermission(owner,permission)}//注册一个事件自动移除启动器if (event == Lifecycle.Event.ON_DESTROY) {unRegisterLauncher(owner,permission)Log.d(TAG, "onStateChanged: Removed")}}})}//申请权限fun requestPermission(context: Context,permission: String):Boolean {val launcher = ownerMap[context]?.get(permission)if (launcher == null) {Log.e(TAG, "Launcher 未注册！")return false} else {launcher.launch(permission)Log.d(TAG, "requestPermission: 请求ing")return (checkPermission(context, arrayOf(permission)))}}//检查权限fun checkPermission(context:Context,target:Array<String>):Boolean {for (permission in target) {val result = ContextCompat.checkSelfPermission(context,permission)if (result != PackageManager.PERMISSION_GRANTED) {return false}}return true}//注销启动器fun unRegisterLauncher(context: Context,permission: String) {if (ownerMap.containsKey(context) && ownerMap[context]!!.containsKey(permission)) {ownerMap[context]!!.remove(permission)}}}
