UniApp权限管理别再写if-else了！封装一个Promise版checkPermission函数（附完整安卓权限表）

UniApp权限管理的工程化实践从Promise封装到完整解决方案在移动应用开发中权限管理一直是开发者必须面对的挑战。UniApp作为跨平台开发框架虽然简化了多端适配的复杂度但在权限处理上依然存在诸多痛点。传统if-else嵌套的回调方式不仅让代码难以维护还容易造成逻辑混乱。本文将带你探索一种更优雅的解决方案——基于Promise的权限管理封装同时提供完整的安卓权限参考表助你构建更健壮的应用权限体系。1. 为什么需要重构权限管理大多数UniApp开发者在初次接触权限管理时往往会采用最直接的方式在需要权限的API调用处通过回调函数处理授权结果。这种模式虽然简单但随着业务复杂度提升很快会暴露出几个典型问题代码重复相同的权限检查逻辑散落在各个业务模块中嵌套回调多重权限检查导致回调地狱降低代码可读性缺乏统一处理权限拒绝后的引导逻辑不一致用户体验割裂维护困难权限变更时需要修改多处代码容易遗漏// 传统方式示例 uni.getSetting({ success(res) { if (!res.authSetting[scope.userLocation]) { uni.authorize({ scope: scope.userLocation, success() { // 实际业务逻辑 }, fail() { uni.showModal({ content: 需要位置权限才能使用此功能 }) } }) } } })Promise化的权限管理可以完美解决这些问题。通过将权限检查抽象为独立的服务我们能够实现单一职责权限检查逻辑集中管理链式调用避免回调嵌套代码更扁平统一异常处理标准化权限拒绝流程易于扩展支持多权限批量检查2. Promise化权限检查的核心实现让我们从零开始构建一个健壮的权限检查工具。这个实现不仅包含基本的授权检查还整合了权限引导、错误处理等实用功能。2.1 基础Promise封装首先创建一个permission.js工具文件实现最基础的Promise封装// /utils/permission.js export function checkPermission(permissions, options {}) { return new Promise((resolve, reject) { if (!Array.isArray(permissions)) { permissions [permissions] } plus.android.requestPermissions( permissions, (result) { if (result.deniedAlways result.deniedAlways.length 0) { // 用户选择了拒绝且不再询问 handlePermissionReject(result.deniedAlways, options, reject) } else if (result.denied result.denied.length 0) { // 用户暂时拒绝 handlePermissionReject(result.denied, options, reject) } else { // 全部授权通过 resolve(true) } } ) }) } function handlePermissionReject(deniedPermissions, options, reject) { const { guideMessage 需要以下权限才能继续使用此功能 } options uni.showModal({ title: 权限提示, content: guideMessage, confirmText: 去设置, success(res) { if (res.confirm) { openAppSettings() } reject(new PermissionError(deniedPermissions)) } }) }2.2 高级功能扩展基础版本已经可用但我们还可以添加更多实用功能多权限批量检查// 支持同时检查多个权限 checkPermission([ android.permission.CAMERA, android.permission.RECORD_AUDIO ]).then(() { // 所有权限都已授权 }).catch((err) { // 处理被拒绝的权限 console.error(被拒绝的权限:, err.deniedPermissions) })自定义引导信息// 为不同权限设置不同的引导信息 const permissionGuideMap { android.permission.CAMERA: 需要相机权限进行扫码和拍照, android.permission.RECORD_AUDIO: 需要麦克风权限进行语音输入 } checkPermission(android.permission.CAMERA, { guideMessage: permissionGuideMap[android.permission.CAMERA] })权限状态缓存// 添加简单的内存缓存避免频繁弹窗 const permissionCache new Map() export function checkPermissionWithCache(permission, options) { const cacheKey Array.isArray(permission) ? permission.join(|) : permission if (permissionCache.has(cacheKey)) { return Promise.resolve(permissionCache.get(cacheKey)) } return checkPermission(permission, options).then((result) { permissionCache.set(cacheKey, result) return result }) }2.3 完整的工具类实现将上述功能整合我们得到一个功能完善的权限工具类// /utils/permission.js class PermissionError extends Error { constructor(deniedPermissions) { super(权限被拒绝) this.deniedPermissions deniedPermissions this.name PermissionError } } const permissionCache new Map() export default { /** * 检查权限(Promise版) * param {string|string[]} permissions 需要检查的权限 * param {object} options 配置选项 * param {string} options.guideMessage 权限引导提示信息 * param {boolean} options.forceCheck 是否强制检查(忽略缓存) * returns {Promiseboolean} */ check(permissions, options {}) { if (!Array.isArray(permissions)) { permissions [permissions] } const cacheKey permissions.join(|) // 检查缓存 if (!options.forceCheck permissionCache.has(cacheKey)) { return Promise.resolve(permissionCache.get(cacheKey)) } return new Promise((resolve, reject) { plus.android.requestPermissions( permissions, (result) { if (result.deniedAlways result.deniedAlways.length 0) { handleReject(result.deniedAlways, options, reject) } else if (result.denied result.denied.length 0) { handleReject(result.denied, options, reject) } else { permissionCache.set(cacheKey, true) resolve(true) } } ) }) }, /** * 清除权限缓存 * param {string|string[]} [permissions] 指定要清除的权限不传则清除所有 */ clearCache(permissions) { if (!permissions) { permissionCache.clear() return } if (!Array.isArray(permissions)) { permissions [permissions] } const cacheKey permissions.join(|) permissionCache.delete(cacheKey) } } function handleReject(deniedPermissions, options, reject) { const { guideMessage 需要以下权限才能继续使用此功能 } options uni.showModal({ title: 权限提示, content: ${guideMessage}: \n${deniedPermissions.join(\n)}, confirmText: 去设置, success(res) { if (res.confirm) { openAppSettings() } reject(new PermissionError(deniedPermissions)) } }) } function openAppSettings() { const Intent plus.android.importClass(android.content.Intent) const Settings plus.android.importClass(android.provider.Settings) const Uri plus.android.importClass(android.net.Uri) const mainActivity plus.android.runtimeMainActivity() const intent new Intent() intent.setAction(Settings.ACTION_APPLICATION_DETAILS_SETTINGS) const uri Uri.fromParts(package, mainActivity.getPackageName(), null) intent.setData(uri) mainActivity.startActivity(intent) }3. 实际应用场景与最佳实践有了强大的权限工具我们来看看如何在真实项目中应用它。3.1 基础使用示例单个权限检查import permission from /utils/permission permission.check(android.permission.CAMERA, { guideMessage: 需要相机权限才能使用扫码功能 }).then(() { // 调用扫码API uni.scanCode({ /* ... */ }) }).catch((err) { console.error(权限被拒绝:, err.deniedPermissions) })多个权限检查// 同时检查相机和存储权限 permission.check([ android.permission.CAMERA, android.permission.READ_EXTERNAL_STORAGE ], { guideMessage: 需要相机和存储权限才能使用拍照上传功能 }).then(() { // 执行需要权限的操作 }).catch((err) { if (err instanceof PermissionError) { // 处理特定权限错误 } })3.2 与页面生命周期结合在页面生命周期中合理使用权限检查可以提升用户体验// 页面加载时检查必要权限 onLoad() { this.checkRequiredPermissions() }, methods: { async checkRequiredPermissions() { try { await permission.check([ android.permission.ACCESS_FINE_LOCATION, android.permission.ACCESS_COARSE_LOCATION ], { guideMessage: 需要位置权限才能获取周边信息 }) // 权限已授权获取位置 this.getLocation() } catch (err) { // 可选的降级处理 this.showDegradedUI() } }, getLocation() { uni.getLocation({ type: gcj02, success: (res) { // 处理位置信息 } }) }, showDegradedUI() { // 显示无权限状态下的UI } }3.3 高级组合技巧权限检查与API调用组合// 创建一个需要权限的API调用高阶函数 function createPermissionedApi(apiFunc, requiredPermissions, options) { return async function(...args) { try { await permission.check(requiredPermissions, options) return apiFunc(...args) } catch (err) { if (err instanceof PermissionError) { // 可以选择在这里统一处理权限错误 throw new Error(API调用失败: 缺少必要权限) } throw err } } } // 使用示例 const scanCodeWithPermission createPermissionedApi( uni.scanCode, [android.permission.CAMERA], { guideMessage: 需要相机权限才能扫码 } ) // 在业务代码中直接调用 scanCodeWithPermission({ success(res) { console.log(res.result) } })Vue指令封装// 注册一个权限指令 Vue.directive(permission, { inserted(el, binding) { const { value } binding if (!value) return permission.check(value.permissions, value.options).catch(() { // 权限未授权时禁用元素 el.style.opacity 0.5 el.style.pointerEvents none // 添加点击事件引导用户授权 el.addEventListener(click, () { permission.check(value.permissions, { ...value.options, forceCheck: true }).then(() { // 权限通过后恢复元素 el.style.opacity 1 el.style.pointerEvents auto }) }) }) } }) // 使用示例 button v-permission{ permissions: android.permission.CAMERA, options: { guideMessage: 需要相机权限才能使用此按钮 } }扫码/button4. 安卓权限参考大全为了帮助开发者更好地管理权限以下是按功能分类的安卓权限参考表。在实际开发中应根据最小权限原则只申请必要的权限。4.1 常用权限分类分类权限说明相机android.permission.CAMERA访问摄像头进行拍照或录像android.permission.RECORD_AUDIO录制音频通常与相机权限一起使用位置android.permission.ACCESS_FINE_LOCATION通过GPS获取精确位置android.permission.ACCESS_COARSE_LOCATION通过网络获取粗略位置存储android.permission.READ_EXTERNAL_STORAGE读取外部存储android.permission.WRITE_EXTERNAL_STORAGE写入外部存储通讯录android.permission.READ_CONTACTS读取联系人android.permission.WRITE_CONTACTS写入联系人电话android.permission.READ_PHONE_STATE读取电话状态android.permission.CALL_PHONE直接拨打电话日历android.permission.READ_CALENDAR读取日历事件android.permission.WRITE_CALENDAR写入日历事件传感器android.permission.BODY_SENSORS访问身体传感器数据短信android.permission.READ_SMS读取短信android.permission.SEND_SMS发送短信4.2 危险权限列表安卓将权限分为普通权限和危险权限危险权限需要运行时申请。以下是完整的危险权限列表日历READ_CALENDARWRITE_CALENDAR相机CAMERA联系人READ_CONTACTSWRITE_CONTACTSGET_ACCOUNTS位置ACCESS_FINE_LOCATIONACCESS_COARSE_LOCATION麦克风RECORD_AUDIO电话READ_PHONE_STATECALL_PHONEREAD_CALL_LOGWRITE_CALL_LOGADD_VOICEMAILUSE_SIPPROCESS_OUTGOING_CALLS传感器BODY_SENSORS短信SEND_SMSRECEIVE_SMSREAD_SMSRECEIVE_WAP_PUSHRECEIVE_MMS存储READ_EXTERNAL_STORAGEWRITE_EXTERNAL_STORAGE4.3 权限使用建议最小权限原则只申请应用必须的权限多余的权限会增加用户疑虑适时申请在真正需要使用功能时再申请权限不要一开始就申请所有权限解释用途在申请权限前用简单明了的语言解释为什么需要这个权限优雅降级当权限被拒绝时应用应该有相应的降级方案而不是完全无法使用测试各种场景用户首次拒绝用户选择拒绝且不再询问权限被系统自动拒绝(如电池优化)从设置中手动关闭权限// 权限检查的完整流程示例 async function requestCameraPermission() { try { await permission.check(android.permission.CAMERA, { guideMessage: 需要相机权限才能使用扫码功能 }) // 权限已授予执行操作 startScan() } catch (err) { if (err instanceof PermissionError) { // 处理权限被拒绝的情况 if (err.deniedPermissions.includes(android.permission.CAMERA)) { showAlternativeOption() } } else { // 处理其他错误 console.error(未知错误:, err) } } }在实际项目中我发现将权限管理封装为独立服务后不仅代码更清晰而且权限相关的变更只需在一处修改。特别是当应用需要适配不同地区的权限要求时这种集中管理的优势更加明显。例如某些地区可能对相机权限有更严格的要求我们可以在权限工具中轻松添加地区适配逻辑而不需要修改各个业务模块。