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
1.4 再次运行项目,选择目标设备
1.5 发行鸿蒙应用到应用市场
(1)使用hbx(4.28以上),点击【发行】- 【App-Harmony-本地打包】。
项目第一次发行时,会出现如下提示
(2)配置签名
(3)配置完签名后,再次点击【发行】- 【App-Harmony-本地打包】即可得到已签名的 .app 安装包文件
(4)最后还需参考鸿蒙官方文档发布鸿蒙应用到应用市场,详见文档。