文档开发者中心
我的
|

HarmonyOS 5

Unsupported restricted ACL permission exist in the configuration

声明了受限的 ACL 权限,在 File > Project Structure > Signing Configs 中勾选自动签名时,弹窗提示:Unsupported restricted ACL permission exist in the configuration。
点赞
收藏
回复
3
分享
举报
浏览22 发布于6小时前北京
全部评论
最多点赞
最新发布
最早发布

这个报错 Unsupported restricted ACL permission exist in the configuration,说白了就是自动签名有白名单限制,你在module.json5里写的某个ACL权限,不在当前IDE版本自动签名允许的权限清单里,自动签名打包校验直接拦下来。

先讲排查顺序:

  1. 打开module.json5,找到requestPermissions,把里面声明的权限一条一条摘出来核对。
  2. 对照官网自动签名可开放ACL权限清单,看哪个权限不在支持列表里。
  3. 两种处理方式:不需要这个权限就直接删掉;业务必须要用,就不能走自动签名,改成手动签名流程。

这里有几个容易踩的点:

  • 调试阶段跑起来不会校验这个,只有勾选自动签名打包的时候才报这个错,很多人本地调试没事,打包才翻车。
  • 不同DevEco Studio版本支持的权限清单不一样,新版本会新增一部分受限ACL,版本低的IDE不认。
  • 就算你在AGC后台申请好了权限,只要走自动签名,依然受白名单约束,不是AGC批了就能用。
  • 自动签名和手动签名是两套东西,自动签名只能用固定子集,受限权限统一走手动签名。

给你个示例,就是module.json5权限声明这块:

收起
自动换行
深色代码主题
复制
"requestPermissions": [
  {
    "name": "ohos.permission.ACCESS_DDK_USB"
  }
]

如果确定这个权限是刚需,手动签名流程简单说下:

  1. 去AGC提交受限ACL权限申请,写清楚使用场景,等审核通过。
  2. 申请Profile的时候勾选上已经获批的受限ACL,下载新的Profile。
  3. DevEco Studio里切换成手动配置签名信息,把证书、密钥、Profile配进去再打包。

还有一个小提醒:不要随便加权限,很多时候是复制别人配置的时候带进来多余的ACL,删掉没用的权限,报错直接就消失了。

展开全部
3楼回复于4小时前 来自江苏

先定位“哪一条权限不被当前自动签名流程支持”,不要直接把它当成用户拒绝授权,也不要仅切换手动签名就认为权限已获批。

建议列一张最小清单:DevEco Studio完整版本、工程声明的每个受限权限、该权限对应的实际功能。对照与你IDE版本匹配的自动签名支持列表逐项检查。官方说明从6.1.0 Beta2开始,自动签名可配置的ACL权限参考“受限开放权限”;旧版则需核对对应版本清单:
https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/ide-signing-auto/

具体排查可这样做:
1. 在本地备份/分支中,把不确定的受限权限逐项移除并重新尝试签名,只用于定位触发项。找到后再决定是否删去依赖该权限的功能、改用官方替代方案,或走相应申请流程;不要删了声明却保留原来的受限接口调用。
2. 如果权限来自复制的示例或三方组件,追到实际使用点,确认当前功能确实需要它。不要凭一个报错额外加入更多ACL权限。
3. 手动签名需要对应应用、证书和含目标权限的Profile。已有一份旧Profile,不能证明新增权限也已包含;修改权限后要核对实际用于当前构建的Profile。
4. 受限权限还要满足官方列出的应用场景和主体要求。升级IDE可能改变支持清单,但不能把本不开放给该应用场景的权限变为可申请。

调试和发布也要分开:官方允许调试阶段通过符合条件的自动签名申请;发布阶段仍须在申请发布Profile时手动申请相应受限权限。签名配置通过,也不能替代user_grant权限的运行时授权。
https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/declare-permissions-in-acl/

你贴出具体权限名称及IDE版本后,才能判断是版本清单问题、权限选型问题,还是需要走申请流程。目前没有这些信息,不能确定是哪一项,更不能保证改成手动签名就成功。

2楼回复于5小时前 来自湖北
AI 生成内容,仅供参考

该报错的原因是:DevEco Studio 的自动签名功能只支持申请一份固定的 ACL 权限清单,而您的工程在 module.json5 的 requestPermissions 中声明了不在该清单范围内的受限 ACL 权限,因此自动签名在向 AGC 申请 Profile 文件时校验失败,弹出“Unsupported restricted ACL permission exist in the configuration”提示。

原因分析

自动签名的工作机制是:DevEco Studio 会校验当前工程配置的所有 ACL 权限,确认其是否在“自动签名支持的 ACL 权限”清单内,校验通过后才通过 AGC 自动申请 Profile 文件用于签名打包。一旦工程中存在清单之外的受限权限(例如部分 system_core 级别或需特殊审批的权限),自动签名即会中止并报此错误。

自动签名支持的 ACL 权限清单随 DevEco Studio 版本逐步扩充,例如 5.0.0 Release 支持的权限包括 ohos.permission.READ_CONTACTS、ohos.permission.READ_IMAGEVIDEO、ohos.permission.ACCESS_DDK_USB、ohos.permission.SYSTEM_FLOAT_WINDOW 等;后续版本又陆续新增了 ohos.permission.CUSTOM_SCREEN_RECORDING、ohos.permission.MANAGE_SCREEN_TIME_GUARD 等权限。从 DevEco Studio 6.1.0 Beta2 版本开始,自动签名支持的 ACL 权限范围以官网“受限开放权限”文档为准。

解决措施

方案一:检查并调整权限配置

  1. 打开报错模块的 module.json5 文件,定位到 requestPermissions 字段,例如:
收起
自动换行
深色代码主题
复制
{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.ACCESS_DDK_USB"
      }
    ]
  }
}
  1. 对照官网“自动签名支持的ACL权限”清单,逐一核对工程中声明的权限。若某个权限不在清单内,且并非业务必需,可将其从 requestPermissions 中移除,或替换为同能力的普通权限,再重新执行自动签名。

方案二:改用手动签名

若业务确实需要使用清单之外的受限 ACL 权限,自动签名无法满足,请改用手动签名流程:

  1. 在 AGC 平台为该受限权限提交“申请使用受限权限”,说明应用的使用场景,等待审核通过;
  2. 审核通过后,在申请 Profile 文件时勾选“受限ACL权限(HarmonyOS API9及以上)”选项,选中已获批的权限,生成并下载新的 Profile 文件;
  3. 在 DevEco Studio 中按“手动配置签名信息”的方式,将证书、密钥和 Profile 文件配置到工程的签名配置中,完成签名。

补充说明

  • 调试阶段不会强制校验配置文件中添加的 ACL 权限,但自动签名会校验权限是否在支持清单内,两者并不冲突。
  • 涉及受限权限的应用上架时,AGC 会根据应用的实际使用场景审核是否可以使用对应受限权限,不符合场景的上架申请将被驳回,因此配置前请先确认应用是否符合受限权限的使用场景。
  • 若不确定当前 DevEco Studio 版本支持哪些 ACL 权限,可升级到最新版本后重试自动签名,新版本通常扩充了支持清单。
展开全部
1楼回复于6小时前 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。