HarmonyOS鸿蒙Next中Mac os新创的ArkUI-X项目运行失败

HarmonyOS鸿蒙Next中Mac os新创的ArkUI-X项目运行失败 npm环境是采用nvm安装的, 已经配置idea.properties环境变量

ide.node.location=/Volumes/System/Users/Shared/env/nvm/versions/node/v18.20.8/bin 构建时错误如下:

/Volumes/System/Users/Shared/env/nvm/versions/node/v18.20.8/bin/node /Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js --sync -p product=default --analyze=normal --parallel --incremental --no-daemon

Installing dependencies...

 ERR_PNPM_NO_MATCHING_VERSION  No matching version found for @ohos/hvigor-ohos-arkui-x-plugin@4.21.1

This error happened while installing a direct dependency of /Users/huangyong/.hvigor/project_caches/9f5e5b2b9c4574d8494d436139d95909eb528967fc11c7f7dc78ff9a58eeaeea/workspace

The latest release of @ohos/hvigor-ohos-arkui-x-plugin is "4.21.0".

If you need the full list of all 36 published versions run "$ pnpm view @ohos/hvigor-ohos-arkui-x-plugin versions".

> hvigor ERROR: 00308002 Operation Error

Error Message: /Users/huangyong/.hvigor/wrapper/tools/node_modules/.bin/pnpm install execute failed.

* Try the following: 

  > See above for details.

Process finished with exit code 255

根据提示,运行果pnpm view @ohos/hvigor-ohos-arkui-x-plugin versions 结果如下:

/Users/huangyong/.hvigor/wrapper/tools/node_modules/.bin/pnpm view @ohos/hvigor-ohos-arkui-x-plugin versions
[
  '2.1.2',  '2.1.7',  '2.3.1',  '3.0.0',
  '3.1.1',  '4.2.1',  '4.2.2',  '4.2.3',
  '4.2.4',  '4.2.7',  '4.2.8',  '4.2.10',
  '4.2.11', '4.2.12', '4.2.14', '4.2.15',
  '4.2.17', '4.2.18', '4.2.22', '4.2.23',
  '4.2.24', '4.2.25', '4.2.27', '4.17.5',
  '4.17.6', '4.18.0', '4.19.0', '4.19.2',
  '4.19.6', '4.19.7', '4.19.8', '4.20.0',
  '4.20.3', '4.20.4', '4.20.5', '4.21.0'
]

npm源配置如下: npm config get registry https://repo.huaweicloud.com/repository/npm/


更多关于HarmonyOS鸿蒙Next中Mac os新创的ArkUI-X项目运行失败的实战教程也可以访问 https://www.itying.com/category-93-b0.html

5 回复

开发者您好，这个可能跟版本有关，方便提供一下您的DevEco  Studio的版本吗？

更多关于HarmonyOS鸿蒙Next中Mac os新创的ArkUI-X项目运行失败的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


由于项目配置中要求的 @ohos/hvigor-ohos-arkui-x-plugin@4.21.1 版本不存在，而实际最高可用版本为 4.21.0，导致依赖安装失败。同时，npm源未正确指向鸿蒙官方镜像源，可能从公共仓库拉取不到鸿蒙专属包。

执行以下命令设置镜像源：

npm config set registry https://repo.harmonyos.com/npm/

删除 node_modules 和 hvigor 缓存目录：

rm -rf node_modules
rm -rf ~/.hvigor/

重新执行构建命令，确保拉取最新依赖。

把项目里写死的 4.21.1 改成 4.21.0，目前 @ohos/hvigor-ohos-arkui-x-plugin 最新版本为4.21.0

在HarmonyOS Next中，ArkUI-X项目运行失败可能涉及以下原因：项目配置不完整、依赖包缺失或版本不匹配、开发环境未正确配置。请检查项目配置文件（如build-profile.json5）和依赖项，确保ArkUI-X SDK版本与HarmonyOS Next兼容，并确认DevEco Studio已更新至支持ArkUI-X的最新版本。

根据错误信息，核心问题是项目依赖的 @ohos/hvigor-ohos-arkui-x-plugin 版本 4.21.1 在配置的 npm 源中不存在。查询结果显示，该包的最新版本是 4.21.0。

这通常是由于项目模板或 hvigor 构建工具的版本与当前可用的依赖包版本不匹配导致的。要解决此问题，你需要手动修改项目配置，将依赖版本锁定为实际存在的 4.21.0。

请按以下步骤操作：

  1. 定位并修改 hvigor 配置文件： 在项目根目录下，找到 hvigor 或 hvigorw 相关的配置文件，通常是 hvigorfile.ts、package.json 或项目级 build-profile.json5。你需要查找其中对 @ohos/hvigor-ohos-arkui-x-plugin 的依赖声明。

  2. 修正依赖版本号： 将找到的依赖版本从 4.21.1 改为 4.21.0。例如，在 package.json 的 devDependencies 中修改：

    "devDependencies": {
  "@ohos/hvigor-ohos-arkui-x-plugin": "4.21.0"
}

    或者在 hvigorfile.ts 的 plugins 配置中修改。

  3. 清理缓存并重新构建： 修改完成后，执行以下命令清理缓存并重新同步依赖：

    # 在项目根目录下执行
./hvigorw clean
./hvigorw --sync

    或者直接使用 DevEco Studio 的 Build > Clean Project 和 Sync and Refresh Project 功能。

完成以上步骤后，项目应能成功解析依赖并正常构建。此问题源于工具链的版本发布间隙，手动指定一个已发布的稳定版本是标准解决方案。

回到顶部