规格错误码

00306001 文件路径长度超过最大限制

错误信息

The length of path exceeds the maximum length: XXX.

错误描述

文件路径长度超过最大限制。

可能原因

文件路径总长度超过了操作系统的限制。

处理步骤

1. 缩短工程根路径。
2. 简化工程名称。
3. 简化模块名称。
4. 简化target名称。

00306002 工程路径不能包含中文字符

错误信息

The Node directory and node name cannot contain Chinese characters.

错误描述

工程路径不能包含中文字符。

可能原因

工程路径存在中文字符。

处理步骤

移除工程路径中的中文字符。

00306003 工程路径无效

错误信息

Invalid project path. Current path does not match: XXX.

错误描述

工程路径无效。

可能原因

工程路径存在中文或特殊字符。

处理步骤

修改工程路径，确保路径只包含字母、数字、连字符-、下划线_、点号.、英文括号()、空格或@符号。

00306004 不支持的API版本

错误信息

The compatibleSDKVersion XXX cannot be smaller than YYY declared in library ZZZ或

The project's compatibleSdkVersion: XXX cannot be lower than the minimum compatible version YYY required by the dependencies: ZZZ.

错误描述

当前项目的compatibleSdkVersion版本号不能小于三方库ZZZ的最低兼容版本YYY。

可能原因

项目的compatibleSdkVersion版本小于三方库中打包时声明的compatibleSdkVersion版本（最低兼容版本）。

处理步骤

采用以下任意一种方式：

• 尝试更新当前项目的compatibleSdkVersion版本，使其大于或等于三方库中声明的版本。
• 降低三方库的compatibleSdkVersion，在打包前修改工程级build-profile.json5中的compatibleSdkVersion，使其兼容更低版本。
• 移除与项目的compatibleSdkVersion版本不兼容的三方库，或者使用版本更低的三方库。

00306005 output名称重复

错误信息

Failed to build the app due to duplicate customized output names: XXX. At file: XXX.

错误描述

自定义的output名称重复，导致构建应用失败。

可能原因

模块的target配置中，自定义的output名称重复。

处理步骤

检查模块级build-profile.json5文件的targets配置，确保每个output名称都是唯一的。

00306006 API 12及以上版本支持TargetESVersion

错误信息

Unsupported API version. TargetESVersion is supported after API 12. At file: XXX.

错误描述

TargetESVersion在API 12及以上版本中支持，当前项目的API版本低于此要求。

可能原因

当前项目的compileSdkVersion或compatibleSdkVersion低于API 12。

处理步骤

检查工程级build-profile.json5文件中的compileSdkVersion和compatibleSdkVersion配置，确保其版本为API 12或以上。

00306007 意图框架工程的runtimeOS只能配置为HarmonyOS

错误信息

The runtimeOS that supports the insightintent project can only be HarmonyOS. At file: XXX.

错误描述

意图框架工程的runtimeOS只能配置为HarmonyOS。

可能原因

意图框架工程的runtimeOS没有配置为HarmonyOS。

处理步骤

检查工程级或模块级build-profile.json5文件，确保runtimeOS设置为HarmonyOS。

00306008 API 版本不支持意图框架

错误信息

Unsupported API version. Insight intent is supported after API 11. At file: XXX.

错误描述

API 11及以上工程支持意图框架。

可能原因

当前项目的compileSdkVersion或compatibleSdkVersion低于API 11。

处理步骤

检查工程级build-profile.json5文件中的compileSdkVersion和compatibleSdkVersion配置，确保其版本为API 11或以上。

00306009 SDK版本不支持意图框架

错误信息

Unsupported SDK version. Insight intent is supported after API 11. At file: XXX.

错误描述

API 11及以上工程支持意图框架。

可能原因

当前使用的SDK版本低于API 11。

处理步骤

在官网上下载新版本的DevEco Studio。

00306010 SDK版本不支持ArkData

错误信息

The current SDK version does not support ArkData. At file: XXX.

错误描述

当前SDK版本不支持ArkData功能。

可能原因

当前使用的SDK版本不支持ArkData功能。

处理步骤

在官网上下载新版本的DevEco Studio。

00306011 SDK版本不支持UI语法

错误信息

The current SDK version does not support uiSyntax. At file: XXX.

