跳到主要内容

申请受限权限

受限开放的权限通常是不允许三方应用申请的。如果有特殊场景需要使用,请提供相关申请材料到应用市场(AppGallery Connect,简称为AGC)申请相应权限证书。

在申请前,请审视是否符合受限权限的使用场景。为避免应用的上架申请被驳回,开发者应优先使用Picker/控件等替代方案,仅少量符合特殊场景的应用被允许申请受限权限。

在应用上架时,应用市场(AGC)将根据应用的使用场景审核是否可以使用对应的受限权限。如检测到应用软件包涉及获取受限权限,应用开发者需为每个受限权限项填写相应的权限说明,并上传视频说明使用场景,详情请见发布HarmonyOS应用

如果应用未申请相应的权限证书,却试图在配置文件中声明此类权限,将会导致应用安装失败。

申请步骤

针对上图中的数字标注,补充说明如下:

  1. 开发者可根据受限开放权限列表,确认自己准备申请的权限,是否受限开放,仅受限开放权限需要经过应用市场审核。

  2. 每个受限开放权限的介绍、可用场景及其建议方案均可参考受限开放权限列表

    开发者必须查询受限开放权限列表确认开发的应用是否符合使用场景,如果不符合要求,应用的上架申请将被驳回

  3. 在应用市场(AGC)侧申请Profile文件并同步申请使用相应受限权限。

    申请的Profile文件,将用于后续的应用签名信息配置。申请Profile的操作需在应用市场(AGC)完成,详细步骤请参阅申请发布Profile

    应用因特殊场景要求使用受限开放权限,请务必在申请发布Profile“添加Profile页面”时,申请使用相应权限,否则应用将在审核时被驳回。

    • 请确保应用申请受限开放权限时提供的场景和功能信息准确。
    • 如果应用内使用的受限开放权限超出您申请的范围,或申请权限后使用的功能和场景超出可使用的范围,将影响您的应用上架。

    • 在调试阶段,除下述方式外,还可以通过DevEco Studio自动签名完成申请。在自动签名的过程中,将由DevEco Studio完成向AGC申请受限权限的步骤,开发者可直接使用,具体请参考自动签名-操作步骤
    • 在发布阶段,必须根据申请发布Profile完成受限权限的手动申请。
  4. 在配置文件中声明权限

  5. 通过权限列表中的“授权方式”字段,判断是否需要用户授权。

  6. (可选)如果权限的授权方式为user_grant(用户授权)时,还需要通过弹窗向用户申请权限