HarmonyOS:HMPermission权限请求框架

前段时间利用空余时间写了一个权限请求库:HMPermission。

一,简介

HMPermission 是鸿蒙系统上的一款权限请求框架,封装了权限请求逻辑,采用链式调用的方式请求权限,简化了权限请求的代码。

二,使用方法

1,安装

在Terminal 窗口里输入命令行:

复制代码
ohpm i @sy/hmpermission

2,在配置文件中申明权限

在对应模块的module.json5文件中申明权限

复制代码
  "requestPermissions": [
      {
        "name": "ohos.permission.CAMERA",
        "reason": "$string:camera_permission_reason",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "inuse"
        }
      }
    ]

name:权限名称;

reason:申请权限的原因。

说明:申请的权限是user_grant 权限时必填,并且需要做多语言适配

usedScene:权限使用场景。

说明:

  • abilities:使用权限的UIAbility或者ExtensionAbility组件的名称。

  • when:调用时机。可不填,填写时使用固定值"inuse"

注意:已在子模块中申请的权限,无需在主项目重复添加,权限将在整个应用生效。

详细说明请参考官方文档:文档中心

3,动态申请权限(以相机权限为例)

复制代码
private permissions: Array<Permissions> = [
    'ohos.permission.CAMERA'
  ]
private context: common.UIAbilityContext = getContext() as common.UIAbilityContext

HMPermission
     .with(this.context)
     .permission(this.permissions)
     .onGranted(() => {
        console.error(TAG, 'onGranted')
     }).onDenied((deniedArr: Array<Permissions>) => {
        console.error(TAG, 'onDenied deniedArr = ' + JSON.stringify(deniedArr))
     }).request()

permission()方法传入权限数组,支持批量申请权限;

onGranted():用户授权成功回调;

onDenied():用户拒绝授权时回调。回调中会将未同意的权限返回;

申请权限时,会主动校验该权限是否已授权,所以无需再校验是否已授权。如果需要校验是否已授权,可调用校验方法:

复制代码
HMPermission.hasPermission(this.permissions)

用户拒绝授权,如果想在系统设置中引导用户打开授权,可以调用

复制代码
HMPermission.openSystemSettings(this.context)

三,说明

该权限请求库已开源,项目地址,持续更新迭代中,有任何问题欢迎指出。

相关推荐
米羊1216 小时前
【鸿蒙心迹】摸蓝图,打地基
华为·harmonyos
pangtout9 小时前
华为坤灵:点燃中小企业智能化的星火
华为
一天前10 小时前
ArkUI 中实现点击涟漪效果
harmonyos
HarmonyOS_SDK13 小时前
融合多元定位技术,帮助应用破解精准定位难题
harmonyos
安卓开发者18 小时前
鸿蒙Next IPC Kit详解:构建高效进程间通信的完整指南
华为·harmonyos
sdszoe492218 小时前
华为路由基础1
华为·静态路由配置·路由基础
互联网运营观察18 小时前
2025年AI证书报考指南:CAIP/华为/谷歌认证
人工智能·华为
前端世界19 小时前
鸿蒙网络优化实战:从智能切换到缓存加速的完整指南
网络·缓存·harmonyos
安卓开发者19 小时前
鸿蒙NEXT UI Design Kit:打造高端精致界面的新利器
ui·华为·harmonyos
安卓开发者20 小时前
鸿蒙NEXT系统Picker全解析:安全高效的用户资源访问之道
安全·华为·harmonyos