原生移动开发 / 系统课时

Android 权限模型

Android 权限模型

Android 权限处理的重点不是“把弹窗调出来”,而是把声明、检查、解释、申请、拒绝后的降级串成完整闭环。本节用相机权限演示推荐流程,并把最小权限原则落实到可运行代码中。

学习目标

  • 区分清单声明与运行时授权的职责
  • 使用 Activity Result API 完成权限检查、申请与结果处理
  • 正确处理拒绝、再次申请和无权限降级

权限从清单声明开始

应用只能申请自己在 AndroidManifest.xml 中声明过的权限。普通权限通常在安装时处理;危险权限还需要在运行时由用户授权。清单声明决定“应用可能需要什么”,运行时授权决定“用户此刻是否允许”。:contentReference[oaicite:0]{index=0}

以相机为例,先声明权限。下面是片段示例,放在 AndroidManifest.xml 的 manifest 根元素内、application 元素之外:

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

这段配置本身不会弹出权限对话框。验证时可安装应用后进入系统的“应用信息 → 权限”,确认相机权限处于可管理状态;真正的授权请求应在用户触发拍照功能时发起。

运行时请求是一个状态流程

一次可靠的权限请求至少要判断三个状态:已经授权、需要先解释原因、可以直接发起系统请求。请求结束后还要根据授权或拒绝结果决定继续功能还是降级,而不是默认用户一定会同意。Android 官方推荐优先使用 RequestPermission Activity Result contract,并要求拒绝后继续提供可用体验。:contentReference[oaicite:1]{index=1}

运行时权限申请状态流程

下面的示例把请求放在“拍照”按钮之后,并在需要说明原因时先展示应用内说明:

kotlin
package com.example.permissiondemo

import android.Manifest
import android.app.AlertDialog
import android.content.pm.PackageManager
import android.os.Bundle
import android.widget.Button
import android.widget.LinearLayout
import android.widget.TextView
import androidx.activity.ComponentActivity
import androidx.activity.result.contract.ActivityResultContracts
import androidx.core.app.ActivityCompat
import androidx.core.content.ContextCompat

class MainActivity : ComponentActivity() {

    private lateinit var statusView: TextView

    private val requestCameraPermission =
        registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
            statusView.text = if (granted) {
                "相机权限已授予,可以继续拍摄"
            } else {
                "未获得相机权限,继续使用无相机模式"
            }
        }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        statusView = TextView(this).apply {
            text = "尚未请求相机权限"
        }
        val button = Button(this).apply {
            text = "拍照"
            setOnClickListener { ensureCameraPermission() }
        }
        val layout = LinearLayout(this).apply {
            orientation = LinearLayout.VERTICAL
            addView(button)
            addView(statusView)
        }
        setContentView(layout)
    }

    private fun ensureCameraPermission() {
        when {
            ContextCompat.checkSelfPermission(
                this,
                Manifest.permission.CAMERA
            ) == PackageManager.PERMISSION_GRANTED -> {
                statusView.text = "相机权限已授予,可以继续拍摄"
            }

            ActivityCompat.shouldShowRequestPermissionRationale(
                this,
                Manifest.permission.CAMERA
            ) -> {
                AlertDialog.Builder(this)
                    .setMessage("拍照功能需要使用相机;不授权也可以继续浏览其他内容。")
                    .setPositiveButton("继续") { _, _ ->
                        requestCameraPermission.launch(Manifest.permission.CAMERA)
                    }
                    .setNegativeButton("取消", null)
                    .show()
            }

            else -> {
                requestCameraPermission.launch(Manifest.permission.CAMERA)
            }
        }
    }
}

预期结果:

text
首次点击“拍照”:系统可能显示相机权限对话框。
选择“允许”:页面显示“相机权限已授予,可以继续拍摄”。
选择“拒绝”:页面显示“未获得相机权限,继续使用无相机模式”。
再次触发时若系统建议说明原因:先出现应用内解释对话框。

不同 Android 版本的系统对话框样式和可选项可能不同,因此业务逻辑只应依赖“当前是否已授权”以及请求回调,不要依赖按钮文案。

拒绝不是异常路径

权限拒绝是正常用户选择。应用不能在回调中崩溃,也不应循环弹窗强迫授权。shouldShowRequestPermissionRationale() 适合判断是否需要解释用途,但返回 false 并不能单独证明用户已经“永久拒绝”,因为首次请求前也可能为 false。:contentReference[oaicite:2]{index=2}

对于必须依赖该权限的功能,可以停留在当前页面并说明哪些能力不可用;对于非核心能力,应直接提供降级方案。只有当用户主动再次触发该功能时,再考虑重新请求或引导到系统设置。

最小权限是默认策略

权限越少,授权链路越简单,用户也越容易理解。只声明当前功能真正需要的权限,并在用户触发相关操作时再申请;如果系统选择器、Photo Picker 或 Storage Access Framework 已能完成任务,就不要额外申请广泛的媒体或存储访问权限。这样既减少拒绝带来的分支,也缩小敏感数据暴露面。

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

目录与阅读设置

阅读设置

17

记录一个想法

Android 权限模型

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

登录哪都通