原生移动开发 / 系统课时

完成一次运行时权限申请

完成一次运行时权限申请

这一课把一次完整的运行时权限请求落到代码:进入功能时检查权限,必要时展示说明并发起系统请求,再根据结果继续或降级。重点不是“把弹窗调出来”,而是让授权流程在重复点击、拒绝和页面重建时仍然可控。

学习目标

  • 使用 AndroidX Activity Result API 完成一次运行时权限申请
  • 正确处理已授权、需要说明、被拒绝三种路径
  • 避免重复请求,并理解页面重建时结果处理的关键点

先把请求时机放对

假设应用有一个“扫码”按钮,需要摄像头权限。不要在 onCreate() 中无条件申请,而应该等用户主动点击扫码后再检查权限。Android 官方建议把运行时权限与具体用户操作关联,并在需要执行受保护操作时再次检查授权状态。([Android Developers][3])

本例使用 AndroidX ActivityResultContracts.RequestPermission。官方文档将它作为简化运行时权限请求逻辑的推荐方式之一,避免自己维护 request code 与旧式回调分发。([Android Developers][3])

实现检查、申请和结果处理

下面是一个可放入 Android App 的完整 Activity 示例。它使用摄像头权限作为示例,按钮点击后才进入授权流程;permissionLauncher 作为 Activity 成员注册,因此页面重新创建后仍会重新建立结果回调。

kotlin
package com.example.permissions

import android.Manifest
import android.content.pm.PackageManager
import android.os.Bundle
import android.widget.Button
import android.widget.Toast
import androidx.activity.result.contract.ActivityResultContracts
import androidx.appcompat.app.AppCompatActivity
import androidx.core.content.ContextCompat

class MainActivity : AppCompatActivity() {

    private lateinit var scanButton: Button

    // 让系统负责把权限结果分发给当前 Activity 实例。
    private val permissionLauncher =
        registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
            if (granted) {
                startScan()
            } else {
                showPermissionDeniedState()
            }
        }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        scanButton = findViewById(R.id.scanButton)
        scanButton.setOnClickListener {
            requestCameraIfNeeded()
        }
    }

    private fun requestCameraIfNeeded() {
        val granted = ContextCompat.checkSelfPermission(
            this,
            Manifest.permission.CAMERA
        ) == PackageManager.PERMISSION_GRANTED

        if (granted) {
            startScan()
            return
        }

        // 已拒绝过且系统建议解释原因时,先给出业务说明,再申请。
        if (shouldShowRequestPermissionRationale(Manifest.permission.CAMERA)) {
            Toast.makeText(
                this,
                "扫码需要使用摄像头",
                Toast.LENGTH_LONG
            ).show()
        }

        permissionLauncher.launch(Manifest.permission.CAMERA)
    }

    private fun startScan() {
        Toast.makeText(this, "开始扫码", Toast.LENGTH_SHORT).show()
    }

    private fun showPermissionDeniedState() {
        scanButton.text = "无法扫码,重新授权后再试"
    }
}

预期结果

text
首次点击“扫码”且 CAMERA 未授权:系统显示摄像头权限请求。
用户允许:回调收到 granted=true,并进入 startScan()。
用户拒绝:回调收到 granted=false,界面进入不可扫码状态,而不是继续访问摄像头。
再次点击且权限已授予:直接执行 startScan(),不会重复弹出权限框。

为什么这样不会把状态写乱

关键是把“权限状态”和“业务状态”分开。checkSelfPermission() 只回答当前是否已有授权;RequestPermission 的回调只处理这次请求的结果。真正执行摄像头功能前仍应依赖当前授权状态,而不是依赖某个自己维护的布尔变量。系统权限可以被用户在应用外部撤销,因此业务状态不能替代权限检查。([Android Developers][1])

页面重建时,Activity 会重新创建并重新注册 permissionLauncher。这也是 Activity Result API 比自己维护旧式 request code 更容易控制的原因:结果处理入口与当前 Activity 生命周期绑定,业务代码不需要自行寻找旧页面实例。实际项目中仍应让授权后的操作以当前页面状态为准,而不是假设结果一定仍适用于已经离开的界面。

重复请求与拒绝后的降级

重复点击是权限流程中的常见边界。最直接的控制方式是让按钮只触发一次业务入口,并避免在多个回调、观察者或页面事件中同时调用 launch()。更重要的是,拒绝权限后不要把整个页面锁死,应明确提供不依赖该权限的替代路径,例如保留手动输入、继续浏览历史记录或允许稍后重新授权。Android 官方同样要求在用户拒绝后优雅降级。([Android Developers][3])

运行时权限申请决策流程

页面重建时怎么验证

不要只测试“点一次然后允许”。至少重新执行这组场景:第一次申请并允许、第一次申请并拒绝、已经允许后再次进入、已经拒绝后再次点击,以及发起请求期间旋转屏幕或触发其他导致 Activity 重建的操作。每种情况下都要确认不会访问未授权资源,也不会因为旧页面状态丢失而误执行受保护操作。

最终可以把一次运行时权限接入压缩成一句工程规则:Manifest 声明确保应用声明需求,运行时检查决定当前能不能做,用户结果决定这次操作继续还是降级。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

完成一次运行时权限申请

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通