鸿蒙NEXT编译版本号错误 The version “xxx“ is invalid, reached retry limit or non retryable error encountered.

鸿蒙NEXT编译错误及解决办法

.鸿蒙NEXT编译错误 The version "xxx" is invalid, reached retry limit or non retryable error encountered.

说明

在test_demo工程下新建libtest模块,编译产物的 libtest.har,放在test_demo/ibs中运行;

错误现象

har包的版本号定义

libtest/oh-package.json5:

{
  "name": "libtest",
  "version": "1.0.20241023.1707",
  "description": "Please describe the basic information.",
  "main": "Index.ets",
  "author": "",
  "license": "Apache-2.0",
  "dependencies": {
    "libtest.so": "file:./src/main/cpp/types/libtest"
  }
}

假如版本定义: "1.0.20241023.1707"

"\"C:\Program Files\Huawei\DevEco Studio\tools\ohpm\bin\ohpm.bat\"" install --all --registry https://ohpm.openharmony.cn/ohpm/ --strict_ssl true
ohpm ERROR: Found exception: Error: The version "1.0.20241023.1707" of dependency "test@D:\ohos\sourcecode\test_demo_v1.0.0.har" is invalid, reached retry limit or non retryable error encountered.
ohpm ERROR: ERUNNING execute tasks failed, Error: The version "
<think>我们面对的错误信息是:"Error: The version '1.0.20241023.1707' of dependency 'test@D:\ohos\sourcecode\test_demo_v1.0.0.har' is invalid, reached retry limit or non retryable error encountered." 以及 "ohpm ERROR: Install failed, detail: Error: The version '1.0.20241023.1707' of dependency 'test@D:\ohos\sourcecode\test_demo_v1.0.0.har' is invalid" 根据引用[2]和引用[3],我们可以推测问题可能出现在依赖的版本号格式或依赖项的声明方式上。同时,引用[4]提供了一种通过排除传递依赖来解决依赖冲突的方法,但在这个问题中,我们主要关注的是依赖版本无效的问题。 分析步骤: 1. 检查依赖版本号格式:错误信息中提到的版本号是"1.0.20241023.1707"。通常,版本号需要遵循语义化版本规范(SemVer),即主版本号.版本号.修订号,并且可以包含预发布版本和构建元数据。但是,这个版本号看起来像是日期和时间(2024年10月23日17:07),虽然这种格式有时被使用,但可能不被ohpm(OpenHarmony包管理器)所接受。 2. 检查依赖路径:依赖项被声明为本地文件路径:'test@D:\ohos\sourcecode\test_demo_v1.0.0.har'。这里可能存在两个问题: a. 路径是否正确?是否存在该文件? b. 在oh-package.json5文件中声明依赖的方式是否正确? 3. 参考引用[3]中的经验:在鸿蒙开发中,当在oh-package.json5文件中声明依赖时,如果使用了不正确的路径或者不正确的名称,会导致错误。例如,引用[3]中作者删除了一个依赖项("entry": "file:../../entry")后解决了问题。另外,作者还提到在新建工程的har包中,不能使用类似'@my/basic'这样的作用域包名,而只能使用简单的名称(如"basic")。 4. 网络问题:引用[1]提到在安装过程中出现“reached retry limit or non retryable error encountered”可能是由于网络问题(如使用IPv6导致下载失败)引起的。但在这个错误中,依赖项是本地文件,所以可能不是网络问题,但也不能完全排除(因为可能该har包还依赖其他需要从网络下载的包?)。 解决方案建议: 1. 验证版本号:尝试将版本号改为符合语义化版本规范的格式,例如改为"1.0.0"或"1.0.20241023"(注意:如果包含日期,通常只使用日期部分,而不带时间部分)。查看ohpm文档,确认版本号格式要求。 2. 检查依赖路径: - 确保路径`D:\ohos\sourcecode\test_demo_v1.0.0.har`存在,并且是有效的har包。 - 在oh-package.json5中,声明本地依赖的正确方式。例如: "dependencies": { "test": "file:../sourcecode/test_demo_v1.0.0.har" } 注意:这里使用相对路径可能更安全,避免绝对路径(因为绝对路径在不同机器上可能不同)。 3. 检查依赖名称:根据引用[3],避免使用作用域包名(如`@my/basic`)而使用简单名称(如`test`)。在错误信息中,依赖名称为`test`,这看起来是简单的名称,应该没问题。但要注意,在导入时,应该使用这个名称(如`import ... from 'test'`)。 4. 排除其他依赖:如果该har包还依赖其他包,而这些包下载失败,则可能导致重试次数达到上限。可以尝试单独安装这个har包,或者检查网络设置(如禁用IPv6,使用代理等)。 5. 清理缓存:有时候包管理器的缓存可能导致问题,尝试清理ohpm的缓存,然后重新安装。 6. 检查ohpm版本:确保使用的ohpm是最新版本,以避免已知的bug。 具体操作步骤: 步骤1:修改版本号 打开har包中的oh-package.json5文件,将版本号改为简单的符合规范的版本,例如"1.0.0"。 步骤2:检查依赖声明 在需要引入这个har包的项目中,打开oh-package.json5,检查依赖声明。确保路径正确(相对路径)且名称合法。 步骤3:尝试重新安装 在项目目录下运行安装命令(如`ohpm install`)。 步骤4:如果问题依旧,尝试清理缓存 可以尝试删除ohpm的缓存目录(具体路径可查看ohpm文档),或者使用命令`ohpm cache clean`(如果支持的话)。 步骤5:检查网络 如果还有其他依赖需要从网络下载,确保网络正常,可以尝试ping registry的地址(https://ohpm.openharmony.cn/ohpm/)看是否通,或者使用浏览器下载测试。 步骤6:查看日志 详细日志可能会提供更多线索,可以尝试增加日志级别(如`ohpm install --verbose`)来查看。 如果以上步骤都不能解决问题,可能需要查看ohpm的官方文档或寻求社区支持。 注意:引用[4]中提到的排除传递依赖的方法(使用<exclusions>)是Maven的语法,在ohpm中可能不适用。ohpm可能有类似的机制,需要查阅文档。 由于错误信息明确指出依赖版本无效,因此重点应放在版本号和依赖路径的检查上。 相关问题: 1. 如何正确声明本地har包依赖? 2. ohpm支持的版本号格式是什么? 3. 如何解决ohpm安装过程中的网络问题? 4. 如何清理ohpm的缓存? 5. 如何查看ohpm的详细日志以帮助调试?</think>### 解决依赖无效错误的方法 根据错误信息 `Error: Invalid dependency, reached retry limit or non retryable error encountered`,结合引用内容,问题通常由以下原因引起: #### 1. **版本号格式无效**(引用[2]) - 错误信息明确提示 `The version "1.0.20241023.1707" is invalid` - **解决方法**: - 检查 `oh-package.json5` 文件中的 `version` 字段 - 确保版本号符合语义化版本规范(SemVer),例如 `1.0.0` 或 `1.2.3` - 避免使用日期格式(如 `20241023.1707`)或特殊字符 #### 2. **依赖路径声明错误**(引用[3]) - 本地依赖路径格式问题: ```json // 错误示例 "dependencies": { "entry": "file:../../entry" } ``` - **解决方法**: - 使用标准相对路径格式:`"basic": "file:../common/basic"` - 删除无效或冲突的依赖项(引用[3]中删除依赖后解决) - 确保路径指向有效的 `.har` 文件 #### 3. **网络重试限制**(引用[1][2]) - 当使用 IPv6 地址或网络不稳定时,可能触发重试上限 - **解决方法**: - 强制使用 IPv4:在命令前添加 `NODE_OPTIONS="--dns-result-order=ipv4first"` - 检查代理设置:`ohpm config set registry https://registry.npm.taobao.org/` - 重试安装:`ohpm install --retry 5`(增加重试次数) #### 4. **传递依赖冲突**(引用[4]) - 间接依赖版本不兼容 - **解决方法**: ```json "dependencies": { "xfire-all": { "version": "1.2.6", "exclusions": ["javax.activation/activation"] // 排除冲突包 } } ``` ### 完整解决步骤 1. **验证版本号格式** 在 `oh-package.json5` 中修改为有效版本: ```json { "name": "test", "version": "1.0.0", // 符合SemVer规范 "dependencies": { "basic": "file:../common/basic" // 标准相对路径 } } ``` 2. **清理缓存并重试** ```bash ohpm cache clean NODE_OPTIONS="--dns-result-order=ipv4first" ohpm install ``` 3. **检查网络连接** ```bash ping ohpm.openharmony.cn # 测试registry可达性 curl -v https://ohpm.openharmony.cn/ohpm/ # 验证SSL证书 ``` 4. **查看详细日志** ```bash ohpm install --verbose > install.log 2>&1 # 输出详细日志 ``` > **注意**:若问题持续,检查防火墙是否拦截 `ohpm` 的443端口访问,或尝试更换网络环境[^1][^2]。 --- ### 相关问题 1. 如何正确声明 OpenHarmony 的本地 HAR 包依赖? 2. ohpm 安装失败时如何获取详细错误日志? 3. 语义化版本规范(SemVer)的具体规则是什么? 4. 如何排除 OpenHarmony 项目中的冲突依赖? 5. IPv6 环境下如何解决 ohpm 的网络连接问题?
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值