鸿蒙开发:申请授权权限

简介: 还是那句话,在申请权限的时候,应当严格遵循最小权限原则,结合动态申请和清晰的用户引导,避免给用户带来不好体验,同样,遵循,在使用到权限的时候再去申请,切记,过前进行申请。

前言


本文基于Api13。


通过前面两章的概述,关于权限的基本知识点已经概述的七七八八了,那么本篇文章,我们着重概述一下如何去申请权限。


问大家一个问题,向用户进行权限授权,是哪种授权方式呢?显然谜底就在谜面上,采用的是user_grant(用户授权)方式,当应用进行申请user_grant权限时,有以下两个步骤是必须要完成的。

1、在module.json5配置文件的requestPermissions标签中声明权限。

2、将应用中需要申请权限的目标对象与对应目标权限进行关联,让用户明确地知道,哪些操作需要用户向应用授予指定的权限。


约束限制


首先第一个,user_grant权限授权必须要让用户清晰知晓,需要在应用运行时,在需要的位置进行权限申请,不可未使用时就申请,比如一个拍照,需要调用系统的相机,不是一进入应用就直接申请,而是等到需要拍照权限的时候,再去申请。

第二个,申请权限的时候,如果用户拒绝授权了,这时是无法再次拉起弹窗的,这时需要正确的引导用户在系统应用“设置”的界面中手动授予权限。


第三个,系统权限弹窗优先级是最高的,不可被遮挡,弹窗信息需要完整展示,以便用户识别并完成授权动作。


第四个,每次要进行权限授权时,首先都必须要检查一下,是否拥有该权限,如果没有再去走申请逻辑。


第五个,如果是在onWindowStageCreate()回调中申请授权时,需要等待异步接口loadContent()/setUIContent()执行结束后或在loadContent()/setUIContent()回调中进行权限申请,否则在Content加载完成前,再申请权限时会调用失败。


权限申请流程


我们以申请相机的权限作为代码案例,看一下权限授权的流程。


1、权限声明


module.json5中进行配置。

"requestPermissions": [
      {
        "name": "ohos.permission.CAMERA",
        "reason": "$string:reason",
        "usedScene": {
          "abilities": [
            "EntryAbility"
          ],
          "when": "always"
        }
      }
    ]


2、检查授权


使用checkAccessToken()异步函数或者checkAccessTokenSync同步函数,检查用户是否已经授予了权限。

/**
   *AUTHOR:AbnerMing
   *INTRODUCE:校验应用是否被授予权限
   */
  private getGrantStatus(permissionName: Permissions): abilityAccessCtrl.GrantStatus {
    let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager()
    // 获取应用程序的accessTokenID
    let bundleInfo = bundleManager.getBundleInfoForSelfSync(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION)
    let appInfo: bundleManager.ApplicationInfo = bundleInfo.appInfo
    let tokenId: number = appInfo.accessTokenId
    //检查权限状态
    let grantStatus = atManager.checkAccessTokenSync(tokenId, permissionName)
    return grantStatus
  }


以上的方法,会返回PERMISSION_GRANTED或PERMISSION_DENIED两个状态:


名称

说明

PERMISSION_DENIED

-1

表示未授权。

PERMISSION_GRANTED

0

表示已授权。


3、向用户申请授权


使用requestPermissionsFromUser()函数,来请求相应的权限:


/**
   *AUTHOR:AbnerMing
   *INTRODUCE:向用户获取权限授权
   */
  requestPermissionsFromUser(permissions: Array<Permissions>) {
    let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager()
    atManager.requestPermissionsFromUser(getContext(), permissions)
      .then((data) => {
        let grantStatus: Array<number> = data.authResults;
        let length: number = grantStatus.length;
        for (let i = 0; i < length; i++) {
          if (grantStatus[i] === 0) {
            // 用户授权,可以继续访问目标操作
            console.log("===用户授权")
          } else {
            // 用户拒绝授权,提示用户必须授权才能访问当前页面的功能,并引导用户到系统设置中打开相应的权限
            console.log("===用户拒绝了授权")
            return
          }
        }
        console.log("===权限授权成功")
      })
  }


检查权限流程:


/**
   *AUTHOR:AbnerMing
   *INTRODUCE:检查用户权限
   */
  checkPermissions() {
    let permission: Permissions = "ohos.permission.CAMERA"
    let grantStatus = this.getGrantStatus(permission)
    if (grantStatus == abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
      //已有权限
      console.log("===已有权限")
    } else {
      //申请权限
      console.log("===没有权限,需要申请权限")
      this.requestPermissionsFromUser([permission])
    }
  }


运行程序后,就会弹出如下的权限申请弹窗,此弹窗是系统的,不可修改。


image.png

4、处理授权结果


如果权限已经授权,在这里可以执行后续的正常功能,如果权限未授权,我们可以继续给用户进行提示,让用户去系统应用“设置”中打开相应的权限,路径是:设置 > 隐私 > 权限管理 > 应用 > 目标应用。

