选择申请权限的方式

应用访问数据或执行操作时,需评估是否需要相关权限。如需权限,应在应用安装包中申请。

每个权限的等级和授权方式不同,因此申请权限的方式也不同。申请权限前,开发者需要:

  1. 确认目标权限的权限类型,可通过权限列表页面检索确认。
  2. 参考操作路径,申请相应的权限。

根据目标权限的开放范围和授权方式,开发者可以参考以下操作路径申请权限。

normal等级应用申请权限的方式

权限类型 授权方式 操作路径
开放权限(系统授权) system_grant 声明权限 > 访问接口
开放权限(用户授权) user_grant 声明权限 > 向用户申请授权 > 访问接口
允许通过ACL申请的系统权限(系统授权)
受限开放权限
system_grant 申请使用受限权限 > 声明权限 > 访问接口
允许通过ACL申请的系统权限(用户授权)
受限开放权限
user_grant 申请使用受限权限 > 声明权限 > 向用户申请授权 > 访问接口

说明:

  • 如果system_basic等级的权限,ACL使能为false,则normal等级应用无法申请该权限。
  • 当前可通过DevEco Studio完成ACL方式跨级别申请权限,但该方法仅用于应用调试阶段使用,不可用于发布上架应用市场。如果需要开发商用版本的应用,请在对应的应用市场进行发布证书和Profile文件的申请。

system_basic等级应用申请权限的方式

权限等级 授权方式 ACL使能 操作路径
normal、system_basic system_grant - 声明权限 > 访问接口
normal、system_basic user_grant - 声明权限 > 向用户申请授权 > 访问接口
system_core system_grant true 申请使用受限权限 > 声明权限 > 访问接口
system_core user_grant true 申请使用受限权限 > 声明权限 > 向用户申请授权 > 访问接口

如果应用需要将自身的APL等级声明为system_basic及以上,在开发应用安装包时,需要修改应用的HarmonyAppProvision配置文件,即SDK目录下的“Toolchains / _{Version} _/ lib / UnsgnedReleasedProfileTemplate.json”文件,并重新进行应用签名。

修改方式如下:

HarmonyAppProvision配置文件示例如下所示,修改"bundle-info"中的"apl" 字段。

"bundle-info" : {
    // ...
    "apl": "system_basic",
    // ...
},

说明:

直接修改HarmonyAppProvision配置文件仅限应用调试阶段,不可用于发布上架应用市场。商用版本应用需在对应应用市场申请发布证书和Profile文件。