uni-app 运行HarmonyOS项目

1. uni-app 运行HarmonyOS项目

文档中心

1.1. HarmonyOS端

1.1.1. 准备工作

（1）下载DevEco Studio开发工具。

（2）在 DevEco Studio 中打开任意一个项目（也可以新建一个空项目）。

（3）连接鸿蒙真机或者模拟器。

注意：真机需要鸿蒙系统版本 API 12 以上

打开鸿蒙手机开发者模式，开启USB调试，通过USB线连接电脑，在此处能看到对应的设备标识符则表示连接成功

1.1.2. 证书签名配置指南

注意：配置签名需要先启动模拟器或连接真机后才能配置

点击 DevEco-Studio 上方菜单 File - Project Structure...

1.1.3. 使用发布证书生成发布用的签名

需要先申请发布证书。

在弹出的窗体中选择 Project - Signing Configs，并手动填写证书信息和密钥。

依次点击 Apply 和 OK 使签名生效。

如果是运行证书还是发布证书，生成的签名在文件 build-profile.json5 内

将它复制到你的 uni-app 项目根目录的 harmony-configs/build-profile.json5 的 signingConfigs 配置中

1.2. 配置 HBuilderX settings.json

打开HBuilderX，点击上方菜单 - 工具 - 设置，再点击运行配置，在鸿蒙运行配置中设置 DevEco Studio 的路径。

1.3. 运行uniapp项目到鸿蒙

（1）HBuilderX 新建一个空白的 uni-app 项目，选vue3（也可使用已有的uni-app vue3项目）。

（2）编译 uni-app 到鸿蒙。

点击 HBuilderX 上方【运行】菜单 - 运行到手机或模拟器 - 运行到鸿蒙。

（3）【首次运行】此时如果是第一次运行本项目会在项目根目录下生成harmony-configs目录用于存放鸿蒙配置文件。

（4）【首次运行】配置签名信息、包名到鸿蒙配置文件内

参考：修改鸿蒙工程配置

项目的根目录下有一个 harmony-configs 目录，每当执行跟鸿蒙相关的操作时，HX 都会检查这个目录，如果目录不存在则会自动创建。新版本（4.29+）还会检查与 HX 当前版本的内置鸿蒙工程模板是否匹配，如果版本不匹配（比如 HX 升级到新版本时）则会提示用户把需要更新的内容合并到目录中。

所有属于鸿蒙工程的配置调整，都可以写在 harmony-configs 目录下，具体内容可以参照鸿蒙的相关文档。其中常用内容有：
1.应用包名

在 harmony-configs/AppScrope/app.json5 中修改 app.bundleName

注意：HX 4.31+ 同时支持在项目的 manifest.json 里面以图形界面修改鸿蒙配置（包括包名），如果在那里做了设置，将优先于 harmony-configs/AppScrope/app.json5 里面的 app.bundleName。

c 复制代码

{
  "app": {
    "bundleName": "com.zzs.myapplication",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    "icon": "$media:layered_image",
    "label": "$string:app_name"
  }
}

2.运行权限

在 harmony-configs/entry/src/main/module.json5 中修改 module.requestPermissions
3.数字签名证书相关信息

在 harmony-configs/build-profile.json5 中修改 app.signingConfigs

1.4 再次运行项目，选择目标设备

1.5 发行鸿蒙应用到应用市场

（1）使用hbx（4.28以上），点击【发行】- 【App-Harmony-本地打包】。

项目第一次发行时，会出现如下提示

（2）配置签名

（3）配置完签名后，再次点击【发行】- 【App-Harmony-本地打包】即可得到已签名的 .app 安装包文件

（4）最后还需参考鸿蒙官方文档发布鸿蒙应用到应用市场，详见文档。