错误描述

当前SDK版本不支持UI语法。

可能原因

当前使用的SDK版本不支持UI语法。

处理步骤

在官网上下载新版本的DevEco Studio。

00306012 不支持动态导入

错误信息

Invalid configuration of runtimeOnly in XXX. At file: XXX.

错误描述

runtimeOnly配置无效，不支持动态导入。

可能原因

仅API 11及以上的Stage模型工程支持配置runtimeOnly。

处理步骤

1. 确保工程级build-profile.json5中的compatibleSdkVersion版本为11或以上。
2. 确保模块级build-profile.json5中的apiType为stageMode。

00306013 Stage模型的OpenHarmony工程不支持元服务开发

错误信息

Atomic service development is not supported for OpenHarmony stage model. At file: XXX

错误描述

Stage模型的OpenHarmony工程不支持元服务开发。

可能原因

元服务工程的runtimeOS配置为OpenHarmony。

处理步骤

如需开发元服务，请将工程级build-profile.json5中的runtimeOS改为HarmonyOS。

00306014 API版本不支持元服务开发

错误信息

Atomic service development is not supported for compileSdkVersion/compatibleSdkVersion less than api 11. At file: XXX.

错误描述

compileSdkVersion或compatibleSdkVersion低于API 11时不支持元服务开发。

可能原因

当前工程的compileSdkVersion或compatibleSdkVersion低于API 11，不支持元服务开发。

处理步骤

检查工程级build-profile.json5文件的compileSdkVersion和compatibleSdkVersion配置，确保其版本为API 11或以上。

00306015 元服务不支持Native开发

错误信息

Atomic service development does not support Native development. At file: XXX.

错误描述

元服务不支持Native开发。

可能原因

当前工程XXX文件中包含了与Native开发相关的选项：externalNativeOptions。

处理步骤

确保元服务工程中不包含externalNativeOptions。

00306016 元服务开发仅支持ArkTS

错误信息

Atomic service development only supported ArkTS widget. At file: XXX.

错误描述

元服务开发仅支持ArkTS组件。

可能原因

工程中使用了JS组件。

处理步骤

从工程中移除与JS组件相关的代码和配置。

00306017 API版本不支持集成态HSP

错误信息

The integratedHsp can only be used in API 12 and later. At file: XXX.

错误描述

API 12及以上版本支持使用集成态HSP。

可能原因

当前工程的compileSdkVersion或compatibleSdkVersion低于API 12。

处理步骤

检查工程级build-profile.json5的compileSdkVersion和compatibleSdkVersion配置，确保版本为API 12或以上。

00306018 使用集成态HSP需要将useNormalizedOHMUrl设置为true

错误信息

The integratedHsp is available only when useNormalizedOHMUrl is set to true. At file: XXX.

错误描述

使用集成态HSP需要将useNormalizedOHMUrl设置为true。

可能原因

useNormalizedOHMUrl设置为false。

处理步骤

检查工程级build-profile.json5的useNormalizedOHMUrl配置，确保设置为true。

00306019 仅字节码HAR支持配置bundledDependencies

错误信息

Only the byte code har supports to configure the bundledDependencies. At file: XXX.

错误描述

仅字节码HAR支持配置bundledDependencies。

可能原因

1. 工程级build-profile.json5的buildOption.strictMode下未配置useNormalizedOHMUrl，或者该属性值设置为false。
2. 在模块级build-profile.json5文件中，buildOption.arkOptions.byteCodeHar设置为false。

处理步骤

1. 确保工程级build-profile.json5的buildOption.strictMode包含useNormalizedOHMUrl属性，并将其设置为true。
2. 确保模块级build-profile.json5文件中，buildOption.arkOptions.byteCodeHar设置为true。

00306026 LiteWearable穿戴类型只支持JS开发

错误信息

Lite wearable only support JS.

错误描述

LiteWearable穿戴类型只支持JS开发。

可能原因

在LiteWearable穿戴类型的项目中存在TS文件。

处理步骤

确保项目中只包含JS文件。

00306027 依赖模块不支持设备类型

错误信息

The XXX module YYY that the current module depends on does not support the device type: ZZZ, which may cause runtime exception on the device.

错误描述

