自 HBuilderX 4.27
版本开始,uni-app 支持 Harmony Next
平台的 App 开发,目前仅支持 Vue3 项目编译到鸿蒙平台。uni-app x 从 4.61+ 版本起支持纯血鸿蒙,即 Harmony NEXT
,其组件、API、CSS 与 Android 和 iOS 基本拉齐。
开发与配置
- 开发工具 :需要下载 uni-app 开发工具 HBuilderX,建议 4.61+ 版本。同时下载鸿蒙开发工具 DevEco Studio,版本建议 5.0.11.100 及以上。若从 HBuilderX 运行工程到鸿蒙手机上,需在 HBuilderX settings.json 中配置 DevEco Studio 路径。
- 项目创建与配置 :在 HBuilderX 中依次点击文件 - 新建 - 项目,选择 uni-app,输入项目名,默认模版,点击创建。首次创建项目是没有 harmony-configs 这个目录的,在编译工程到鸿蒙手机上时会自动生成,该目录是鸿蒙的配置文件,包括应用包名、运行权限、签名等配置。
运行与调试
uni-app x 编译到鸿蒙是 ArkTS 语言,在鸿蒙的 ide deveco 中没有热刷新,每次改动代码,需要重新 build 包、签名、安装新包到手机。不过 uni-app x 在鸿蒙模拟器运行不受限制,HBuilderX 自身提供了运行、日志、debug、发行、调试证书申请等全套功能,开发者安装 deveco 后,可以做到不启动 deveco,在 HBuilderX 中完成所有开发。
发布与签名
数字签名证书的配置最终需要落在鸿蒙工程根目录中的 build-profile.json5
文件中起作用。从 HBuilderX 4.61+ 开始支持以交互方式配置相关信息,这些信息在构建阶段会被覆盖填写到鸿蒙工程的 build-profile.json5
文件中。也可以在 manifest.json
的编辑页面中,点击【鸿蒙 App 配置】里面的【配置调试证书】和【配置发布证书】按钮,打开配置对话框进行配置。
优势与意义
- 跨平台优势拓展 :uni-app 本身具备跨平台特性,鸿蒙化后,开发者一套代码就能同时适配安卓、iOS 和鸿蒙系统,进一步扩大了代码复用范围,减少了为不同系统重复开发的工作量,大大提高了开发效率。
- 快速进入鸿蒙生态 :借助 uni-app 鸿蒙化,开发者无需额外学习鸿蒙原生开发语言和框架,就能快速将应用拓展至鸿蒙生态,触达更多用户,为应用推广和商业变现创造新机会。
- 充分利用鸿蒙系统特性 :uni-app x 在鸿蒙上编译后产物是 arkTS,使用 arkUI 的原生渲染引擎,可获取更高性能、更佳体验,实现鸿蒙原生应用的高性能。