Open Harmony

    环境准备

    OpenHarmony 标准系统为开发者提供的 Docker 环境将对应的编译工具链进行了封装,本文档主要介绍在 Docker 环境下构建 WasmEdge 的步骤.

    OpenHarmony 源码的获取与编译可以参考文档

    请注意,在构建 WasmEdge 前需要将 Openharmony 进行一次全量编译以便后续WasmEdge的交叉编译过程.

    OpenHarmony 将三方库项目放在了 third_party 文件夹下,因此本文档在 third_party 文件夹下获取 WasmEdge 源码,用户可以根据需要更改路径并修改相关配置文件中的路径。

    1. (root@xxxxxx:/home/openharmony)$ cd third_party
    2. (root@xxxxxx:/home/openharmony/third_party)$ git clone https://github.com/WasmEdge/WasmEdge.git
    3. (root@xxxxxx:/home/openharmony/third_party/WasmEdge)$

    修改 OpenHarmony 产品配置文件,标准系统对应的配置文件:productdefine/common/products/Hi3516DV300.json。 在该配置文件中添加 "wasmedge:wasmedge":{},表示该产品中会编译并打包 wasmedge 子系统下的 wasmedge 模块到版本中。

    1. {
    2. ...
    3. "parts":{
    4. ...
    5. "wasmedge:wasmedge":{}
    6. }

    在 OpenHarmony 中构建的 WasmEdge 目前仅支持 wasmedge,即 wasm 的通用运行时。

    • wasmedge 可以在解释器模式下执行一个 WASM 文件, 也可以在预编译模式下执行通用 Wasm 二进制格式文件, 目前还不支持在 OpenHarmony 中使用预编译模式 。

    通过执行 WasmEdge 源码下的 utils/build_for_ohos.sh 命令行脚本,将自动执行以下工作:

    1. 将 .gn 等 OpenHarmony 需要的构建配置文件移动到 WasmEdge 项目根目录。
    2. 使用 OpenHarmony 的编译工具链进行交叉编译构建 WasmEdge。
    3. 运行 OpenHarmony 的构建脚本 build.sh 进行全量编译,该步骤将 wasmedge 添加进 OpenHarmony OS。

    当显示以下信息时,表明编译完成.

    1. ...
    2. post_process
    3. =====build Hi3516DV300 successful.
    4. 2021-12-15 03:18:50

    当输出的文件名中存在 wasmedge ,表明成功加入 OpenHarmony OS。

    将重新编译后的 OpenHarmony 标准系统镜像烧录进开发板,具体见 OpenHarmony 文档Hi3516DV300开发板烧录

    在 OpenHarmony 标准系统中,WasmEdge 提供了测试样例,并写入了 system 镜像中,供用户进行测试。 通过串口工具连接上开发板并启动OpenHarmony标准系统后,用户可以进行以下测试。

    1. $ cd /system/usr/wasmedge_example
    2. hello
    3. 1
    4. 2
    5. 3
    6. $ wasmedge --reactor add.wasm add 2 2
    7. 4
    8. $ wasmedge --reactor fibonacci.wasm fib 8
    9. 34
    10. $ wasmedge --reactor factorial.wasm fac 12
    11. 479001600
    12. $ cd js
    13. Hello 1 2 3

    接下来,你可以使用 WasmEdge Runtime 在 OpenHarmony 标准系统中进行 WebAssembly 的相关开发工作。