揭秘 Activity Result API 的权限申请秘诀

2024-02-13 23:55:54

Activity Result API 的权限申请，原来如此简单

在这个移动互联网时代，智能手机俨然已成为我们形影不离的伙伴，承载着海量的数据和应用。随着应用的不断发展，权限申请也成为了一个至关重要的问题。试想一下，当一款应用在你安装后，张口就要获取你的相机、麦克风、甚至定位等权限时，你是何感受？

为了保障用户 privacy 和数据安全，Android 系统从 Android 6.0 开始引入了运行时权限机制，即应用在需要使用特定权限时，必须在运行时向用户申请并获得授权，才能正常使用该权限。这无疑增加了应用开发的复杂度，也对用户体验造成了不小的影响。

针对这些痛点，Google 在 Android 11 中隆重推出了 Activity Result API，旨在为开发者提供一种更加简便、高效的方式来申请权限。相较于传统的请求方式，ActivityResult API 拥有以下优势：

统一管理： ActivityResult API 提供了一个统一的接口，开发者可以轻松管理所有类型的权限请求，包括危险权限和正常权限。
无缝体验： ActivityResult API 采用了一种更加无缝的请求流程，最大程度减少了用户交互，从而改善了用户体验。
透明度更高： ActivityResult API 提供了更详细的权限申请信息，用户可以清楚地了解到应用请求权限的目的和用途。

那么，如何使用 ActivityResult API 来申请权限呢？下面就让我们一步步来探索：

1. 准备工作

在使用 ActivityResult API 之前，需要先在你的 Android 项目中添加 Gradle 依赖：

implementation "com.google.android.material:material:1.6.1"

2. 注册权限请求

使用 ActivityResult API 申请权限需要分两步：注册权限请求和启动权限请求。首先，我们需要在 onActivityResult() 方法中注册权限请求：

override fun onActivityResult(requestCode: Int, grantResults: IntArray) {
    when (requestCode) {
        REQUEST_CODE_CAMERA -> {
            // 根据 grantResults[0] 的值判断相机权限是否被授予
        }
        REQUEST_CODE_LOCATION -> {
            // 根据 grantResults[0] 的值判断定位权限是否被授予
        }
    }
}

其中，REQUEST_CODE_CAMERA 和 REQUEST_CODE_LOCATION 是自定义的请求码，用于区分不同的权限请求。

3. 启动权限请求

注册好权限请求后，就可以在需要的时候启动权限请求了：

ActivityResultContracts.RequestMultiplePermissions()
    .launch(REQUEST_CODE_CAMERA, REQUEST_CODE_LOCATION)

这行代码将同时启动相机和定位权限的请求。用户将看到一个权限请求对话框，可以根据自己的意愿选择授予或拒绝权限。

4. 获取权限结果

在用户做出选择后，onActivityResult() 方法将被调用，此时可以根据 grantResults 的值来判断权限是否被授予。

override fun onActivityResult(requestCode: Int, grantResults: IntArray) {
    when (requestCode) {
        REQUEST_CODE_CAMERA -> {
            if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                // 相机权限被授予
            } else {
                // 相机权限被拒绝
            }
        }
        REQUEST_CODE_LOCATION -> {
            if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                // 定位权限被授予
            } else {
                // 定位权限被拒绝
            }
        }
    }
}