在OpenHarmony设备上运行

本文档将指导你通过必须的步骤在开源鸿蒙(OpenHarmony)设备上运行 JsView App，为生产做准备。

提示

下文所指的设备包括 OpenHarmony 盒子和电视

1. 代码加入notifyPageLoaded调用

同 Android 代码加入notifyPageLoaded调用

2. 追加代码, 防止返回键直接退出应用

同 Android 追加代码, 防止返回键直接退出应用

3. 调整屏幕和设计图的尺寸映射

同 Android 调整屏幕和设计图的尺寸映射

4. 开启 USB 调试

你需要开启 USB 调试才能自由安装开发版本的 APP。 首先，确定你已经打开OpenHarmony设备的 USB 调试开关。

5. 通过 USB 数据线连接设备

下面检查你的设备是否能正确连接到 HDC（HarmonyOS Device Connector），使用hdc list targets -v命令：

$ hdc list targets -v
150100424a5444345209d945be12b900		USB	Connected	localhost   # Physical device

在上边那列看到device状态说明你的设备已经被正确连接了。注意，你每次推荐只连接一个设备。

如果你连接了多个设备（包含模拟器在内），后续操作需要指定设备。如果你对adb命令不是特别熟悉，请拔掉不需要的设备，或者关掉模拟器，确保 hdc list targets 的输出只有一个是连接状态。

6. 安装[视九小程序之家]App

我们准备了一个已经编译好的视九JSV测试.hap，你可以点击下载hap到本地解压并安装到设备上。你可以使用hdc install命令进行安装：

$ hdc install com.qcode.jsview-entry-v1.0.xxx.hap # []需要替换成你下载后的apk路径

成功安装后，你的设备上会出现 图标(名字也可能叫: 小程序之家)。

7. 运行[视九小程序之家]App

(1) 首先确保你的电脑和手机设备在同一个 Wi-Fi 环境下。

(2) 使用npm start/npm run dev运行你的JsView应用。

(3) 使用hdc shell aa start命令在设备上启动应用，例如：

• 执行adb shell am start命令

$ hdc shell aa start \
-a EntryAbility -b com.qcode.jsview.demo \
--ps URL [APP_HOMEPAGE_URL] \
--pb enableDevTools true

• 变量(对应属性URL): 脚手架npm run-script start后，符合此格式的 http://%npm start的服务器IP%:5173/js/main.jsv.mjs 的URL

• 或者你也可以在工程目录下使用命令：

$ npm run tool -- --runon-ohos

该命令会解析project/jsview/dom/target_core_revision.mjs文件内容并调用hdc shell aa start命令。