更新记录

1.0.0（2026-06-05）下载此版本

棣娆″甯��妫ü娴涓璁剧疆椤佃烦杞�浠躲ü
�� Android ��缁妫ü�ャü杩琛�舵��宠��ü�ü�ユ��ü�ü��浠惰��妫ü娴�璁剧疆椤佃烦杞�ü
�浠舵缃缁�ü� 涓浼 �ü� 骞垮 SDK锛�ü�浣涓哄璐瑰�娴�浠躲ü

平台兼容性

uni-app(3.97)

Vue2	Vue3	Chrome	Safari	app-vue	app-nvue	Android	iOS	鸿蒙
√	√	×	×	√	×	5.0	×	×

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	小红书小程序	快应用-华为	快应用-联盟
×	×	×	×	×	×	×	×	×	×	×	×

uni-app x(3.97)

Chrome	Safari	Android	iOS	鸿蒙	微信小程序
×	×	5.0	×	×	×

权限检测与设置跳转 UTS 插件

JQ-PermCheck-UTS 是一个面向 uni-app / uni-app x 的权限辅助插件，提供权限分组解析、运行时权限检查/申请、通知权限检测、所有文件访问权限检测和系统设置页跳转。

插件自身不包含广告 SDK、不包含网络请求、不上传数据、不声明 android.permission.INTERNET。适合作为免费广告解锁下载插件，为相机、扫码、文件、通话短信、保活等原生能力插件做接入前检测。

适合场景

接入扫码、相机、定位、录音、通知等能力前先检测权限。
用户拒绝权限后跳转应用设置页。
Android 13+ 检查通知权限。
Android 11+ 检查所有文件访问权限。
在 demo 中快速判断当前基座/APK 是否真的声明了目标权限。

安装

在 DCloud 插件市场导入 JQ-PermCheck-UTS。
确认项目中存在 uni_modules/JQ-PermCheck-UTS。
在 manifest.json 中声明业务实际需要的权限。
App 启动后先完成隐私弹窗，再调用权限申请 API。

快速接入

import {
  checkPermissions,
  requestPermissions,
  openAppSettings
} from '@/uni_modules/JQ-PermCheck-UTS'

const check = checkPermissions({ group: 'camera' })
console.log(check)

requestPermissions({ group: 'camera' }, (res) => {
  console.log(res)
})

openAppSettings()

权限分组

group	Android 权限
`camera`	`CAMERA`
`microphone` / `record`	`RECORD_AUDIO`
`location`	`ACCESS_FINE_LOCATION`、`ACCESS_COARSE_LOCATION`
`storage` / `files`	Android 13+ 媒体读取权限，旧系统为 `READ_EXTERNAL_STORAGE` / `WRITE_EXTERNAL_STORAGE`
`notification`	Android 13+ `POST_NOTIFICATIONS`
`phone`	电话状态、通话记录、拨号等常用电话权限
`sms`	短信读取、接收、发送权限
`contacts`	联系人读取、写入权限
`all`	常用基础分组，不包含所有文件访问特殊权限

也可以直接传权限数组：

requestPermissions({
  permissions: [
    'android.permission.CAMERA',
    'android.permission.ACCESS_FINE_LOCATION'
  ]
}, callback)

API

getPlatformInfo()

返回当前平台、系统版本、支持能力等信息。

checkPermissions(options)

检查权限是否已授予。

requestPermissions(options, callback)

申请 Android 运行时权限。回调中返回 grantedList、deniedList、allGranted、doNotAskAgain。

openAppSettings()

跳转当前应用详情设置页，适合用户勾选“不再询问”后手动开启权限。

checkNotificationPermission()

Android 13+ 检查通知权限；低版本直接返回已具备。

openNotificationSettings()

跳转应用通知设置页。

checkAllFilesPermission()

Android 11+ 检查所有文件访问权限。该权限不是普通运行时权限，不能通过 requestPermissions 弹窗申请。

openAllFilesPermissionPage()

跳转所有文件访问设置页。如果开关不可点击，通常表示当前基座/APK 未声明 MANAGE_EXTERNAL_STORAGE，需要自定义基座或云打包包。

标准基座说明

HBuilderX 标准基座不一定声明你的业务权限。标准基座中 checkPermissions 或 requestPermissions 失败，不代表插件不可用；请用自定义基座或云打包后的测试包验证真实权限链路。

隐私说明

插件不包含网络请求。
插件不上传、不存储权限状态。
权限结果只返回给调用方应用。
插件自身不声明 INTERNET 权限。

引流建议

免费版可配置 DCloud 市场广告解锁下载。需要扫码、文件选择、设备标识、通话短信监听、保活等具体业务能力时，可配合 JQ 系列其他插件使用。