十六、【鸿蒙 NEXT】如何申请权限

【前言】

在开发过程中经常会需要申请一些权限，才能调用一些系统接口，比如相机、获取位置信息等，一般按照授权类型，分为system_grant系统授权、user_grant用户授权、和manual_setting（手动设置授权）。本章主要讲下这几种授权如何实现

一、system_grant系统授权

系统授权由于不涉及用户个人数据，因此，只需要在module.json5的配置文件中声明权限后，系统会在用户安装应用时自动授予相应的权限。如下在module.json5中声明即可，系统权限类型参考，比如网络访问权限等。

二、user_grant用户授权

用户授权分为两步一是在module.json5中声明权限，二需要弹窗向用户授权

1、modue.json5声明权限

如下，name字段是权限名称，参考这里，reason是授权的目的，这个字段的内容，会在调用系统弹窗时展示在弹窗中，abilities表示在应用的那个uiability用到，when字段目前是预留字段，无实际作用

2、在代码中调用系统接口，向用户弹窗授权

主要分为3步骤：

（1）校验权限是否已经授权（调用接口checkAccessToken）

（2）未授权时弹出窗口授权（调用接口requestPermissionsFromUser，该接口只有首次授权时弹窗）

（3）如果用户首次授权拒绝后，二次提示用户弹窗（调用接口requestPermissionOnSetting）

完整代码实现如下

javascript 复制代码

import { abilityAccessCtrl, bundleManager, Permissions } from "@kit.AbilityKit";

export class PermissionUtils {
  public static async requestPermission(permission:Permissions) {
    // 1、校验权限是否已经授权
    let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
    let grantStatus: abilityAccessCtrl.GrantStatus = abilityAccessCtrl.GrantStatus.PERMISSION_DENIED;
    let tokenId: number = 0;
    let bundleInfo: bundleManager.BundleInfo = await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION);
    let appInfo: bundleManager.ApplicationInfo = bundleInfo.appInfo;
    tokenId = appInfo.accessTokenId;
    grantStatus = await atManager.checkAccessToken(tokenId, permission).catch(() => { return abilityAccessCtrl.GrantStatus.PERMISSION_DENIED });
    if (grantStatus === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
      console.log('checkAccessToken is granted')
      return
    }
    // 2、未授权情况下，使用requestPermissionsFromUser向用户弹窗授权（只有首次授权时有弹窗）
    let data = await atManager.requestPermissionsFromUser(getContext(), [permission])
    let grantResult: number[] = data.authResults;
    grantStatus = grantResult[0]
    if (grantStatus  === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
      console.log('requestPermissionsFromUser is granted')
      return
    }
    // 这里判断requestPermissionsFromUser是否有弹窗，如果有弹窗，则不再二次弹窗
    if (data.dialogShownResults?.[0] === true) {
      console.log('requestPermissionsFromUser is dialogShown')
      return false
    }
    // 3、后续二次授权弹窗
    let onSettingData = await atManager.requestPermissionOnSetting(getContext(), [permission])
    return onSettingData[0] === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED
  }
}

实现效果如下：

三、手动授权，跳转到系统设置页

最后一种是直接跳转到系统设置页面，让用户手动授权

javascript 复制代码

  public static goToSetting() {
    let bundleInfo = bundleManager.getBundleInfoForSelfSync(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION)
    let want:Want = {
      bundleName: 'com.huawei.hmos.settings',
      abilityName:'com.huawei.hmos.settings.MainAbility',
      uri:'application_info_entry',
      parameters: {
        pushParams: {
          bundleName:bundleInfo.name
        }
      }
    }
    let context = getContext() as common.UIAbilityContext
    context.startAbility(want)
  }

其中uri = 'application_info_entry'表示应用的设置页面，更多uri参考