目录

HarmonyOS应用在开发者中心申请ACL受限权限与Profile配置流程及常见问题解决说明

问题现象

场景一:应用因特殊场景要求需要使用受限开放权限时,开发者不清楚在HarmonyOS 开发者中心平台申请ACL受限权限及配置Profile的完整规范流程。

场景二:在HarmonyOS 开发者中心新建调试或发布Profile添加ACL权限时,遇到无法按需勾选(只能全选或不选)、全选ACL权限后添加设备ID时出现权限校验不通过的报错弹窗,以及遇到已申请过的ACL权限呈置灰且默认选中状态、无法手动修改的情况。

背景知识

解决方案

在申请前,请审视是否符合受限权限的使用场景。为避免应用的上架申请被驳回,开发者应优先使用Picker/控件等替代方案,仅少量符合特殊场景的应用被允许申请受限权限。如果应用未申请相应的权限证书,却试图在配置文件中声明此类权限,将会导致应用安装失败。

场景一:应用因特殊场景要求需要使用受限开放权限时,需按照以下规范流程在HarmonyOS 开发者中心平台申请ACL受限权限及配置Profile。

  1. 在HarmonyOS 开发者中心申请权限:HarmonyOS 开发者中心会根据应用/元服务的使用场景审核是否可以使用对应的权限,可参考申请ACL权限。
  2. 创建调试Profile(避坑指南):ACL权限审核等待期间,可以创建试用调试Profile来提前试用申请的权限。需注意试用调试Profile有效期为5天,到期即失效,且一个应用/元服务最多支持创建5个试用调试Profile。
  3. 申请发布Profile(避坑指南):在发布阶段,必须手动申请受限权限。请在申请发布Profile"添加Profile页面"时,务必手动勾选申请使用相应权限,否则应用将在审核时被驳回。申请Profile的步骤可参考申请发布Profile。
  4. 在代码工程中申请权限:在HarmonyOS 开发者中心侧完成上述配置后,开发者还需要根据实际情况在工程中声明权限。

场景二:在HarmonyOS 开发者中心新建调试或发布Profile添加ACL权限时,若遇到无法按需勾选、全选报错或权限置灰等问题,请参考以下排查与解答。

常见FAQ

Q:申请ACL受限权限被拒绝后该如何处理?

A:权限申请在HarmonyOS 开发者中心平台“开发者管理 > ID、证书和Profile > APP ID > ACL权限”中选择需要的权限进行申请,请按需申请。如果申请被拒绝,建议重新审视应用场景是否符合受限权限的使用条件,并优先考虑使用Picker/控件等替代方案实现功能需求。

Q:如何在Profile上取消不需要的ACL权限?

A:Profile中无法移除不使用的ACL权限。审核通过后,后续创建Profile时,所有获取的权限都将全部写入Profile内,以防止应用/元服务打包上架时因缺少相关配置导致被驳回。权限全部写入不会影响后续的传包及上架流程。如需移除某个ACL权限,可在工程的module.json5中去除该权限的使用声明,重新打包后构建出的应用即不带该权限。