更新记录

1.0.1（2025-02-04）

更新Demo工程

1.0.0（2025-02-04）

适配Android、iOS和HarmonyOS Next

平台兼容性

permission-handler

介绍

permission-handler-plus 是一款支持iOS/Android/HarmonyOS 的权限申请插件

免费版permission-handler(不支持HarmonyOS Next)

使用方法

import {
    checkPermission, requestPermissions
} from '@/uni_modules/permission-handler';

requestLocation() {
    checkPermission('Location', (result) => {
        console.log(result)
        if (result == "denied") {
            requestPermissions({
                names: ['Location'],
                success: (result) => {
                    console.log(result)
                },
                fail:(error) => {
                    console.log(error)
                }
            })
        }
    })
}

参数及结果说明：

权限状态说明

PermissionStatus: string

权限列表说明

name: string

请求权限 requestPermissions

/// 请求权限
requestPermissions({
    names: ['Location', 'Calendar'],
    success: (result) => {
        /// 请求结果
        /// result: {
        ///     'Location' : 'granted',
        ///     'Calendar' : 'denied'
        /// }
        console.log(result)
    },
    fail:(error) => {
        /// 请求异常
        /// error: {
        ///     'code' : '错误码',
        ///     'msg' : '错误原因'
        /// }
        console.log(error)
    }
})

注意

1. 为了不影响应用上架应用商店，插件自身不添加配置任何权限，应用使用到哪些权限就在项目的manifest.json中配置哪些权限，不使用尽量不添加
2. 真机调试 HbuilderX 需要配置各平台运行环境配置
3. 真机调试Android需要自定义基座，除了基座自带权限，添加新的权限后调试需要重新打包新基座，否则相当于没有配置权限，iOS不需要自定义基座。
4. Android targetSDK 请设置不低于28。
5. HarmonyOS Next 权限与iOS和Android相比差别更大一些，很多权限只需声明不需要动态申请，如Notification等，并且对用户访问数据权限控制更严格如剪切板、本地文件、通讯录等，需要在开发平台下配置或者审核才能够正常使用，详情参考HarmonyOS Next 应用权限管控
6. 未配置权限会直接返回denied