Android 权限申请现代化指南
Android 权限申请现代化指南
一、核心概念：权限分类
Android 将权限分为三大类，申请方式各不相同：
- 普通权限 (Normal Permissions)
· 范围：涉及应用沙盒外部但对用户隐私或设备操作风险极低的操作。
· 示例：网络访问 (INTERNET)、振动 (VIBRATE)、设置壁纸 (SET_WALLPAPER)。
· 授权方式：在 AndroidManifest.xml 中声明后，系统在安装时自动授予。 - 危险权限 (Dangerous Permissions)
· 范围：涉及用户隐私或设备敏感数据的操作。
· 示例：相机 (CAMERA)、精确位置 (ACCESS_FINE_LOCATION)、联系人 (READ_CONTACTS)、麦克风 (RECORD_AUDIO)。
· 授权方式：必须在运行时明确向用户请求。这是本指南的重点。 - 特殊权限 (Special Permissions)
· 范围：拥有系统级影响的极高特权权限。
· 示例：在其他应用上方绘制 (SYSTEM_ALERT_WINDOW)、修改系统设置 (WRITE_SETTINGS)。
· 授权方式：通常需要引导用户至系统特定页面进行授权，不通过标准 API 请求。
二、现代化实现方式
Google 推荐使用 Activity Result API 配合 ActivityResultContracts 来请求权限。这种方式取代了传统的重写 onRequestPermissionsResult() 的方法，具有以下优势：
· 生命周期安全：自动管理生命周期，避免内存泄漏。
· 代码清晰：请求逻辑和结果处理集中在一起，易于维护。
· 无需请求码：避免了手动管理 requestCode 的繁琐和错误。
- 声明权限
在 AndroidManifest.xml 中声明所有需要的权限，这是任何方式的前提。
<manifest xmlns:android="http://schemas.android.com/apk/res/android"><uses-permission android:name="android.permission.CAMERA" /><uses-permission android:name="android.permission.RECORD_AUDIO" /><!-- 其他权限 --><application ...> ... </application>
</manifest>
- 请求单个权限（以相机权限为例）
在 Activity 或 Fragment 中：
class MainActivity : AppCompatActivity() {// 1. 注册权限请求启动器（Launcher）private val requestPermissionLauncher = registerForActivityResult(ActivityResultContracts.RequestPermission() // 使用请求单个权限的合约) { isGranted: Boolean ->// 权限请求结果的回调handlePermissionResult(isGranted)}override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)val button = findViewById<Button>(R.id.btn_request)button.setOnClickListener {checkCameraPermission()}}private fun checkCameraPermission() {// 2. 检查权限是否已授予when {ContextCompat.checkSelfPermission(this,Manifest.permission.CAMERA) == PackageManager.PERMISSION_GRANTED -> {// 已有权限，执行操作openCamera()}// 3. 判断是否需要向用户解释原因shouldShowRequestPermissionRationale(Manifest.permission.CAMERA) -> {showPermissionRationaleDialog()}else -> {// 直接发起请求（首次或用户未选择"不再询问"）requestPermissionLauncher.launch(Manifest.permission.CAMERA)}}}private fun handlePermissionResult(isGranted: Boolean) {if (isGranted) {openCamera()} else {// 处理拒绝逻辑，特别是“不再询问”的情况showGoToSettingsDialog()}}private fun openCamera() {Toast.makeText(this, "Camera opened!", Toast.LENGTH_SHORT).show()}private fun showPermissionRationaleDialog() {AlertDialog.Builder(this).setTitle("Need Permission").setMessage("This app needs camera access to take pictures.").setPositiveButton("OK") { _, _ ->// 用户理解后，再次发起请求requestPermissionLauncher.launch(Manifest.permission.CAMERA)}.setNegativeButton("Cancel", null).show()}private fun showGoToSettingsDialog() {AlertDialog.Builder(this).setTitle("Permission Denied").setMessage("You have permanently denied this permission. Please enable it in app settings.").setPositiveButton("Open Settings") { _, _ ->// 跳转到本应用的系统设置页val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {data = Uri.fromParts("package", packageName, null)}startActivity(intent)}.setNegativeButton("Cancel", null).show()}
}
- 请求多个权限（同时请求相机和麦克风）
使用 RequestMultiplePermissions Contract。
class MainActivity : AppCompatActivity() {// 1. 注册多权限请求启动器private val requestMultiplePermissionsLauncher = registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { permissions: Map<String, Boolean> -> // 结果是一个映射表// 检查所有权限是否都被授予val allGranted = permissions.all { it.value }if (allGranted) {setupAppWithAllPermissions()} else {// 处理未全部授予的情况showSomePermissionsDenied()}}private fun requestMultiplePermissions() {// 2. 定义权限数组val permissionsToRequest = arrayOf(Manifest.permission.CAMERA,Manifest.permission.RECORD_AUDIO)// 3. 发起请求requestMultiplePermissionsLauncher.launch(permissionsToRequest)}private fun setupAppWithAllPermissions() {Toast.makeText(this, "All permissions granted!", Toast.LENGTH_SHORT).show()}// ... 其他方法
}
三、最佳实践与关键提示
- 按需请求：在用户即将使用需要权限的功能时才请求权限，而不是一进入应用就请求所有权限。
- 善用解释 (shouldShowRequestPermissionRationale)：
· 此方法返回 true：用户之前拒绝过权限，你应该弹窗解释为什么需要它。
· 返回 false：可能是第一次请求，或者用户已选择“不再询问”。 - 妥善处理“不再询问”：当用户勾选“不再询问”并拒绝后，再次调用 launch() 会直接拒绝。此时应引导用户前往系统设置手动开启权限。
- 测试所有路径：务必测试用户允许、拒绝、拒绝并不再询问等多种场景，确保应用行为正确。
通过遵循这套现代化方案，你的应用可以以一种用户友好、稳定且易于维护的方式处理Android运行时权限。