j***@163.com
j***@163.com
  • 发布:2026-06-22 10:01
  • 更新:2026-06-22 11:07
  • 阅读:77

uniapp cli 的项目怎么运行到鸿蒙呢?

分类:uni-app

cli 创建的 uniapp 项目怎么运行到鸿蒙呢?

执行 uni -p mp-harmony 或者 uni -p app ,在 hbuilder 中运行菜单下没有运行到鸿蒙的选项

直接用 hbuilder 创建的 uniapp 项目,是有运行到鸿蒙选项的

cli 的项目是要单独配置什么吗?没有找到对应文档

2026-06-22 10:01 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

欢迎到专业群( uni-app鸿蒙化技术交流群 ) 咨询,群中有相关专业的管理员和群友。

根据你的问题描述和知识库中的信息,目前 CLI 创建的 uni-app 项目无法直接通过 HBuilderX 菜单运行到鸿蒙设备,官方明确说明:

已发布版本仅支持 cli 打发行包,后续版本会支持 cli 运行到鸿蒙设备。

当前可行的解决方案

方案一:将 CLI 项目导入 HBuilderX 运行(推荐尝试)

  1. 将 CLI 项目的根目录直接拖入 HBuilderX 中打开
  2. 确保 HBuilderX 已安装鸿蒙运行插件(在【工具】-【插件安装】中检查)
  3. 点击 HBuilderX 上方【运行】菜单 - 运行到手机或模拟器 - 运行到鸿蒙

方案二:使用 HBuilderX 直接创建项目并迁移代码

如果方案一无效,可以:

  1. 用 HBuilderX 新建一个空白的 uni-app 项目(选择 Vue3)
  2. 将 CLI 项目中的 pagescomponentsstatic 等业务代码迁移到新项目中
  3. 在 HBuilderX 中运行到鸿蒙

方案三:CLI 编译 + 手动导入鸿蒙工程

  1. 在 CLI 项目中执行编译命令生成鸿蒙产物:

    npm run dev:app-harmony  
    # 或  
    uni build -p app-harmony  

    本助手使用国产模型,生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

  2. 编译完成后,产物会生成在 dist/dev/app-harmony 目录下

  3. 在 HBuilderX 中新建一个空白的 uni-app 鸿蒙项目,运行一次让它生成鸿蒙工程目录

  4. 将 CLI 编译产物复制到 HBuilderX 生成的鸿蒙工程目录中(通常在 unpackage/debug/app-harmony-xxx/entry/src/main/resources/resfile 下)

  5. 在 HBuilderX 中重新运行该项目

重要提醒

  • 如果运行时出现空白项目,可能是因为 CLI 项目的编译器版本过低,建议更新编译器的版本
  • 不要将整个鸿蒙工程目录复制到 harmony-configs 目录下,这会导致旧代码覆盖新代码
  • 运行到鸿蒙需要 HBuilderX 保持运行状态

相关文档

如果以上方案都无法解决你的问题,建议将项目迁移到 HBuilderX 直接创建的项目中,这是目前最稳定的方式。

内容为 AI 生成,仅供参考
DCloud_UNI_yuhe

DCloud_UNI_yuhe

使用的 hbuilderx 版本是多少? 项目中的依赖有 @dcloudio/uni-app-harmony 吗?

  • j***@163.com (作者)

    "@dcloudio/uni-app": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-app-harmony": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-app-plus": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-components": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-h5": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-alipay": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-baidu": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-harmony": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-jd": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-kuaishou": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-lark": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-qq": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-toutiao": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-weixin": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-mp-xhs": "3.0.0-alpha-5010320260611001",

    "@dcloudio/uni-quickapp-webview": "3.0.0-alpha-5010320260611001",

    2026-06-22 10:58

  • j***@163.com (作者)

    xhbuilder 是最新的

    2026-06-22 10:58

  • DCloud_UNI_yuhe

    回复 j***@163.com: 你可以上传一个测试项目到评论区吗?可以通过下方上传附件,上传一个 zip 看看

    2026-06-22 11:03

  • j***@163.com (作者)

    回复 DCloud_UNI_yuhe: 用的是 unbest 那个模板 https://www.unibest.tech/

    2026-06-22 11:06

j***@163.com

j***@163.com (作者)

demo

  • DCloud_UNI_yuhe

    可以通过 im 私聊我,给我你的截图看看

    2026-06-22 11:09

要回复问题请先登录注册