原生移动开发 / 系统课时
Android 权限模型
Android 权限模型
Android 权限处理的重点不是“把弹窗调出来”,而是把声明、检查、解释、申请、拒绝后的降级串成完整闭环。本节用相机权限演示推荐流程,并把最小权限原则落实到可运行代码中。
学习目标
- 区分清单声明与运行时授权的职责
- 使用 Activity Result API 完成权限检查、申请与结果处理
- 正确处理拒绝、再次申请和无权限降级
权限从清单声明开始
应用只能申请自己在 AndroidManifest.xml 中声明过的权限。普通权限通常在安装时处理;危险权限还需要在运行时由用户授权。清单声明决定“应用可能需要什么”,运行时授权决定“用户此刻是否允许”。:contentReference[oaicite:0]{index=0}
以相机为例,先声明权限。下面是片段示例,放在 AndroidManifest.xml 的 manifest 根元素内、application 元素之外:
<uses-permission android:name="android.permission.CAMERA" />这段配置本身不会弹出权限对话框。验证时可安装应用后进入系统的“应用信息 → 权限”,确认相机权限处于可管理状态;真正的授权请求应在用户触发拍照功能时发起。
运行时请求是一个状态流程
一次可靠的权限请求至少要判断三个状态:已经授权、需要先解释原因、可以直接发起系统请求。请求结束后还要根据授权或拒绝结果决定继续功能还是降级,而不是默认用户一定会同意。Android 官方推荐优先使用 RequestPermission Activity Result contract,并要求拒绝后继续提供可用体验。:contentReference[oaicite:1]{index=1}

下面的示例把请求放在“拍照”按钮之后,并在需要说明原因时先展示应用内说明:
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)
}
}
}
}预期结果:
首次点击“拍照”:系统可能显示相机权限对话框。
选择“允许”:页面显示“相机权限已授予,可以继续拍摄”。
选择“拒绝”:页面显示“未获得相机权限,继续使用无相机模式”。
再次触发时若系统建议说明原因:先出现应用内解释对话框。不同 Android 版本的系统对话框样式和可选项可能不同,因此业务逻辑只应依赖“当前是否已授权”以及请求回调,不要依赖按钮文案。
拒绝不是异常路径
权限拒绝是正常用户选择。应用不能在回调中崩溃,也不应循环弹窗强迫授权。shouldShowRequestPermissionRationale() 适合判断是否需要解释用途,但返回 false 并不能单独证明用户已经“永久拒绝”,因为首次请求前也可能为 false。:contentReference[oaicite:2]{index=2}
对于必须依赖该权限的功能,可以停留在当前页面并说明哪些能力不可用;对于非核心能力,应直接提供降级方案。只有当用户主动再次触发该功能时,再考虑重新请求或引导到系统设置。
最小权限是默认策略
权限越少,授权链路越简单,用户也越容易理解。只声明当前功能真正需要的权限,并在用户触发相关操作时再申请;如果系统选择器、Photo Picker 或 Storage Access Framework 已能完成任务,就不要额外申请广泛的媒体或存储访问权限。这样既减少拒绝带来的分支,也缩小敏感数据暴露面。