申请使用受限权限
HarmonyOS 5.0.3(15) 版本的配套文档,该版本API能力级别为API 15 Release
文章目录
- 申请步骤
- 在AGC侧申请Profile文件
- 在代码工程中申请权限
受限开放的权限通常是不允许三方应用申请的。如果有特殊场景需要使用,请提供相关申请材料到应用市场(AppGallery Connect,简称为AGC)申请相应权限证书。
在申请前,请审视是否符合受限权限的使用场景。为避免应用的上架申请被驳回,开发者应优先使用Picker/控件等替代方案,仅少量符合特殊场景的应用被允许申请受限权限。
每个受限权限的介绍、可用场景及其建议方案请参考受限开放权限列表。
注意
在应用上架时,应用市场(AGC)将根据应用的使用场景审核是否可以使用对应的受限权限。如检测到应用软件包涉及获取受限权限,应用开发者需为每个受限权限项填写相应的权限说明,并上传视频说明使用场景,详情请见发布HarmonyOS应用。
如果应用未申请相应的权限证书,却试图在配置文件中声明此类权限,将会导致应用安装失败。
申请步骤
说明
在调试阶段,除下述方式外,还可以通过DevEco Studio自动签名完成申请。在自动签名的过程中,将由DevEco Studio完成向AGC申请受限权限的步骤,开发者可直接使用,具体请参考自动签名-操作步骤。但开发者必须查询受限开放权限列表确认开发的应用是否符合使用场景,如果不符合要求,应用的上架申请将被驳回。
在发布阶段,必须根据以下步骤完成受限权限的手动申请。
在AGC侧申请Profile文件
申请的Profile文件,将用于后续的应用签名信息配置。
应用因特殊场景要求使用受限开放权限,请务必在申请发布Profile“添加Profile页面”时,申请使用相应权限,否则应用将在审核时被驳回。受限开放权限可申请的特殊场景请参考受限开放权限列表。
申请Profile的步骤请参考:申请发布Profile
注意
请确保应用申请受限开放权限时提供的场景和功能信息准确。
如果应用内使用的受限开放权限超出您申请的范围,或申请权限后使用的功能和场景超出可使用的范围,将影响您的应用上架。
在代码工程中申请权限
在AGC侧完成上述配置后,开发者还需要根据实际情况在工程中声明权限。
- 在配置文件中声明权限。
- (可选)如果权限的授权方式为user_grant(用户授权)时,需要通过弹窗向用户申请权限。