Open Harmony
环境准备
OpenHarmony 标准系统为开发者提供的 Docker 环境将对应的编译工具链进行了封装,本文档主要介绍在 Docker 环境下构建 WasmEdge 的步骤.
OpenHarmony 源码的获取与编译可以参考文档
请注意,在构建 WasmEdge 前需要将 Openharmony 进行一次全量编译以便后续WasmEdge的交叉编译过程.
OpenHarmony 将三方库项目放在了 third_party 文件夹下,因此本文档在 third_party 文件夹下获取 WasmEdge 源码,用户可以根据需要更改路径并修改相关配置文件中的路径。
(root@xxxxxx:/home/openharmony)$ cd third_party
(root@xxxxxx:/home/openharmony/third_party)$ git clone https://github.com/WasmEdge/WasmEdge.git
(root@xxxxxx:/home/openharmony/third_party/WasmEdge)$
修改 OpenHarmony 产品配置文件,标准系统对应的配置文件:productdefine/common/products/Hi3516DV300.json
。 在该配置文件中添加 "wasmedge:wasmedge":{}
,表示该产品中会编译并打包 wasmedge 子系统下的 wasmedge
模块到版本中。
{
...
"parts":{
...
"wasmedge:wasmedge":{}
}
在 OpenHarmony 中构建的 WasmEdge 目前仅支持 wasmedge
,即 wasm 的通用运行时。
wasmedge
可以在解释器模式下执行一个WASM
文件, 也可以在预编译模式下执行通用 Wasm 二进制格式文件, 目前还不支持在 OpenHarmony 中使用预编译模式 。
通过执行 WasmEdge 源码下的 utils/build_for_ohos.sh
命令行脚本,将自动执行以下工作:
- 将 .gn 等 OpenHarmony 需要的构建配置文件移动到 WasmEdge 项目根目录。
- 使用 OpenHarmony 的编译工具链进行交叉编译构建 WasmEdge。
- 运行 OpenHarmony 的构建脚本
build.sh
进行全量编译,该步骤将wasmedge
添加进 OpenHarmony OS。
当显示以下信息时,表明编译完成.
...
post_process
=====build Hi3516DV300 successful.
2021-12-15 03:18:50
当输出的文件名中存在 wasmedge
,表明成功加入 OpenHarmony OS。
将重新编译后的 OpenHarmony 标准系统镜像烧录进开发板,具体见 OpenHarmony 文档Hi3516DV300开发板烧录
在 OpenHarmony 标准系统中,WasmEdge 提供了测试样例,并写入了 system 镜像中,供用户进行测试。 通过串口工具连接上开发板并启动OpenHarmony标准系统后,用户可以进行以下测试。
$ cd /system/usr/wasmedge_example
hello
1
2
3
$ wasmedge --reactor add.wasm add 2 2
4
$ wasmedge --reactor fibonacci.wasm fib 8
34
$ wasmedge --reactor factorial.wasm fac 12
479001600
$ cd js
Hello 1 2 3
接下来,你可以使用 WasmEdge Runtime 在 OpenHarmony 标准系统中进行 WebAssembly 的相关开发工作。