【HarmonyOS NEXT】踩坑记录:00306046 Specification Limit Violation

一、背景

我们现在开发的项目采用的是壳工程+模块的形式,我需要单独运行登录模块来进行更改bug和新增需求,但遇到以下报错,记录下踩坑问题

二、具体问题

运行报错:00306046 Specification Limit Violation

三、确定问题

原因:00306046 Specification Limit Violation(规范限制违规),明确提示当使用了字节码 HAR 包(Bytecode HARs)时,必须启用useNormalizedOHMUrl配置,且当前项目未开启该配置

项目依赖的字节码格式的HAR包对项目构建配置有特殊要求

项目级build-profile.json5文件中,useNormalizedOHMUrl未设置为true,违反了字节码 HAR 包的使用规范,导致构建失败。

四、什么是useNormalizedOHMUrl

useNormalizedOHMUrl是鸿蒙项目构建配置中的核心参数,作用是:

1、使用标准化的OHMUrl(OHMUrl的定义参考以下说明)格式,标准化的OHMUrl统一了原有OHMUrl的格式。使用集成态HSP和字节码HAR需使用标准化的OHMUrl格式。

2、当项目依赖字节码格式 HAR 包 (非源码 HAR 包)时,该配置必须设为true,否则构建工具无法正确识别和处理这些依赖包,从而抛出规范违规错误。

说明:

1、当useNormalizedOHMUrl设置为true时,不允许通过相对路径跨模块或绝对路径导入文件,oh-package.json5中依赖的包使用的别名需要和依赖包的oh-package.json5的name保持一致

所以,我在登录模块将useNormalizedOHMUrl设置为true单独运行起来,在壳工程内就不能通过相对路径跨模块或绝对路径导入文件来运行了

五、如何更改bug

build-profile.json5 中将 useNormalizedOHMUrl字段设为true

若没有该字段,新增即可

备注:

如果useNormalizedOHMUrl字段改为true后还是报错,需要看下是不是位置写错了

该字段是在工程级build-profile.json5内添加,而不是在login模块内添加哦

相关推荐
OH_TPC14 小时前
【鸿蒙优选三方库】@ohos/mpchart:让 HarmonyOS 应用的数据可视化开箱即用
华为·信息可视化·harmonyos·鸿蒙
woshihuanglaoshi18 小时前
鸿蒙技术进阶全景高级成长体系:从初中级到架构师的技能树/学习路径/项目实战/认证体系系统性方法论
学习·华为·harmonyos
轻口味19 小时前
端侧 AI 赋能鸿蒙版 Obsidian:轻规划基于 HarmonyOS 7.0 图像超分特性的体验突破与开发实战
人工智能·华为·harmonyos·鸿蒙
OH_TPC21 小时前
【鸿蒙优选三方库】@ohos/lottie:让 After Effects 动画在 HarmonyOS 上稳定播放
华为·harmonyos·鸿蒙
李蚊子1 天前
鸿蒙应用开发实践与上架复盘
harmonyos
2501_919749031 天前
华为鸿蒙训练口才APP—小羊口才
华为·harmonyos·鸿蒙
大锅盖11 天前
HarmonyOS 摄像头焦点管理的完整工程实现
华为·harmonyos
woshihuanglaoshi1 天前
鸿蒙老旧项目升级改造高级:API废弃迁移/ArkTS语法升级/架构重构策略/增量迁移/风险管控方案
学习·华为·重构·架构·harmonyos·鸿蒙
星空真迷人2 天前
嵌入式鸿蒙并非精简版,核心究竟是什么?
stm32·单片机·嵌入式硬件·物联网·华为·harmonyos·iot
OH_TPC2 天前
【鸿蒙优选三方库】@ohos/ijkplayer:在鸿蒙上像 B 站一样流畅播视频
华为·音视频·harmonyos·鸿蒙