介绍

此 SDK 用于使用 AssemblyScript 语言开发 Higress 的 Wasm 插件。

如何使用SDK

创建一个新的 AssemblyScript 项目。

npm init
npm install --save-dev assemblyscript
npx asinit .

在asconfig.json文件中，作为传递给asc编译器的选项之一，包含"use": "abort=abort_proc_exit"。

{
  "options": {
    "use": "abort=abort_proc_exit"
  }
}

将"@higress/proxy-wasm-assemblyscript-sdk": "^0.0.1"和"@higress/wasm-assemblyscript": "^0.0.3"添加到你的依赖项中，然后运行npm install。

本地构建

npm run asbuild

构建结果将在build文件夹中。其中，debug.wasm和release.wasm是已编译的文件，在生产环境中建议使用release.wasm。

注：如果需要插件带有 name section 信息需要带上"debug": true，编译参数解释详见using-the-compiler。

"release": {
  "outFile": "build/release.wasm",
  "textFile": "build/release.wat",
  "sourceMap": true,
  "optimizeLevel": 3,
  "shrinkLevel": 0,
  "converge": false,
  "noAssert": false,
  "debug": true
}

AssemblyScript 限制

此 SDK 使用的 AssemblyScript 版本为0.27.29，参考AssemblyScript Status该版本尚未支持闭包、异常、迭代器等特性，并且JSON，正则表达式等功能还尚未在标准库中实现，暂时需要使用社区提供的实现。