当前模块依赖的YYY模块不支持设备类型ZZZ，可能会导致运行时异常。

可能原因

依赖模块的module.json中缺少该设备类型。

处理步骤

更新依赖模块，选择支持该设备类型的模块作为依赖。

00306030 transformLib不是相对路径

错误信息

Invalid transformLib, its value should be a relative path.

错误描述

无效的transformLib，该值应该是相对路径。

可能原因

配置的transformLib不是相对路径。

处理步骤

确保transformLib是相对路径。

00306034 buildRoot参数无效

错误信息

Invalid buildRoot value XXX.

错误描述

buildRoot参数无效。

可能原因

执行hvigorw命令时，指定的buildRoot参数..开头。

处理步骤

确保buildRoot参数对应的目录在当前模块下，即不允许以..开头。

00306035 未知的abiFilter

错误信息

Unknown abiFilter XXX.

错误描述

未知的abiFilter配置XXX。

可能原因

配置的abiFilter不在支持的列表中或者拼写错误。

处理步骤

检查工程级或模块级build-profile.json5文件，确保abiFilters只包含以下值：arm64-v8a、x86_64。

00306036 ohosTest不支持作为构建HSP/HAR的target

错误信息

Hvigor task 'XXX' not supported for building an 'ohosTest' target 'YYY'.

错误描述

构建HSP/HAR时，不支持选择ohosTest作为target。

可能原因

通过命令行构建HSP/HAR时，选择ohosTest作为target。

处理步骤

• 选择其他target构建HAR/HSP。
• 构建HAP模块时支持使用ohosTest作为target。

00306038 Stage模型的模块不允许依赖FA模型的模块

错误信息

Stage model module XXX does not allow Harmony library packages or modules in FA model. Build tasks will not be executed, and resources will not be packed.

错误描述

XXX为Stage模型模块，不能依赖FA模型的Harmony库或模块，否则构建任务无法执行，资源无法打包。

可能原因

Stage模型的模块依赖了FA模型的库或模块。

处理步骤

检查XXX的依赖关系，确保没有引用FA模型的Harmony库或模块。

00306039 HSP不能依赖本模块

错误信息

Shared Library cannot depend on shared module self in module XXX at file: YYY.

错误描述

在XXX模块中，HSP（共享库）不能依赖本模块。

可能原因

HSP模块依赖了自身。

处理步骤

移除HSP的自身依赖。

00306040 FA模型模块不允许依赖非源码OpenHarmony npm包

错误信息

FA module XXX does not allow OpenHarmony npm packages, which artifactType is not original. Check at file: YYY.

错误描述

FA模型模块不允许依赖非源码OpenHarmony npm包。

可能原因

XXX模块依赖的OpenHarmony npm包是字节码或混淆的源码。

处理步骤

移除XXX模块对非源码OpenHarmony npm包的依赖。

00306041 FA模型的模块不允许依赖Stage模型的模块

错误信息

FA model module XXX does not allow Harmony library packages or modules in Stage model. Build tasks will not be executed, and resources will not be packed. Check at file: YYY.

错误描述

XXX为FA模型模块，不能依赖Stage模型的Harmony库或模块，否则构建任务无法执行，资源无法打包。

可能原因

FA模型的模块依赖了Stage模型的库或模块。

处理步骤

检查XXX的依赖关系，确保没有引用Stage模型的Harmony库或模块。

00306042 API版本格式错误

错误信息

In HarmonyOS configuration:

- For API versions 10 to 25, the value of compatibleSdkVersion/targetSdkVersion must be a string (for example, '5.0.0(12)').

- For API version 26 and later, the value of compatibleSdkVersion/targetSdkVersion must be a string (for example, '26.0.0').

In OpenHarmony configuration:

- For API versions 10 to 25, the value of compileSdkVersion/compatibleSdkVersion/targetSdkVersion must be a numeric value (for example, 12).

- For API version 26 and later, the value of compileSdkVersion/compatibleSdkVersion/targetSdkVersion must be a string (for example,'26.0.0').

错误描述

在HarmonyOS配置中：

• 当API版本为10~25时，compatibleSdkVersion/targetSdkVersion是字符串类型，例如 '5.0.0(12)'。
• 当API版本为26及以上时，compatibleSdkVersion/targetSdkVersion是字符串类型，例如'26.0.0'。

