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)

三,说明

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

相关推荐
codefish7983 小时前
鸿蒙开发学习之路:从入门到实践的全面指南
harmonyos
yrjw9 小时前
一款基于react-native harmonyOS 封装的【文档】文件预览查看开源库(基于Harmony 原生文件预览服务进行封装)
harmonyos
小徐不徐说16 小时前
每日一算:华为-批萨分配问题
数据结构·c++·算法·leetcode·华为·动态规划·后端开发
搜狐技术产品小编20231 天前
搜狐新闻直播间适配HarmonyOs实现点赞动画
华为·harmonyos
zhanshuo1 天前
ArkUI 玩转水平滑动视图:超全实战教程与项目应用解析
harmonyos·arkui
zhanshuo1 天前
ArkUI Canvas 实战:快速绘制柱状图图表组件
harmonyos·arkui
zhanshuo2 天前
手把手教你用 ArkUI 写出高性能分页列表:List + onScroll 实战解析
harmonyos
zhanshuo2 天前
深入解析 ArkUI 触摸事件机制:从点击到滑动的开发全流程
harmonyos
i仙银2 天前
鸿蒙沙箱浏览器 - SandboxFinder
app·harmonyos
Georgewu2 天前
【HarmonyOS】鸿蒙应用开发中常用的三方库介绍和使用示例
harmonyos