uni-app 运行HarmonyOS项目

news2024/12/26 22:45:34

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。

{
  "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