在OpenHarmony配置中：

• 当API版本为10~25时，compileSdkVersion/compatibleSdkVersion/targetSdkVersion是数值类型，例如12。
• 当API版本为26及以上时，compileSdkVersion/compatibleSdkVersion/targetSdkVersion是字符串类型，例如'26.0.0'。

可能原因

compileSdkVersion/compatibleSdkVersion/targetSdkVersion字段的值类型不符合要求。

处理步骤

检查工程级build-profile.json5文件，确保以上字段的值类型符合要求。

00306043 JS模块不允许依赖ArkTS库

错误信息

JS module XXX does not allow ArkTS dependency YYY. Check at file: ZZZ.

错误描述

JS模块XXX不能依赖ArkTS YYY。

可能原因

JS模块引入了ArkTS依赖YYY。

处理步骤

检查XXX模块oh-package.json5的依赖项，确保其不包含ArkTS依赖YYY。

00306044 JS堆内存不足

错误信息

Worker terminated due to reaching memory limit: JS heap out of memory.

错误描述

达到内存限制导致任务终止：JS堆内存不足。

可能原因

任务执行过程中堆内存不足。

处理步骤

1. 在hvigor-config.json5中调整线程相关配置：hvigor.pool.maxSize、ohos.arkCompile.maxSize、hvigor.enableMemoryCache。
2. 执行任务时关闭parallel模式。

00306045 当compatibleSdkVersion为5.0.0(12)及以上时useNormalizedOHMUrl才可配置为true

错误信息

UseNormalizedOHMUrl can be true only when Compatible SDK Version is 5.0.0 (12) or later.

错误描述

当compatibleSdkVersion为5.0.0(12)及以上时，useNormalizedOHMUrl才可配置为true。

可能原因

工程级build-profile.json5中compatibleSdkVersion配置为4.1.0(11)或以下，并且useNormalizedOHMUrl设置为true。

处理步骤

如果compatibleSdkVersion为4.1.0(11)或以下版本，将useNormalizedOHMUrl设置为false。

00306046 useNormalizedOHMUrl为false时不支持字节码HAR

错误信息

Bytecode HARs: XXX not supported when useNormalizedOHMUrl is not true.

错误描述

useNormalizedOHMUrl为false时不支持字节码HAR。

可能原因

工程级build-profile.json5中的useNormalizedOHMUrl配置为false，并且当前编译模块的依赖链上存在字节码HAR。

处理步骤

当前编译模块的依赖链上存在字节码HAR，将工程级build-profile.json5中的useNormalizedOHMUrl配置为true。

00306047 多个HSP模块依赖同一个HAR

错误信息

Found HSPs that have the same HAR.

错误描述

多个HSP模块依赖同一个HAR。

可能原因

多个HSP模块依赖同一个HAR。

处理步骤

参考最佳实践：模块化设计。

00306048 当前API版本不支持配置autoLazyImport

错误信息

autoLazyImport cannot be configured for the current API version. autoLazyImport can be used in the beta3 version of API 12 or higher versions.

错误描述

当前API版本不支持配置autoLazyImport，API 12 beta3及以上版本支持使用autoLazyImport。

可能原因

在API 12 beta3以下的版本中将autoLazyImport配置为true。

处理步骤

选择以下一种方式解决：

• 检查工程级build-profile.json5中的compatibleSdkVersion和compatibleSdkVersionStage字段，如果compatibleSdkVersion设置为API 12，则将compatibleSdkVersionStage设置为beta3。
• 将autoLazyImport配置为false。

00306049 模块中存在重复的文件

错误信息

Duplicated files found in module XXX. This may cause unexpected errors at runtime.

错误描述

在模块XXX中存在重复的文件，可能会导致运行时错误。

可能原因

模块中存在相同名称的.so文件。

处理步骤

选择以下一种方式解决：

• 确保每个.so文件名都是唯一的。

• 通过pickFirsts、pickLasts或select字段设置.so文件的优先级。

00306050 FA模型的项目不允许依赖外部项目模块

错误信息

This project is in the FA model and does not allow for external dependencies.

错误描述

FA模型的项目不允许依赖外部项目模块。

可能原因

FA模型的项目在build-profile.json5中，srcPath字段依赖了外部项目模块。

