3. 权限分类与映射表

Android 运行时权限体系将权限划分为三类：正常权限（Normal Permissions）、危险权限（Dangerous Permissions） 和 特殊权限（Special Permissions）。准确理解三者的定义、清单及 API 级别对应关系，是设计 Runtime 权限申请流程的前提条件。

3.1 适用场景

• 新功能开发阶段，需要确定目标权限类型并选取正确的申请策略。
• 遗留项目权限适配（如 targetSdkVersion 升级至 23+）时，对比现有权限与最新分类。
• 代码审查或合规审计时，验证权限声明与用户隐私保护要求是否一致。

3.2 前置条件

• 已配置 Android SDK 环境，了解 AndroidManifest.xml 中 <uses-permission> 标签的基本用法。
• 明确项目当前 compileSdk、minSdk 和 targetSdk 版本。
• 获得 Android 官方权限参考文档（或本课程提供的汇总表）。

3.3 操作步骤

步骤 1：识别权限类型定义

步骤 2：对照危险权限分组清单（核心映射表）

下表列出截至 Android 14 的主要危险权限组及对应权限标识。同一组中只要授权一项，组内其他权限即自动允许。

步骤 3：特殊权限清单及操作方式

3.4 输入输出物

3.5 责任边界

• Android 开发工程师： 负责对照表格将项目所用权限划分类别，并确保 targetSdk 对应的行为正确。
• 技术 PM / 架构师： 审核权限分类是否覆盖所有功能，是否存在过度申请。
• QA 测试： 验证不同 API 版本下权限行为是否与分类预期一致（如 Android 10+ 后台位置需单独处理）。

3.6 记录材料

• 项目权限登记表：建议以 CSV 或 Markdown 格式记录“权限名 → 类型 → 引入 API → 申请方式”。
• 版本变更记录：当 compileSdk 升级时，同步更新该表。

# 示例权限登记表片段
| 权限名                          | 类型     | API 引入 | 申请方式               |
|--------------------------------|----------|----------|------------------------|
| android.permission.CAMERA       | dangerous| API 1    | requestPermissions()   |
| android.permission.SYSTEM_ALERT_WINDOW | special | API 23 | Settings intent       |
| android.permission.INTERNET     | normal   | API 1    | 自动授权               |

3.7 异常处理

• 权限分类混淆： 例如将 SYSTEM_ALERT_WINDOW 当作危险权限使用弹窗申请，导致始终被拒绝。解决方案：对照特殊权限清单及时修正代码逻辑。
• API 版本兼容： 部分权限（如 ACCESS_BACKGROUND_LOCATION）仅在 API 29+ 存在，低版本机型需做条件判断，避免 NoSuchMethodError。
• 分组误解： 误以为同组权限只要申请一项即可完全替代其他项。实际上只有同一组的权限才共享授权，跨组必须分别申请。

3.8 验收标准

1. 项目所有声明的权限均能在本章表格中找到对应分类。
2. 对特殊权限，已正确实现“跳转设置 → 返回检查”的引导逻辑。
3. 对不同 API 版本（特别是 targetSdk 23+），危险权限的运行时申请路径已设计到位。
4. 团队内可借助记录的权限登记表快速定位后续流程中的申请方式。