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)

三,说明

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

相关推荐
爱写Bug的浮游1 小时前
初识仓颉:5 分钟看懂核心语法
harmonyos·编程语言
羽落•无痕(苏晗默)4 小时前
华为数通IA——14、网络服务与应用:TCP/UDP 传输层协议与 FTP、Telnet、SSH 实践
网络·网络协议·tcp/ip·网络安全·华为·udp·信息与通信
程序猿追14 小时前
鸿蒙 PC 的 Ionic 工单有两个错误,按下生成后光标该去哪儿
华为·harmonyos
KevinChaos18 小时前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
Sirius_Ji1 天前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户86194177207411 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白1 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方2 天前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追2 天前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追2 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos