一、前言:为什么选择 UniApp 打包鸿蒙应用?
随着鸿蒙生态的快速发展,越来越多开发者希望将现有跨平台项目快速接入鸿蒙系统。而 UniApp 作为国内领先的跨平台开发框架,凭借其'一次开发,多端发布'的特性,成为接入鸿蒙(HarmonyOS)的理想选择。
本文将基于 Vue3 + UniApp 的项目架构,详细介绍如何通过 HBuilderX + DevEco Studio 联合打包,将项目发布为标准的鸿蒙应用(.hap 或 .app 包),并重点讲解如何为 UniApp 中使用的 API 添加对应的鸿蒙系统权限(ohos.permission),确保功能正常运行。
二、开发环境准备
1. 基础工具 建议确保 HBuilderX 和 DevEco Studio 的版本均为最新。
- HBuilderX
- DevEco Studio
- Node.js(16+)
2. 项目基础 使用 Vue3 语法开发的 UniApp 项目(底层必须使用 Vue3 的语法,Vue2 不支持)
三、UniApp 项目打包为鸿蒙工程
步骤 1:在 HBuilderX 中生成鸿蒙工程 打开你的 UniApp 项目,点击菜单栏:运行 > 运行到手机或模拟器(N)> 运行到鸿蒙(H)。

记得连接鸿蒙设备,并且配置调试证书(调试证书是支持自动生成的,开发阶段可以使用,打包发布时需要生成上线证书)。

点击'自动申请调试证书'即可,调试证书会自动生成,注意应用包名,这个包名后续在华为开发者联盟 -AppGallery Connect 做应用分发的时候会用到,请认真命名!!!

点击'保存'后运行,HBuilderX 会生成一个标准的鸿蒙工程目录(通常为 app-harmony)。

注意:生成的工程是标准的 HarmonyOS 项目结构,包含 entry/、module.json5、resources 等。
四、使用 DevEco Studio 导入并构建鸿蒙应用
步骤 1:导入工程 打开 DevEco Studio,选择'Open an existing HarmonyOS project',选择 HBuilderX 生成的鸿蒙工程目录。






























