Compose笔记(八)--权限

        这一节主要了解一下Compose中权限的申请，其中主要用到accompanist-permissions这个权限库，它是一个简化的Android Compose 中权限管理的库，如下使用：

栗子:

依赖添加

dependencies {
    implementation("com.google.accompanist:accompanist-permissions:0.31.2-alpha")
}

单个权限

@OptIn(ExperimentalPermissionsApi::class)
@Composable
fun PermissionExample() {
    val permissionState = rememberPermissionState(
        permission = Manifest.permission.CAMERA
    )

    Scaffold(topBar = {
        TopAppBar(title = { Text("Permission Apply Test") })
    }) {
        Column(
            Modifier.fillMaxSize(),
            horizontalAlignment = Alignment.CenterHorizontally,
            verticalArrangement = Arrangement.Center
        ) {

            when (permissionState.status) {
                PermissionStatus.Granted -> {
                    Text("已经同意了相机权限")
                }
                is PermissionStatus.Denied -> {
                    Column {
                        val text = if (permissionState.status.shouldShowRationale) {
                            "相机权限已拒绝，点击按钮再次请求"
                        } else {
                            "相机权限已被禁止"
                        }
                        Text(text = text)
                        Button(onClick = {
                            permissionState.launchPermissionRequest()
                        }) {
                            Text("点击获取权限")
                        }
                    }
                }
            }
        }
    }
}

多个权限

清单文件:

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />



import android.Manifest
import android.content.pm.PackageManager
import androidx.activity.compose.rememberLauncherForActivityResult
import androidx.activity.result.contract.ActivityResultContracts
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.material.Button
import androidx.compose.material.Scaffold
import androidx.compose.material.Text
import androidx.compose.material.TopAppBar
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalContext
import androidx.core.app.ActivityCompat
import com.google.accompanist.permissions.ExperimentalPermissionsApi
import com.google.accompanist.permissions.PermissionStatus
import com.google.accompanist.permissions.rememberMultiplePermissionsState
import com.google.accompanist.permissions.rememberPermissionState
import com.google.accompanist.permissions.shouldShowRationale

@OptIn(ExperimentalPermissionsApi::class)
@Composable
fun MultiplePermissionsExample() {
    // 创建一个多权限状态对象，用于管理相机和存储权限
    val permissionsState = rememberMultiplePermissionsState(
        permissions = listOf(
            Manifest.permission.CAMERA,
            Manifest.permission.READ_EXTERNAL_STORAGE
        )
    )

    Column(
        modifier = Modifier.fillMaxSize(),
        verticalArrangement = Arrangement.Center,
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        val allPermissionsGranted = permissionsState.allPermissionsGranted
        val shouldShowRationale = permissionsState.shouldShowRationale

        if (allPermissionsGranted) {
            Text("所有权限已授予，可以使用相关功能。")
        } else {
            Column {
                if (shouldShowRationale) {
                    Text("为了正常使用应用功能，请授予以下权限：相机、存储。")
                }
                Button(onClick = { permissionsState.launchMultiplePermissionRequest() }) {
                    Text("请求权限")
                }
            }
        }
    }
}

注意:

1 依赖添加：确保在项目的 build.gradle（或 build.gradle.kts）文件中正确添加了 accompanist-permissions 库的依赖。同时，要注意使用与项目中其他 Compose 库版本兼容的 accompanist-permissions 版本，避免因版本不兼容导致编译错误或运行时异常。

2 注解使用：accompanist-permissions 库中的部分 API 被标记为 @ExperimentalPermissionsApi，这表示这些 API 还处于实验阶段，可能会在未来的版本中发生重大变化。在使用这些 API 时，需要在使用的函数或类上添加 @OptIn(ExperimentalPermissionsApi::class) 注解，以表明你已经了解并愿意承担使用实验性 API 的风险。

3 预先检查权限：在请求权限之前，应该先检查应用是否已经拥有该权限，避免不必要的权限请求对话框弹出，提升用户体验。可以使用 rememberPermissionState 或 rememberMultiplePermissionsState 返回的状态对象的相关属性进行检查。

原理

1. 基于 Android 系统的权限管理机制
Android 系统从 Android 6.0（API 级别 23）开始引入了运行时权限机制，应用需要在运行时请求某些危险权限。系统提供了一系列的 API 来处理权限请求，例如 ActivityCompat.requestPermissions 用于发起权限请求，ActivityCompat.checkSelfPermission 用于检查权限状态，ActivityCompat.shouldShowRequestPermissionRationale 用于判断是否需要向用户解释为什么需要该权限。

2 状态管理与响应式编程
Compose 是一种声明式的 UI 框架，它基于响应式编程模型，通过状态的变化来驱动 UI 的更新。accompanist-permissions 库利用了 Compose 的状态管理机制，将权限状态封装成可观察的状态对象，当权限状态发生变化时，自动触发 UI 的更新。

  2.1 rememberPermissionState 和 rememberMultiplePermissionsState这两个函数是 accompanist-permissions 库的核心，用于创建权限状态对象。
rememberPermissionState：用于管理单个权限的状态。它返回一个 PermissionState 对象，该对象包含了权限的当前状态信息，如 hasPermission（权限是否已授予）、shouldShowRationale（是否需要显示权限请求说明）等。这些状态信息会随着权限请求结果的变化而自动更新，从而触发 Compose UI 的重组。
rememberMultiplePermissionsState：用于管理多个权限的状态。它返回一个 MultiplePermissionsState 对象，该对象可以跟踪多个权限的授予情况，通过 allPermissionsGranted 判断所有权限是否都已授予，通过 shouldShowRationale 判断是否有任何权限需要显示请求说明。

3. 权限请求处理
accompanist-permissions 库封装了权限请求的逻辑，通过 launchPermissionRequest 和 launchMultiplePermissionRequest 方法来发起权限请求。
 3.1 内部实现
当调用 launchPermissionRequest 或 launchMultiplePermissionRequest 方法时，库会使用 Android 系统的 ActivityResultLauncher 来发起权限请求。ActivityResultLauncher 是 Android 系统提供的一种用于处理 Activity 结果的机制，它可以在请求权限后自动接收权限请求结果，并将结果传递给回调函数。

class PermissionStateImpl(
    private val permission: String,
    private val activity: ComponentActivity
) : PermissionState {
    private val _hasPermission = mutableStateOf(false)
    private val _shouldShowRationale = mutableStateOf(false)

    override val hasPermission: Boolean
        get() = _hasPermission.value

    override val shouldShowRationale: Boolean
        get() = _shouldShowRationale.value

    private val permissionLauncher = activity.registerForActivityResult(
        ActivityResultContracts.RequestPermission()
    ) { isGranted ->
        _hasPermission.value = isGranted
        _shouldShowRationale.value = activity.shouldShowRequestPermissionRationale(permission)
    }

    override fun launchPermissionRequest() {
        permissionLauncher.launch(permission)
    }
}

4. 状态更新与 UI 重组
        当权限请求结果返回时，accompanist-permissions 库会更新权限状态对象的状态信息。由于这些状态信息是使用 Compose 的 MutableState 封装的，当状态发生变化时，Compose 会自动检测到这些变化，并触发相关 UI 组件的重组，从而更新 UI 显示。例如，当用户授予相机权限后，cameraPermissionState.hasPermission 的值会从 false 变为 true，Compose 会重新执行 if (cameraPermissionState.hasPermission) 语句块，更新 UI 显示为 “相机权限已授予”。