处理步骤

工程级build-profile.json5中，移除srcPath字段依赖的外部项目模块。

00306051 Stage模型的项目不允许依赖FA模型的模块

错误信息

This project is in the stage model and does not allow for dependencies of modules in the FA model.

错误描述

Stage模型的项目不允许依赖FA模型的模块。

可能原因

在Stage模型的工程级build-profile.json5中srcPath字段引入了FA模型的工程模块。

处理步骤

工程级build-profile.json5移除对FA模型的工程模块的引用。

00306052 不能依赖工程外的HAP模块

错误信息

Cannot depend on HAP modules outside of this project.

错误描述

不能依赖工程外的HAP模块。

可能原因

工程级build-profile.json5中srcPath字段依赖了项目外的HAP模块。

处理步骤

使用HSP或HAR模块替换项目外的HAP依赖。

00306053 ohpm安装依赖失败

错误信息

ohpm install failed.

错误描述

ohpm安装依赖失败。

可能原因

网络不通，或ohpm镜像仓库地址、oh-package.json5中依赖的包名、版本号不正确。

处理步骤

请检查网络，或ohpm镜像仓库地址、oh-package.json5中依赖的包名、版本号是否正确。

00306054 构建任务的命令无效

错误信息

Task XXX was not found in the project XXX. Invalid command to execute the build task, please verify the parameters in the command and try again.

错误描述

在工程中找不到任务，构建命令无效，请检查命令行中的参数并重试。

可能原因

构建命令中的参数设置错误。

处理步骤

1. 执行“hvigorw --help”命令，了解有关hvigor命令的更多信息。
2. 执行“hvigorw tasks”命令，查看可用任务列表。
3. 执行命令时增加“--info”或“--debug”选项，获取更多日志输出。

00306055 工程外的模块缺少配置

错误信息

Missing module configuration for external module outside the current project.

错误描述

工程外的模块缺少配置。

可能原因

使用了工程外的模块，但是没有在工程的build-profile.json5中配置模块信息。

处理步骤

检查工程级build-profile.json5，确保使用的所有模块都在modules字段中配置。

00306056 hvigor守护进程异常退出

错误信息

A log of daemon process can be found at file: XXX.

错误描述

hvigor守护进程异常退出，可在XXX文件中查看日志。

可能原因

守护进程内存不足，具体原因可查看守护进程日志。

处理步骤

1. 修改hvigor-config.json5中nodeOptions下的maxOldSpaceSize，增加守护进程的内存。
2. 关闭守护进程后重新编译，验证该问题是否与守护进程有关。

00306057 executableBinaryPaths-path的值应该是相对路径

错误信息

The executableBinaryPaths-path XXX should be a relative path. At file: YYY.

错误描述

executableBinaryPaths-path的值应该是相对路径。

可能原因

配置的executableBinaryPaths-path的值不是相对路径。

处理步骤

确保executableBinaryPaths-path的值是相对路径。

00306058 应用skill的skillProfiles仅在bundleType为app或atomicService时可配置

错误信息

skillProfiles can be configured only when bundleType is set to app or atomicService. However, the current value of bundleType is XXX. At file: YYY.

错误描述

应用skill的skillProfiles仅在bundleType为app或atomicService时可配置。

可能原因

模块的module.json5中配置了skillProfiles，但是app.json5的bundleType不是app或atomicService。

处理步骤

• 删除module.json5中的skillProfiles。
• 将app.json5文件中的bundleType修改为app或atomicService。

00306059 integratedHsp模块不支持skillProfiles配置

错误信息

The integratedHsp module does not support skillProfiles. At file: XXX.

错误描述

integratedHsp模块不支持skillProfiles配置。

可能原因

integratedHsp模块不支持skillProfiles配置。

处理步骤

• 删除module.json5中的skillProfiles。
• 在模块的build-profile.json5中将buildOption.arkOptions.integratedHsp设置为false。

00306060 无法获取依赖的版本号和名称

错误信息

Unable to get dependency 'XXX''s version and name at file: XXX.

错误描述

无法获取依赖的版本号和名称。

可能原因

so依赖不支持通过parameterFile参数化配置版本号。

处理步骤

通过相对路径的方式配置so依赖。