更新记录

1.0.5（2026-06-11）下载此版本

增加一条正常中文更新记录，用于覆盖 DCloud 公开页默认展示范围内的早期乱码历史。
保持权限检测、运行时权限申请、通知权限、所有文件权限和系统设置页跳转 API 不变。
保持免费广告解锁下载策略和市场预览截图不变。

1.0.4（2026-06-11）下载此版本

再次通过 DCloud uni_modules 更新日志字段提交正常中文记录，确保公开页最近两条更新记录不再显示乱码。
保持权限检测、运行时权限申请、通知权限、所有文件权限和系统设置页跳转 API 不变。
保持免费广告解锁下载策略和市场预览截图不变。

1.0.3（2026-06-11）下载此版本

修复公开页更新记录乱码问题，改用 DCloud uni_modules 更新日志字段提交正常中文记录。
保持权限检测、运行时权限申请、通知权限、所有文件权限和系统设置页跳转 API 不变。
保持免费广告解锁下载策略和预览截图不变。

平台兼容性

uni-app(3.97)

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

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

uni-app x(3.97)

Chrome	Safari	Android	iOS	鸿蒙	微信小程序
-	-	-	-	-	-

权限检测与设置跳转 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 系列其他插件使用。