# WXWebAssembly

WXWebAssembly 类似于 Web 标准 WebAssembly,能够在一定程度上提高小游戏的性能。

从基础库 v2.13.0 开始,小游戏可以在全局访问并使用 WXWebAssembly 对象。

从基础库 v2.15.0 开始,小游戏支持在 Worker 内使用 WXWebAssembly。

# WXWebAssembly.instantiate(path, imports)

和标准 WebAssembly.instantiate 类似,差别是第一个参数只接受一个字符串类型的代码包路径,指向代码包内 .wasm 文件

# 与 WebAssembly 的异同

  1. WXWebAssembly.instantiate(path, imports) 方法,path为代码包内路径(支持 .wasm 和.wasm.br后缀)
  2. 支持 WXWebAssembly.Memory
  3. 支持 WXWebAssembly.Table
  4. 支持 WXWebAssembly.Global
  5. export 支持函数、Memory、Table,iOS 平台暂不支持 Global

# 其他说明

  • 关于 WebAssembly 的文档可以参考 https://webassembly.org/
  • 基础库 v2.14.0 之后,新增了一些 WXWebAssembly 特性
    • 代码包路径允许传入 brotli 压缩的 wasm 文件,如 .wasm.br
    • 增加对 WXWebAssembly.Global 的支持
  • 小游戏插件从基础库 v2.18.1 开始支持 WXWebAssembly
  • 在 Worker 内使用 WXWebAssembly 时,.wasm 文件需要放置在 worker 目录外,因为 worker 目录只会打包 .js 文件,非 .js 文件会被忽略

# Q&A

  1. 编译出来的 .wasm 体积太大,超过代码包体积限制怎么办?
  • 方法一:把一个 wasm 文件拆分为多个 wasm 文件,然后利用分包加载能力来减少首包体积
  • 方法二:使用 brotli 压缩 wasm 文件