mirror of
https://github.com/alibaba/higress.git
synced 2026-02-18 21:10:53 +08:00
54 lines
1.4 KiB
Markdown
54 lines
1.4 KiB
Markdown
## 介绍
|
||
|
||
此 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/wasm-assemblyscript": "^0.0.4"`添加到你的依赖项中，然后运行`npm install`。
|
||
|
||
### 本地构建
|
||
|
||
```
|
||
npm run asbuild
|
||
```
|
||
|
||
构建结果将在`build`文件夹中。其中，`debug.wasm`和`release.wasm`是已编译的文件，在生产环境中建议使用`release.wasm`。
|
||
|
||
注：如果需要插件带有 name section 信息需要带上`"debug": true`，编译参数解释详见[using-the-compiler](https://www.assemblyscript.org/compiler.html#using-the-compiler)。
|
||
|
||
```json
|
||
"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](https://www.assemblyscript.org/status.html)该版本尚未支持闭包、异常、迭代器等特性，并且JSON，正则表达式等功能还尚未在标准库中实现，暂时需要使用社区提供的实现。
|
||
|