# 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 文件会被忽略
• 从微信 8.0.25 开始支持 SIMD 特性

# Q&A

1. 编译出来的 .wasm 体积太大，超过代码包体积限制怎么办？

• 方法一：把一个 wasm 文件拆分为多个 wasm 文件，然后利用分包加载能力来减少首包体积
• 方法二：使用 brotli 压缩 wasm 文件