OpenHarmony应用开发权限申请

在开发应用时，经常需要配置应用的权限，以便实现对系统资源的访问。本文对如何在 OpenHarmony 系统中配置应用权限，以及权限的等级进行归纳总结。

一、权限及其等级介绍：

在申请目标权限前，我们需要先阅读访问控制开发概述-权限的工作流程，对权限的工作流程有基本的了解后，再结合以下权限的具体说明，判断应用能否申请目标权限。

官方应用开发文档应用权限列表链接：https://docs.openharmony.cn/page ... /permission-list.md

浏览应用权限列表，对每一个应用权限的介绍如下，例如，

####################################
ohos.permission.USE_BLUETOOTH    （权限名称）

允许应用查看蓝牙的配置。           （权限常用的场景）

权限级别：normal                       （权限级别APL（Ability Privilege Level））

授权方式：system_grant               （授权方式）

ACL使能：TRUE                            （是否能够通过ACL授权）

起始版本：8

#####################################

1、权限级别：

权限的等级分为normal、system_basic和system_core三个等级，这与应用的APL（Ability Privilege Level）等级分为normal、system_basic和system_core是对应。默认情况下，应用的APL等级都为normal等级。normal等级是应用权限最低的等级，当应用处于normal等级时，无法申请system_basic和system_core等级的权限；system_core等级是应用权限最高的等级，其次是system_basic，当应用处于system_core等级时，可以申请system_basic和normal等级的权限。
（1）修改应用的APL等级，首先找到openharmony的SDK存放的目录，本文以API10为例，找到API10 文件在电脑存放的路径，如...\10\toolchains\lib  进入到相应的lib文件夹中，找到UnsgnedReleasedProfileTemplate.json文件，用记事本或者其他工具打开，找到如下代码处，
###################################

"bundle-name":"**************",
        "apl":"normal",
        "app-feature":"hos_normal_app"
###################################
修改“apl”对应的值，如将“normal”改为“system_core”，将文件保存，退出，同时DevEco Studio中打开的工程需要同步刷新，并重新签名，使得后续打开或者新建的工程应用处于最高级，可以申请任何等级的权限。

2、授权方式

根据授权方式的不同，权限授权类型可分为system_grant（系统授权）和user_grant（用户授权）。ystem_grant（系统授权）意味着，当在申请权限的配置文件申请权限后，直接重新签名编译后，直接通过使用即可；user_grant（用户授权）：当在申请权限的配置文件申请权限后，还需要调用接口@ohos.abilityAccessCtrl，使用 requestPermissionsFromUser() 方法请求相应的权限使得在首次使用该应用时，使用动态弹框授权方式，为用户提供手动授权的入口，拉起以UI界面询问用户是否同意开启该权限，只有用户点击同意开权限，才可以算正式开通并使用

3、ACL授权

当应用的APL（Ability Privilege Level）等级较低，却想申请一个较高应用等级的权限时，如应用的默认权限等级为normal，当应用需要申请system_basic和system_core等级的权限时，有两种方法。
（1）提高应用权限等级APL（Ability Privilege Level)，即1.（1）中的方法，去修改应用对应等级；
（2）查看该权限是否能够通过ACL授权，“ACL使能：TRUE /FALSE”是为true表示可以进行ACL使能，不用修改应用权限等级APL，而申请等级更高权限，具体方法：
首先找到openharmony的SDK存放的目录，本文以API10为例，找到API10 文件在电脑存放的路径，如...\10\toolchains\lib  进入到相应的lib文件夹中，找到UnsgnedReleasedProfileTemplate.json文件，用记事本或者其他工具打开，找到如下代码处，

###################################

"acls":{
        "allowed-acls":[
            "************",
            "***********"
        ]
    },

###################################

在 "allowed-acls"参数数组中，填上需要进行跨等级（ACL授权）授权的权限名称，将文件保存，退出，同时DevEco Studio中打开的工程需要同步刷新，并重新签名。

4、系统应用

在应用开发时，在调用某些接口时，会提醒需要申请那些权限，并告知只允许系统应用调用。

那么我们需要将应用设置为系统应用，具体方法：
打开OpenHarmony SDK所在目录（可通过DevEco Studio菜单栏中单击File > Settings > OpenHarmony SDK界面查看 ）。在SDK目录下，进入Toolchains > {Version} > lib文件夹，打开“UnsignedReleasedProfileTemplate.json”文件。

本文以API10为例，找到API10 文件在电脑存放的路径，如...\10\toolchains\lib  进入到相应的lib文件夹中，找到UnsgnedReleasedProfileTemplate.json文件，用记事本或者其他工具打开，找到如下代码处，

###################################

"bundle-name":"**************",
        "apl":"normal",
        "app-feature":"hos_normal_app"
###################################
修改“app-feature”对应的值，如将“hos_normal_app”改为“hos_system_app”，将文件保存，退出，同时DevEco Studio中打开的工程需要同步刷新，并重新签名，使得后续打开或者新建的工程应用处于系统应用。

参考：1、https://docs.openharmony.cn/page ... F%E5%A3%B0%E6%98%8E
2、https://docs.openharmony.cn/page ... 8%E7%BB%93%E6%9E%84

二、申请权限流程：

1、配置文件声明权限

以stage模型为例：
在开始使用某个权限之前，我们需要在应用的配置文件module.json5配置文件中声明所需的权限。打开应用的配置文件，位置通常src/main/module.json5
如：

"requestPermissions": [
      {
        "name": "ohos.permission.READ_IMAGEVIDEO"
      }
    {
        "name": "**********************"
      }    ]

其中，"requestPermissions"与"abilities"是"module"同一等级的参数，可能需要自己添加。
申请时，需要清楚所申请权限的等级，是否需要修改应用等级APL等。

2、是否需要动态授权

权限授权类型可分为system_grant（系统授权）和user_grant（用户授权）。若为system_grant（系统授权），则只在配置文件中声明所需的权限，系统自动授权。

当应用需要访问用户的隐私信息或使用系统能力时，涉及的权限 授权方式通常为user_grant 类型，需要调用接口@ohos.abilityAccessCtrl，使用 requestPermissionsFromUser() 方法请求相应的权限，

参考链接：https://docs.openharmony.cn/page ... e%E6%A8%A1%E5%9E%8B

三、总结

我们可以在 OpenHarmony 系统中配置应用的权限。首先，在应用的配置文件中声明所需的权限，并根据所申请的权限的等级，是否要进行修改应用等级，包括APL和是否设为系统应用；然后，在应用的代码中请求权限，如果权限授权方式为user_grant（用户授权），则需要在代码中额外拉起动态窗请求用户授权，若为system_grant（系统授权），则只在配置文件中声明所需的权限，系统自动授权；最后，根据权限请求结果进行相应的处理。

          欢迎请作者喝杯咖啡，你的鼓励是小编继续的动力