一般我们可以调用requestPermissionOnSetting(),进行权限的二次授权。

/**
   *AUTHOR:AbnerMing
   *INTRODUCE:二次向用户申请授权
   */
  private requestPermissionOnSetting(permissions: Array<Permissions>) {
    abilityAccessCtrl.createAtManager().requestPermissionOnSetting(getContext(), permissions)
      .then((data: Array<abilityAccessCtrl.GrantStatus>) => {
        if (data[0] == abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
          //已有权限
          console.log("===已有权限")
        }
      })
  }


image.png


相关总结


还是那句话,在申请权限的时候,应当严格遵循最小权限原则,结合动态申请和清晰的用户引导,避免给用户带来不好体验,同样,遵循,在使用到权限的时候再去申请,切记,过前进行申请。


目录
打赏
0
3
3
0
186
分享
相关文章
鸿蒙开发:了解分割线
在实际的开发中,如果自带的分割线能够满足我们的需求,以自身的分割线属性为主,如果不满足,我们可以使用组件进行绘制。
61 16
鸿蒙开发:了解分割线
一文彻底拿下HarmonyOS NEXT开发实战调试技巧
这是一篇关于HarmonyOS NEXT开发调试技巧的文章,作者是一名经验丰富的程序员Feri。内容涵盖三种调试方法:预览+日志方式(适合简单调试,需注意数据类型转换)、断点调试(详细介绍了设置步骤与功能键使用)以及hilog实战使用(日志打印限制为4096字节,推荐封装维护)。通过这些技巧,帮助开发者更高效地解决问题,提升编程能力。
56 14
一文彻底拿下HarmonyOS NEXT开发实战调试技巧
HarmonyOS Next~鸿蒙应用框架开发实战:Ability Kit与Accessibility Kit深度解析
本书深入解析HarmonyOS应用框架开发,聚焦Ability Kit与Accessibility Kit两大核心组件。Ability Kit通过FA/PA双引擎架构实现跨设备协同,支持分布式能力开发;Accessibility Kit提供无障碍服务构建方案,优化用户体验。内容涵盖设计理念、实践案例、调试优化及未来演进方向,助力开发者打造高效、包容的分布式应用,体现HarmonyOS生态价值。
53 27
HarmonyOS Next~鸿蒙AI功能开发:Core Speech Kit与Core Vision Kit的技术解析与实践
本文深入解析鸿蒙操作系统(HarmonyOS)中的Core Speech Kit与Core Vision Kit,探讨其在AI功能开发中的核心能力与实践方法。Core Speech Kit聚焦语音交互,提供语音识别、合成等功能,支持多场景应用;Core Vision Kit专注视觉处理,涵盖人脸检测、OCR等技术。文章还分析了两者的协同应用及生态发展趋势,展望未来AI技术与鸿蒙系统结合带来的智能交互新阶段。
51 31
鸿蒙开发:刷新库V2装饰器适配
如果你是新写的项目,建议直接上手V2装饰器,即便是已经存在的项目,对于新的模块,也是尽量以V2为主。
鸿蒙开发:刷新库V2装饰器适配
|
5天前
|
鸿蒙开发:填充剩余空间
关于占满剩余的空间,如果权重能够解决,还是以权重为主,因为Blank的使用必须父组件的宽高有值,否则就会不生效,当然了,在实际的开发中,还是具体问题具体分析,使用恰当的方式解决为主。
鸿蒙开发:填充剩余空间
|
1天前
|
鸿蒙开发:openCustomDialog关闭指定Dialog
以上呢就是两种隐藏指定的Dialog方式,比较的简单,具体的场景,常见于,页面多个弹出Dialog,但是需要隐藏指定的Dialog场景,当然了,也适用于常见的普通场景。
26 14
|
2天前
鸿蒙开发:正则中的match和matchAll
在实际的开发中,match和matchAll是两个非常常见的的正则表达式方法;match方法适用于简单的匹配操作,而matchAll方法则适用于需要获取所有匹配结果及其捕获组的场景。
鸿蒙开发:正则中的match和matchAll
鸿蒙相机开发实战:从设备适配到性能调优 —— 我的 ArkTS 录像功能落地手记(API 15)
本文分享鸿蒙相机开发经验,从环境准备到核心逻辑实现,涵盖权限声明、模块导入、Surface关联与分辨率匹配,再到录制控制及设备适配法则。通过实战案例解析,如旋转补偿、动态帧率调节和编解码优化,帮助开发者掌握功能实现、设备适配与体验设计三大要点,减少开发坑点。适合鸿蒙新手及希望深化硬件交互能力的工程师参考收藏。
31 2
|
1天前
|
鸿蒙开发:父组件如何调用子组件中的方法?
也许大家可能会有疑问,子组件更新UI,直接由装饰器触发不就行了,希望大家能够明白,以上呢只是简单的案例,在实际的开发中,子组件方法中可能很多的逻辑,比如网络请求,比如数据存储等等,并不是简单的UI更新。