权限处理
权限类型 | 是否需要代码中申请 | 系统是否弹窗 | 用户可拒绝 | 备注 |
---|---|---|---|---|
普通权限 | 否 | 否 | 否 | 系统自动授予 |
危险权限 | 是 | 是 | 是 | 系统自动弹窗引导/需处理拒绝逻辑 |
前台服务权限 | 否 | 否 | 否 | 系统自动管理 |
特殊权限(例如VPN) | 是 | 是 | 是 | 系统自动弹窗引导/需处理拒绝逻辑 |
特性 | 静态申请(Manifest) | 动态申请(Runtime) |
---|---|---|
是否必须 | 必须声明,否则系统拒绝使用功能 | 仅危险权限需要,否则静态申请即可 |
用户交互 | 无交互(普通权限) | 弹出对话框,由用户同意或拒绝 |
时机 | 安装时系统识别 | App 运行时,根据需求请求 |
灵活性 | 低 | 高,可按需请求 |
易用性 | 高,写一次即可 | 低,需要代码判断、回调处理 |
典型用途 | 普通权限、声明功能依赖 | 危险权限,如 CAMERA、LOCATION、MICROPHONE |
- 静态申请权限必须写在
AndroidManifest.xml
文件里,通常在项目的app/src/main/AndroidManifest.xml
- 动态权限 / 运行时权限(例如危险权限) 一般在
Activity
或Fragment
中完成。比如在MainActivity.kt
Android 6-15 权限完整列表
普通权限 (Normal Permissions)
权限名称 | 调用名称 | 说明 | 使用场景 | 版本要求 |
---|---|---|---|---|
网络访问 | android.permission.INTERNET |
访问互联网 | 所有需要联网的应用:浏览器、社交软件、在线游戏、API调用、图片下载、视频播放 | API 1+ |
网络状态 | android.permission.ACCESS_NETWORK_STATE |
获取网络连接状态信息 | 检查网络连接:视频应用检查WiFi后播放高清、下载应用检查网络状态、在线游戏检测网络延迟 | API 1+ |
WiFi状态 | android.permission.ACCESS_WIFI_STATE |
获取WiFi网络状态信息 | WiFi管理应用、网络诊断工具、智能家居应用连接路由器、检测WiFi信号强度 | API 1+ |
更改WiFi状态 | android.permission.CHANGE_WIFI_STATE |
更改WiFi连接状态 | WiFi管理器、自动连接工具、智能家居应用、网络切换助手 | API 1+ |
蓝牙 | android.permission.BLUETOOTH |
使用蓝牙功能 | 蓝牙耳机应用、文件传输、智能手环连接、车载系统、IoT设备控制 | API 1+ |
蓝牙管理 | android.permission.BLUETOOTH_ADMIN |
管理蓝牙设备配对、发现等 | 蓝牙设备管理器、配对助手、蓝牙调试工具、设备搜索应用 | API 1+ |
蓝牙连接 | android.permission.BLUETOOTH_CONNECT |
连接已配对的蓝牙设备 | 音频播放器连接耳机、智能手表应用、汽车应用、游戏手柄连接 | API 31+ |
蓝牙扫描 | android.permission.BLUETOOTH_SCAN |
扫描蓝牙设备 | 设备发现应用、蓝牙调试工具、附近设备查找、智能家居设备搜索 | API 31+ |
蓝牙广播 | android.permission.BLUETOOTH_ADVERTISE |
蓝牙设备广播 | 让设备被其他蓝牙设备发现、Beacon应用、文件共享工具 | API 31+ |
NFC | android.permission.NFC |
使用NFC功能 | 移动支付、NFC标签读写、公交卡、门禁卡、NFC文件传输 | API 9+ |
震动 | android.permission.VIBRATE |
控制设备震动 | 游戏触觉反馈、消息通知震动、闹钟震动、键盘打字震动 | API 1+ |
唤醒锁定 | android.permission.WAKE_LOCK |
防止设备休眠 | 音乐播放器、视频播放、下载工具、导航应用、实时通话 | API 1+ |
开机启动 | android.permission.RECEIVE_BOOT_COMPLETED |
设备启动时接收广播 | 自动启动服务、定时任务、系统监控、安全软件、输入法 | API 1+ |
电池优化 | android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS |
请求忽略电池优化 | 实时通讯软件、闹钟应用、健康监测、后台同步应用 | API 23+ |
前台服务 | android.permission.FOREGROUND_SERVICE |
运行前台服务 | 音乐播放、下载管理、导航、运动追踪、实时通信 | API 28+ |
前台服务相机 | android.permission.FOREGROUND_SERVICE_CAMERA |
前台服务使用相机 | 直播应用、视频会议、监控应用、扫码工具 | API 34+ |
前台服务麦克风 | android.permission.FOREGROUND_SERVICE_MICROPHONE |
前台服务使用麦克风 | 语音通话、录音应用、语音助手、音乐识别 | API 34+ |
前台服务位置 | android.permission.FOREGROUND_SERVICE_LOCATION |
前台服务使用位置 | 导航应用、运动追踪、位置共享、地图应用 | API 34+ |
时区变更 | android.permission.RECEIVE_TIME_TICK |
接收时间变化广播 | 时钟应用、定时任务、时间同步工具、日程管理 | API 1+ |
安装快捷方式 | com.android.launcher.permission.INSTALL_SHORTCUT |
安装桌面快捷方式 | 应用启动器、快捷工具、桌面插件、游戏应用 | API 1+ |
卸载快捷方式 | com.android.launcher.permission.UNINSTALL_SHORTCUT |
卸载桌面快捷方式 | 桌面管理器、清理工具、启动器应用 | API 1+ |
更改配置 | android.permission.CHANGE_CONFIGURATION |
更改用户界面配置 | 屏幕旋转控制、语言切换、主题应用、辅助功能 | API 1+ |
扩展空间 | android.permission.EXPAND_STATUS_BAR |
展开或收起状态栏 | 通知管理器、系统工具、状态栏定制、快捷设置 | API 1+ |
获取任务 | android.permission.GET_TASKS |
获取正在运行的任务信息 | 任务管理器、系统监控、多任务切换器、性能优化工具 | API 1+ |
闪光灯 | android.permission.FLASHLIGHT |
使用闪光灯 | 手电筒应用、相机应用、扫码工具、SOS应急工具 | API 1+ |
禁用键盘锁 | android.permission.DISABLE_KEYGUARD |
禁用键盘锁 | 车载应用、演示应用、信息亭模式、紧急应用 | API 1+ |
危险权限 (Dangerous Permissions)
权限名称 | 调用名称 | 说明 | 使用场景 | 权限组 | 版本要求 |
---|---|---|---|---|---|
精确位置 | android.permission.ACCESS_FINE_LOCATION |
GPS精确定位 | 导航应用、地图软件、天气应用、运动追踪、外卖配送、打车应用 | LOCATION | API 1+ |
粗略位置 | android.permission.ACCESS_COARSE_LOCATION |
网络大概位置 | 天气应用、本地化服务、广告定位、时区设置、区域性内容推荐 | LOCATION | API 1+ |
后台位置 | android.permission.ACCESS_BACKGROUND_LOCATION |
后台获取位置 | 家人位置共享、运动轨迹记录、地理围栏提醒、失物追踪 | LOCATION | API 29+ |
相机 | android.permission.CAMERA |
使用摄像头 | 相机应用、视频通话、扫码工具、直播应用、AR应用、人脸识别 | CAMERA | API 1+ |
录音 | android.permission.RECORD_AUDIO |
录制音频 | 语音备忘录、视频通话、语音消息、音乐制作、语音识别、在线会议 | MICROPHONE | API 1+ |
读取外部存储 | android.permission.READ_EXTERNAL_STORAGE |
读取SD卡文件 | 图片浏览器、文件管理器、音乐播放器、文档阅读器、备份应用 | STORAGE | API 16-32 |
写入外部存储 | android.permission.WRITE_EXTERNAL_STORAGE |
写入SD卡文件 | 下载工具、相机应用、文件管理器、备份应用、离线缓存 | STORAGE | API 4-28 |
读取图片 | android.permission.READ_MEDIA_IMAGES |
读取图片文件 | 相册应用、图片编辑器、社交应用、壁纸应用、照片打印 | STORAGE | API 33+ |
读取视频 | android.permission.READ_MEDIA_VIDEO |
读取视频文件 | 视频播放器、视频编辑器、社交应用、媒体管理器、云存储 | STORAGE | API 33+ |
读取音频 | android.permission.READ_MEDIA_AUDIO |
读取音频文件 | 音乐播放器、音频编辑器、播客应用、铃声设置、音频分析 | STORAGE | API 33+ |
读取通讯录 | android.permission.READ_CONTACTS |
读取联系人信息 | 通讯录应用、社交软件、拨号器、短信应用、邮件客户端 | CONTACTS | API 1+ |
写入通讯录 | android.permission.WRITE_CONTACTS |
修改联系人信息 | 通讯录管理、联系人同步、CRM应用、名片扫描、社交导入 | CONTACTS | API 1+ |
获取账户 | android.permission.GET_ACCOUNTS |
获取设备账户列表 | 邮件客户端、社交登录、账户同步、云备份、多账户管理 | CONTACTS | API 1+ |
发送短信 | android.permission.SEND_SMS |
发送短信 | 短信应用、验证码发送、营销短信、双卡管理、短信群发 | SMS | API 1+ |
接收短信 | android.permission.RECEIVE_SMS |
接收短信 | 短信应用、验证码自动填充、短信拦截、智能回复、短信备份 | SMS | API 1+ |
读取短信 | android.permission.READ_SMS |
读取短信内容 | 短信管理器、验证码识别、短信备份、垃圾短信过滤、短信搜索 | SMS | API 1+ |
接收WAP推送 | android.permission.RECEIVE_WAP_PUSH |
接收WAP推送信息 | 浏览器应用、运营商服务、WAP网关、移动门户、彩信接收 | SMS | API 1+ |
接收彩信 | android.permission.RECEIVE_MMS |
接收彩信 | 短信应用、彩信管理器、消息备份、多媒体消息处理 | SMS | API 1+ |
拨打电话 | android.permission.CALL_PHONE |
直接拨打电话 | 拨号器、联系人应用、一键拨号、紧急呼叫、客服热线 | PHONE | API 1+ |
读取电话状态 | android.permission.READ_PHONE_STATE |
获取设备ID、电话状态 | 设备识别、通话状态监听、双卡管理、防骚扰、系统工具 | PHONE | API 1+ |
读取电话号码 | android.permission.READ_PHONE_NUMBERS |
读取设备电话号码 | 号码识别、SIM卡管理、用户验证、通讯录同步 | PHONE | API 26+ |
接听电话 | android.permission.ANSWER_PHONE_CALLS |
接听来电 | 自动接听应用、来电管理、车载系统、无障碍辅助 | PHONE | API 26+ |
读取通话记录 | android.permission.READ_CALL_LOG |
读取通话记录 | 通话记录管理、通话统计、备份应用、联系人频率分析 | PHONE | API 16+ |
写入通话记录 | android.permission.WRITE_CALL_LOG |
写入通话记录 | 通话记录备份、第三方拨号器、通话管理、VoIP应用 | PHONE | API 16+ |
添加语音邮件 | android.permission.ADD_VOICEMAIL |
添加语音邮箱 | 语音邮件应用、运营商服务、企业通信、VoIP服务 | PHONE | API 14+ |
使用SIP | android.permission.USE_SIP |
使用SIP视频通话 | VoIP通话、企业通信、网络电话、视频会议、IP电话 | PHONE | API 9+ |
处理拨出电话 | android.permission.PROCESS_OUTGOING_CALLS |
监控拨出电话 | 通话记录、号码归属地、防骚扰、通话拦截、双卡切换 | PHONE | API 1-28 |
读取日历 | android.permission.READ_CALENDAR |
读取日历事件 | 日程管理、会议提醒、日历小部件、时间规划、事件同步 | CALENDAR | API 1+ |
写入日历 | android.permission.WRITE_CALENDAR |
创建日历事件 | 日程创建、会议安排、提醒设置、日历同步、事件导入 | CALENDAR | API 1+ |
身体传感器 | android.permission.BODY_SENSORS |
访问心率传感器等 | 健康监测、运动应用、心率检测、健身追踪、医疗设备 | SENSORS | API 20+ |
活动识别 | android.permission.ACTIVITY_RECOGNITION |
识别用户活动状态 | 计步器、运动识别、健身应用、行为分析、自动模式切换 | ACTIVITY_RECOGNITION | API 29+ |
通知权限 | android.permission.POST_NOTIFICATIONS |
发送通知给用户 | 所有需要推送的应用:社交软件、新闻应用、游戏、购物、银行应用 | NOTIFICATION | API 33+ |
特殊权限 (Special Permissions)
权限名称 | 调用名称 | 说明 | 使用场景 | 申请方式 | 版本要求 |
---|---|---|---|---|---|
系统设置修改 | android.permission.WRITE_SETTINGS |
修改系统设置 | 亮度调节、音量控制、屏幕旋转、WiFi开关、系统优化工具 | Settings.ACTION_MANAGE_WRITE_SETTINGS | API 23+ |
悬浮窗 | android.permission.SYSTEM_ALERT_WINDOW |
显示系统级悬浮窗 | 悬浮球、聊天气泡、视频悬浮播放、计算器悬浮、游戏助手 | Settings.ACTION_MANAGE_OVERLAY_PERMISSION | API 23+ |
安装应用 | android.permission.REQUEST_INSTALL_PACKAGES |
安装APK文件 | 应用商店、APK安装器、游戏平台、企业应用分发、系统更新 | Settings.ACTION_MANAGE_UNKNOWN_APP_SOURCES | API 26+ |
设备管理员 | android.permission.BIND_DEVICE_ADMIN |
设备管理员权限 | MDM企业管理、远程擦除、屏幕锁定、密码策略、安全软件 | 系统设置页面 | API 8+ |
无障碍服务 | android.permission.BIND_ACCESSIBILITY_SERVICE |
无障碍功能 | 自动点击器、屏幕阅读器、语音控制、手势控制、辅助操作 | Settings.ACTION_ACCESSIBILITY_SETTINGS | API 4+ |
VPN服务 | android.permission.BIND_VPN_SERVICE |
VPN连接服务 | VPN客户端、代理工具、网络加速、科学上网、企业网络接入 | VpnService.prepare() | API 14+ |
使用情况访问 | android.permission.PACKAGE_USAGE_STATS |
获取应用使用统计 | 使用时间统计、应用管理、家长控制、数字健康、使用习惯分析 | Settings.ACTION_USAGE_ACCESS_SETTINGS | API 21+ |
全文件访问 | android.permission.MANAGE_EXTERNAL_STORAGE |
访问所有文件 | 文件管理器、备份工具、清理软件、数据恢复、系统工具 | Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION | API 30+ |
忽略电池优化 | android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS |
忽略电池优化 | IM应用、邮件推送、定时任务、后台同步、实时监控 | Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS | API 23+ |
精确闹钟 | android.permission.SCHEDULE_EXACT_ALARM |
设置精确时间的闹钟 | 闹钟应用、定时提醒、自动化工具、定时任务、精确计时 | Settings.ACTION_REQUEST_SCHEDULE_EXACT_ALARM | API 31+ |
通知监听 | android.permission.BIND_NOTIFICATION_LISTENER_SERVICE |
监听通知 | 通知管理、智能回复、通知分类、免打扰管理、通知统计 | Settings.ACTION_NOTIFICATION_LISTENER_SETTINGS | API 18+ |
修改安全设置 | android.permission.WRITE_SECURE_SETTINGS |
修改安全设置 | 系统调试、开发者工具、系统定制、ROOT工具、系统优化 | 系统签名或root | API 1+ |
显示系统对话框 | android.permission.SYSTEM_OVERLAY_WINDOW |
显示系统级对话框 | 系统提示、权限请求、系统级弹窗、紧急通知 | Settings.ACTION_MANAGE_OVERLAY_PERMISSION | API 23+ |
系统级权限 (System/Signature)
权限名称 | 调用名称 | 说明 | 使用场景 | 版本要求 |
---|---|---|---|---|
重启设备 | android.permission.REBOOT |
重启设备 | 系统更新、系统工具、ROOT管理、设备维护、故障恢复 | API 1+ |
设置时间 | android.permission.SET_TIME |
设置系统时间 | 时间同步、系统设置、网络时间校准、时区应用 | API 8+ |
设置时区 | android.permission.SET_TIME_ZONE |
设置系统时区 | 时区自动切换、旅行应用、系统设置、时间管理 | API 1+ |
挂载文件系统 | android.permission.MOUNT_UNMOUNT_FILESYSTEMS |
挂载和卸载文件系统 | 文件管理器、外部存储管理、系统工具、备份应用 | API 1+ |
格式化文件系统 | android.permission.MOUNT_FORMAT_FILESYSTEMS |
格式化外部存储 | 存储管理、系统恢复、清理工具、存储格式化 | API 1+ |
删除缓存文件 | android.permission.DELETE_CACHE_FILES |
删除其他应用的缓存 | 清理工具、存储优化、系统维护、垃圾清理 | API 1+ |
删除包 | android.permission.DELETE_PACKAGES |
删除应用包 | 应用管理器、卸载工具、系统清理、恶意软件清除 | API 1+ |
清除应用缓存 | android.permission.CLEAR_APP_CACHE |
清除任何应用的缓存 | 系统清理、内存优化、应用管理、性能提升 | API 1+ |
访问缓存文件系统 | android.permission.ACCESS_CACHE_FILESYSTEM |
访问缓存文件系统 | 缓存管理、临时文件访问、系统优化、存储分析 | API 1+ |
读取日志 | android.permission.READ_LOGS |
读取系统日志文件 | 系统调试、错误分析、性能监控、开发工具、故障诊断 | API 1+ |
状态栏 | android.permission.STATUS_BAR |
打开、关闭或禁用状态栏 | 系统定制、Kiosk模式、全屏应用、状态栏管理 | API 1+ |
强制停止包 | android.permission.FORCE_STOP_PACKAGES |
强制停止其他应用 | 任务管理器、系统优化、应用管理、内存清理 | API 1+ |
获取应用大小 | android.permission.GET_PACKAGE_SIZE |
获取任何包的空间占用 | 存储分析、应用管理、清理工具、存储优化、使用统计 | API 1+ |
特殊用途权限
权限名称 | 调用名称 | 说明 | 使用场景 | 申请方式 | 版本要求 |
---|---|---|---|---|---|
管理外部存储 | android.permission.MANAGE_EXTERNAL_STORAGE |
管理所有文件 | 文件管理器、备份恢复、数据迁移、清理工具、开发调试 | Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION | API 30+ |
查询所有包 | android.permission.QUERY_ALL_PACKAGES |
查询设备上所有已安装的应用 | 应用管理器、启动器、安全扫描、应用分析、卸载工具 | - | API 30+ |
与其他应用交互 | android.permission.INTERACT_ACROSS_USERS |
跨用户交互 | 多用户管理、企业应用、家长控制、用户切换、共享应用 | 系统应用 | API 17+ |
使用指纹 | android.permission.USE_FINGERPRINT |
使用指纹认证 | 生物识别登录、支付验证、应用锁、密码管理、安全认证 | - | API 23-27 |
使用生物识别 | android.permission.USE_BIOMETRIC |
使用生物识别认证 | 人脸识别、指纹识别、虹膜识别、支付验证、应用解锁 | - | API 28+ |
已弃用权限 (Deprecated Permissions)
权限名称 | 调用名称 | 说明 | 使用场景 | 弃用版本 |
---|---|---|---|---|
写入外部存储 | android.permission.WRITE_EXTERNAL_STORAGE |
写入SD卡文件 | 文件下载、相机存储、应用数据保存 | API 29+ |
读取外部存储 | android.permission.READ_EXTERNAL_STORAGE |
读取SD卡文件 | 图片浏览、文件访问、媒体播放 | API 33+ |
处理拨出电话 | android.permission.PROCESS_OUTGOING_CALLS |
监控拨出电话 | 通话拦截、号码识别、通话记录 | API 29+ |
Android 12+ 新增权限
权限名称 | 调用名称 | 说明 | 使用场景 | 权限组 | 版本要求 |
---|---|---|---|---|---|
蓝牙扫描 | android.permission.BLUETOOTH_SCAN |
扫描附近的蓝牙设备 | 设备配对、蓝牙调试、附近设备发现、智能家居设备搜索 | NEARBY_DEVICES | API 31+ |
蓝牙广播 | android.permission.BLUETOOTH_ADVERTISE |
使设备可被其他蓝牙设备发现 | 设备共享、文件传输、设备配对、Beacon应用 | NEARBY_DEVICES | API 31+ |
蓝牙连接 | android.permission.BLUETOOTH_CONNECT |
连接到已配对的蓝牙设备 | 音频播放、数据传输、智能穿戴、车载连接 | NEARBY_DEVICES | API 31+ |
附近WiFi设备 | android.permission.NEARBY_WIFI_DEVICES |
发现和连接附近的WiFi设备 | WiFi Direct、P2P连接、本地网络发现、设备互联 | NEARBY_DEVICES | API 33+ |
UWB测距 | android.permission.UWB_RANGING |
使用UWB进行精确测距 | 精确定位、室内导航、设备查找、空间感知、AR应用 | NEARBY_DEVICES | API 31+ |
Android 13+ 新增权限
权限名称 | 调用名称 | 说明 | 使用场景 | 权限组 | 版本要求 |
---|---|---|---|---|---|
发送通知 | android.permission.POST_NOTIFICATIONS |
发送通知给用户 | 消息推送、提醒通知、状态更新、新闻推送、系统通知 | NOTIFICATION | API 33+ |
读取图片 | android.permission.READ_MEDIA_IMAGES |
读取设备上的图片 | 相册应用、图片编辑、壁纸设置、社交分享、图片管理 | STORAGE | API 33+ |
读取视频 | android.permission.READ_MEDIA_VIDEO |
读取设备上的视频 | 视频播放器、视频编辑、媒体管理、短视频应用、云备份 | STORAGE | API 33+ |
读取音频 | android.permission.READ_MEDIA_AUDIO |
读取设备上的音频文件 | 音乐播放器、音频编辑、播客应用、铃声设置、语音处理 | STORAGE | API 33+ |
Android 14+ 新增权限
权限名称 | 调用名称 | 说明 | 使用场景 | 权限组 | 版本要求 |
---|---|---|---|---|---|
选择图片视频 | android.permission.READ_MEDIA_VISUAL_USER_SELECTED |
用户选择的图片和视频 | 照片选择器、媒体编辑、社交分享、相册应用、内容创作 | STORAGE | API 34+ |
前台服务数据同步 | android.permission.FOREGROUND_SERVICE_DATA_SYNC |
前台服务数据同步 | 云同步、数据备份、文件同步、邮件同步、联系人同步 | - | API 34+ |
前台服务媒体播放 | android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK |
前台服务媒体播放 | 音乐播放、视频播放、播客应用、有声读物、媒体控制 | - | API 34+ |
选择图片视频 | android.permission.READ_MEDIA_VISUAL_USER_SELECTED |
用户选择的图片和视频 | 照片选择器、媒体编辑、社交分享、相册应用、内容创作 | STORAGE | API 34+ |
Android 15(API 35)新增权限
权限名称 | 调用名称 | 说明 | 使用场景 | 权限组 | 版本要求 |
---|---|---|---|---|---|
前台服务数据同步 | android.permission.FOREGROUND_SERVICE_DATA_SYNC |
前台服务数据同步 | 云同步、数据备份、文件同步、邮件同步、联系人同步 | - | API 35+ |
前台服务媒体播放 | android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK |
前台服务媒体播放 | 音乐播放、视频播放、播客应用、有声读物、媒体控制 | - | API 35+ |
前台服务电话功能 | android.permission.FOREGROUND_SERVICE_PHONE_CALL |
前台服务电话功能 | VoIP通话、视频通话、电话助手、来电显示、语音识别 | - | API 35+ |
系统权限管理 | android.permission.MANAGE_SYSTEM_PERMISSIONS |
管理系统权限 | OEM厂商、系统级应用、设备管理 | SYSTEM | API 35+ |
❤️转载请注明出处❤️