一、前提条件
| 条件 | 说明 |
|---|---|
| 场景 | 申请前需参考官方: 受限开放权限列表,确保应用场景满足条件 |
| 限制 | 目前海外仅支持亚太和欧洲地区申请ACL权限,其他区域暂不开放 |
二、申请ACL权限
2.1 进入ACL权限页面
登录AppGallery Connect,点击"开发与服务"
在项目列表中找到项目,点击选择需申请ACL权限的应用/元服务
在"项目设置"页面,选择"ACL权限"页签
注意:若没有找到"ACL权限"页签,请重新创建新的HarmonyOS应用/元服务。
2.2 申请权限
仔细阅读注意事项后勾选"我已知晓"
选择需申请的权限,点击"申请"
申请规则:
一次最多可勾选申请30条权限
一次申请多个权限,审核结果需等到所有权限审核完毕才返回
必须等到本次申请审核结束,才可以提交新的权限申请
2.3 注意事项
| 注意事项 | 说明 |
|---|---|
| 申请前置条件 | 确保应用场景满足申请该权限的条件 |
| 设备类型匹配 | 软件包声明的设备类型范围不能超出权限支持的设备类型范围,否则导致安装失败 |
| 使用范围 | 权限超出申请范围或使用场景超出范围,将影响调试或上架 |
2.4 填写申请信息
不同ACL权限的申请界面存在差异:
类型一:需提交申请原因及附件
| 字段 | 说明 |
|---|---|
| 申请原因 | 必填,不超过256个字符(部分权限有模板要求) |
| 上传附件 | 选填,1个附件,≤500MB(支持文本/表格/图片/视频/压缩包) |
类型二:需提交使用场景说明
| 字段 | 说明 |
|---|---|
| 使用场景 | 必填,选择符合实际的场景 |
| 申请原因 | 若无合适场景,选"例外场景"并提供具体说明 |
| 上传附件 | 选填,1个附件,≤500MB |
2.5 创建试用调试Profile
提交ACL权限申请后,会弹出提示框,可选择创建试用调试Profile来提前试用申请的权限。
备注:
此入口为创建试用调试Profile的唯一途径,一旦关闭无法恢复
如未弹出提示框,请核实账号角色是否已获取"访问调试类证书"权限
2.6 审核状态
| 状态 | 说明 |
|---|---|
| 审核中 | 权限申请正在审核,审核时长在申请页面展示 |
| 已通过 | 审核通过,权限可用 |
备注:审核结果通过互动中心消息和邮件发送。
三、创建试用调试Profile
| 条件 | 说明 |
|---|---|
| 必须提交ACL权限申请 | 不支持直接创建试用调试Profile |
| 数量限制 | 每个应用最多支持创建5个试用调试Profile |
| 有效期 | 5天,到期即失效 |
配置Profile信息
| 参数 | 说明 |
|---|---|
| 应用名称/包名 | 自动填充,不可更改 |
| Profile名称 | 不超过100个字符 |
| 类型 | 固定为"试用调试" |
| 选择证书 | 仅支持选择调试证书 |
| 选择设备 | 最多选择100个调试设备 |
| 申请权限 | 申请中及已获取的所有ACL权限全部写入Profile |
Profile管理
| 操作 | 说明 |
|---|---|
| 下载Profile | 创建成功后下载,供签名使用 |
| 编辑设备 | 可修改绑定的调试设备(修改后需重新下载) |
| 状态 | 创建成功即为"生效"状态,失效需重新创建 |
四、其他
| 注意事项 | 说明 |
|---|---|
| Profile与ACL权限 | ACL权限信息需添加到Profile中,建议在创建Profile前完成ACL权限申请 |
| Profile更新 | 创建Profile后ACL权限有变化,需重新创建Profile |
| 试用调试Profile数量 | 每个应用最多5个,已满需先删除部分再申请 |
鸿蒙AGC申请ACL权限需先确认应用场景满足受限开放权限条件,一次最多申请30条,必须等审核结束才能再次申请,海外仅亚太和欧洲地区支持。提交申请后可创建试用调试Profile(有效期5天,每个应用最多5个)提前试用权限,ACL权限需写入Profile,变化需重新创建。