文档开发者中心
我的
|

HarmonyOS 5

项目的第三方依赖版本问题,从某个库1.3.4版本改为1.3.0版本,结果不论怎样改,都依然使用1.3.4版本

 项目根目录 一开始添加了依赖 :

收起
自动换行
深色代码主题
复制
"@pura/harmony-utils": "^1.3.4"
后面因为API过高问题需要改为 "@pura/harmony-utils": "^1.3.0".结果sync之后依然使用1.3.4版本。
而且 我把项目根目录的oh_modules文件夹 ,.hvigor文件夹,模块的build文件夹,oh_modules文件夹,甚至连所有oh-package-lock.json5都删掉了。
重新rebuild之后,项目依然使用的是 1.3.4版本。这究竟是怎么回事啊,搞个依赖都那么复杂。
点赞
收藏
回复
6
分享
举报
浏览317 发布于2025-06-19 10:56广东
全部评论
最多点赞
最新发布
最早发布
|
技术支持

【背景知识】

ohpm 存在 dependencies,devDependencies和dynamicDependencies 三种依赖类型。同时支持具体版本号,范围版本号,tag标签,本地har/tgz文件路径和本地源码目录多种方式引入依赖。

  • dependencies:生产依赖,即参与编译/运行阶段使用的依赖,用来定义生产态HAR/HSP包依赖,声明在代码中被 import的三方库。如果被依赖的组件最终要与依赖的组件一起发布到目标机器(手机)上使用,则必须配置。
  • devDependencies:开发态依赖,只能参与项目的开发或测试阶段的依赖。如果被依赖的组件最终要与依赖的组件一起发布到目标机器(如手机)上使用,则不能配置在该字段中。
  • dynamicDependencies:动态依赖,用来配合动态import,表达动态 import 使用的HSP 包依赖。动态依赖不会在加载时就被编译,而是根据条件导入模块或者按需导入模块,具有更高效的依赖加载速度。

【解决方案】

在HarmonyOS的包管理中,dependencies字段用于声明项目依赖的库及其版本号,示例如下:

收起
自动换行
深色代码主题
复制
{
  "dependencies": {
    // 具体版本号引入,支持符合semver标准的版本号
    "specific_version": "1.0.0",

    // 范围版本号引入,^引入1.x.x的最新版本,~引入1.0.x的最新版本。范围版本优先选取正式版本,无匹配的正式版本才会选取先行版本
    "scope_version": "^1.0.1",

    // tag标签引入,示例引入标签为"beta"对应的版本号
    "tag_version": "tag:beta",

    // 本地文件引入,可引入本地har/tgz文件
    "local_file": "file:./xx.har",

    // 本地源码引入,可引入本地其他模块的源码,示例直接引入本地的"module1"模块
    "local_source_code": "file:../module1"
  },
  "devDependencies": {
    // 支持依赖引入类型同dependencies
  },
  "dynamicDependencies": {
    // 支持依赖引入类型同 dependencies
  }
}

其中版本号的标记方式如1.0.0、^1.0.0和latest有着不同的含义:

  • 固定版本号

当版本号为具体的数字,例如 1.2.3 时,它代表的是精确的版本。这意味着项目会使用该确切版本的依赖包,不会自动更新到其他版本。

收起
自动换行
深色代码主题
复制
{
  "dependencies": {
    "some-package": "1.2.3"
  }
}
  • 脱字符(^)

脱字符允许安装大版本的更新,也就是可以更新到不改变主版本号的最新版本。例如,^1.2.3 表示可以安装 1.x.x 范围内的最新版本,但不会更新到 2.0.0 或更高的主版本。

收起
自动换行
深色代码主题
复制
{
  "dependencies": {
    "some-package": "^1.2.3"
  }
}
  • latest

latest表示依赖于最新的可用版本。使用latest作为版本号,项目会自动使用最高版本的依赖,这可能会带来更高的版本风险,因为无法控制哪些特定的版本会被使用。

收起
自动换行
深色代码主题
复制
{
  "dependencies": {
    "some-package": "latest"
  }
}
  • 波浪号(~)

波浪号表示允许安装小版本的更新,也就是只会更新补丁版本号。例如,~1.2.3 意味着可以安装 1.2.x 范围内的最新版本,但不会更新到 1.3.0 或更高的主版本。

收起
自动换行
深色代码主题
复制
{
  "dependencies": {
    "some-package": "~1.2.3"
  }
}

【总结】

在实际开发中,选择合适的版本标记非常重要,因为它会影响到项目的稳定性和更新策略。例如,如果项目需要严格的版本控制以保证稳定性,应该使用明确的版本号如1.0.0。如果项目可以容忍较小的版本更新以获取新特性或修复,可以选择使用^1.0.0。而如果项目愿意承担较高版本带来的风险,可以使用latest来始终使用最新版本的依赖。

参考文档:依赖配置说明。

展开全部
3楼回复于2025-06-25 03:15 来自广东

猜测可能是因为依赖管理工具(如ohpm)选择了最高版本的依赖安装。如果项目同时依赖了某个三方库的不同版本,依赖管理工具将自动选择其中的最高版本进行安装。

可以试试:在项目的oh-package.json5文件中,明确指定需要使用的版本,如:

收起
自动换行
深色代码主题
复制
"dependencies": {
    "your-library": "1.3.0"
}

这样做可以防止依赖管理工具自动选择更高版本。

此外,如果使用的是ohpm作为包管理器,可以通过ohpm lock命令锁定特定版本的依赖,这样即使有更高版本发布,项目也不会受到影响。有时,即使正确指定了版本,旧的版本信息也可能保留在缓存中。使用ohpm clean清除缓存,然后用ohpm install重新安装依赖。

2楼回复于2025-06-20 09:49 来自河北

固定版本号嘛

@pura/harmony-utils": "1.3.0"  

2
1楼编辑于2025-06-19 11:54 来自四川
  • qu***@****i001.com
    上面不是说改了"@pura/harmony-utils": "^1.3.0"了咩
    2025-06-20 03:43 来自广东
  • 仙银回复qu***@****i001.com
    固定版本号没有 ^
    2025-06-20 08:08 来自四川

大佬,解决了么?我也遇到了相似的问题,我的是hmrouter版本一只改不了,我是这么导入的:

收起
自动换行
深色代码主题
复制
"@hadss/hmrouter": "@param:dependencies.@hadss/hmrouter",

我同事的是1.0.0,但是我每次拉取都是1.2.0,我在dependenciesFile.json5里面定死了版本号都不行

4楼回复于2025-10-16 14:07 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

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