From 181d4d23ac80c943da0a22c455cf5fb6d5e35004 Mon Sep 17 00:00:00 2001 From: VK <370725567@qq.com> Date: Thu, 4 Jul 2024 19:27:20 +0800 Subject: [PATCH] =?UTF-8?q?update:=20=E9=B8=BF=E8=92=99=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E6=90=AC=E5=AE=B6,=20=E5=B9=B6=E5=BC=80=E6=94=BE=E5=85=A5?= =?UTF-8?q?=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/harmony/dev.md | 66 +------------------- docs/tutorial/_sidebar.md | 2 + docs/tutorial/harmony/dev.md | 115 +++++++++++++++++++++++++++++++++++ 3 files changed, 118 insertions(+), 65 deletions(-) create mode 100644 docs/tutorial/harmony/dev.md diff --git a/docs/harmony/dev.md b/docs/harmony/dev.md index f46b123ab..6de40239a 100644 --- a/docs/harmony/dev.md +++ b/docs/harmony/dev.md @@ -1,65 +1 @@ -# uni-app 开发鸿蒙应用 - -## 开发环境要求 - -* DevEco-Studio 5.0.3.400 以上 [下载地址](https://developer.huawei.com/consumer/cn/deveco-developer-suite/enabling/kit?currentPage=1&pageSize=100) -* 鸿蒙系统版本 API 12 以上 （DevEco-Studio有内置鸿蒙模拟器） -* HBuilderX-dev-4.22 以上 - -**Windows系统需要开启以下功能** - -打开控制面板 - 程序与功能 - 开启以下功能 - -1. Hyper-V -2. Windows 虚拟机监控程序平台 -3. 虚拟机平台 - -注意: 需要win10专业版或win11专业版才能开启以上功能，家庭版需先升级成专业版或企业版 - -## 配置鸿蒙离线SDK（鸿蒙项目模板） - -1. 下载 uni-app 鸿蒙离线SDK template-1.3.0.tgz [下载地址](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/template-1.3.0.tgz) - -2. 解压 template-1.3.0.tgz 压缩包，将解压后的模板工程在 DevEco-Studio 中打开 - -3. 等待 Sync 结束，点击运行按钮可以将工程运行在真机或者模拟器中（如未配置签名信息可能需要先行配置） - -## 配置 HBuilderX settings.json - -注意：值填你自己的 DevEco-Studio 启动路径 - -```js -"harmony.devTools.path" : "D:/Huawei/DevEco Studio" -``` - -![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/171981598089431le57049d.png) - -## 配置 uni-app 工程 - -1. hbx新建一个空白的uniapp项目，选vue3 - -2. 在manifest.json文件中配置鸿蒙离线SDK路径 - -编辑 manifest.json 文件，新增如下配置： - -```json -"app-harmony": { - "projectPath": "鸿蒙离线SDK路径" -} -``` - -![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/1719816197812rg4fsafg2io.png) - -3. 编译 uni-app 到鸿蒙 - -点击hbx上方【运行】菜单，运行到鸿蒙 DevEco Studio - -![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/17183338900070pjn2uj49t8.png) - -4. 在 DevEco-Studio 重新编译或运行 - -## 注意事项 - -* 移植已有的 uni-app 项目源码时，如有其他 npm 依赖，请自行安装 -* 现阶段条件编译仅 APP-HARMONY、APP 可以命中鸿蒙平台 -* 每次hbx改动源码后，DevEco-Studio 内需要点重新运行才能生效 +文件已搬家，[前往新文档](../tutorial/harmony/dev.md) \ No newline at end of file diff --git a/docs/tutorial/_sidebar.md b/docs/tutorial/_sidebar.md index df5bec650..d99e9150d 100644 --- a/docs/tutorial/_sidebar.md +++ b/docs/tutorial/_sidebar.md @@ -115,6 +115,8 @@ * [App Store上架](ios-app-store.md) * [iOS平台隐私清单](app-ios-privacyinfo.md) * [App升级](https://doc.dcloud.net.cn/uniCloud/upgrade-center.html) +* 鸿蒙专题 + * [uni-app 开发鸿蒙应用](harmony/dev.md) * 小程序专题 * [组件与WXS](miniprogram-subject.md) * [使用小程序插件](mp-weixin-plugin.md) diff --git a/docs/tutorial/harmony/dev.md b/docs/tutorial/harmony/dev.md new file mode 100644 index 000000000..7f4ce5b02 --- /dev/null +++ b/docs/tutorial/harmony/dev.md @@ -0,0 +1,115 @@ +# uni-app 开发鸿蒙应用 + +## 开发环境要求@env + +* DevEco-Studio 5.0.3.400 以上 [下载地址](https://developer.huawei.com/consumer/cn/deveco-developer-suite/enabling/kit?currentPage=1&pageSize=100) +* 鸿蒙系统版本 API 12 以上 （DevEco-Studio有内置鸿蒙模拟器） +* HBuilderX-alpha-4.22 以上 + +**Windows系统需要开启以下功能** + +打开控制面板 - 程序与功能 - 开启以下功能 + +1. Hyper-V +2. Windows 虚拟机监控程序平台 +3. 虚拟机平台 + +注意: 需要win10专业版或win11专业版才能开启以上功能，家庭版需先升级成专业版或企业版 + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720085210915b1knhu7l3u8.png) + +## 配置鸿蒙离线SDK（鸿蒙项目模板）@harmonysdk + +1. 下载 uni-app 鸿蒙离线SDK template-1.3.0.tgz [下载地址](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/template-1.3.0.tgz) + +2. 解压 template-1.3.0.tgz 压缩包，将解压后的模板工程在 DevEco-Studio 中打开 + +3. 等待 Sync 结束，点击运行按钮可以将工程运行在真机或者模拟器中（如未配置签名信息可能需要先行配置） + +### 启动鸿蒙模拟器@connectvirtually + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720085379828ap3pkhhfmig.png) + +如果没有登录华为账号，此时需要先登录，登录成功后看到如下页面 + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/17200854641084hsm583p5jo.png) + +选择模拟器型号，选第一个即可 + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/17200855617759sfquhr1j0o.png) + +安装完模拟器后，点击启动按钮启动模拟器 + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/17200856058101582lbghgf8.png) + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720085712493il2ep17ldg8.png) + +### 连接鸿蒙真机@connectmobile + +**注意：真机需要鸿蒙系统版本 API 12 以上** + +打开鸿蒙手机开发者模式，开启USB调试，通过USB线连接电脑，在此处选择你的手机名称，再启动项目即可，如果提示需要先签名，则进行[配置签名](#配置签名) + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720091392422r91cpejpp7g.png) + +### 配置签名@signature + +**注意：配置签名需要先启动模拟器或连接真机后才能配置** + +点击 DevEco-Studio 上方菜单 File - Project Structure... + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720087126462d9133uo0hmg.png) + +在弹出的窗体中选择 Project - Signing Configs 并打钩 Automatically generate signature，即可自动生成签名 + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/17200873385940vk5oj9ihk.png) + +## 配置 HBuilderX settings.json@hbxsettings + +打开HBuilderX，点击上方菜单 - 工具 - 设置，在出现的弹窗右侧窗体新增如下配置 + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720092016399okjuod823f.png) + +注意：值填你自己的 DevEco-Studio 启动路径 + +```js +"harmony.devTools.path" : "D:/Huawei/DevEco Studio" +``` + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/171981598089431le57049d.png) + +## 配置 uni-app 工程@uniappproject + +1. HBuilderX 新建一个空白的 uniapp 项目，选vue3 + +2. 在 manifest.json 文件中配置鸿蒙离线SDK路径 + +编辑 manifest.json 文件，新增如下配置： + +```json +"app-harmony": { + "projectPath": "鸿蒙离线SDK路径" +} +``` + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/1719816197812rg4fsafg2io.png) + +3. 编译 uni-app 到鸿蒙 + +点击 HBuilderX 上方【运行】菜单，运行到鸿蒙 DevEco Studio + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/17183338900070pjn2uj49t8.png) + +如果没有出现此菜单，请确认你的 HBuilderX 版本是否是 4.22 及以上 + +4. 在 DevEco-Studio 重新编译或运行 + +先等待 HBuilderX 编译完成，然后打开 DevEco-Studio，点击运行 + +![](https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720086018931faq60pigq9g.png) + +## 注意事项@tips + +* 移植已有的 uni-app 项目源码时，如有其他 npm 依赖，请自行安装 +* 现阶段条件编译仅 APP-HARMONY、APP 可以命中鸿蒙平台 +* 每次HBuilderX改动源码后，DevEco-Studio 内需要点重新运行才能生效 -- GitLab