更新记录

1.0.3（2025-01-17） 下载此版本

完善demo

1.0.2（2025-01-16） 下载此版本

完善文档

1.0.1（2025-01-15） 下载此版本

更新文档

平台兼容性

permission-handler

介绍

permission-handler 是一款支持iOS/Android/HarmonyOS(待发布) 的权限申请插件

使用方法

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. 未配置权限会直接返回denied