reactjs - 在 React 中为大文件(超过 4kb)加载 WASM 模块的正确方法

Question

我不知道如何使用 wasm 编译器在 React 代码中加载 C++ 函数。

我的 C++ 由两个文件组成，编译后生成一个 160kb 的 wasm 文件。这是我目前用于编译的命令(在 macOS 上运行)。

em++ ../main.cpp ../stringFormat.cpp -s WASM=1 -s EXPORT_ALL=1 -s MODULARIZE=1 -O3 --closure 1 -o lss.js -std=c++11

然后我将 lss 和 wasm 文件一起复制到我的 React 代码中，在同一个文件夹中。

src
  - utils
    - wasm
      lss.js
      lss.wasm

但是，每当我尝试在另一个文件中导入 lss.js 时，我的应用程序就会因一堆未定义的表达式而崩溃。

我的.js文件

import * as lss from '../wasm/lss'

./src/utils/wasm/lss.js
  Line 10:6:     Expected an assignment or function call and instead saw an expression  no-unused-expressions
  Line 11:69:    Expected an assignment or function call and instead saw an expression  no-unused-expressions
  Line 11:117:   'read' is not defined                                                  no-undef
  Line 11:197:   'readbuffer' is not defined                                            no-undef
  Line 11:214:   'read' is not defined                                                  no-undef
  Line 11:336:   'quit' is not defined                                                  no-undef
  Line 11:367:   Unexpected use of 'print'                                              no-restricted-globals
  Line 11:430:   Unexpected use of 'print'                                              no-restricted-globals
  Line 11:493:   'printErr' is not defined                                              no-undef
  Line 12:1:     Unexpected use of 'print'                                              no-restricted-globals
  Line 12:22:    Expected an assignment or function call and instead saw an expression  no-unused-expressions
  Line 12:26:    Unexpected use of 'self'                                               no-restricted-globals
  Line 14:307:   Expected an assignment or function call and instead saw an expression  no-unused-expressions
  Line 23:174:   Expected an assignment or function call and instead saw an expression  no-unused-expressions
  Line 29:10:    Expected an assignment or function call and instead saw an expression  no-unused-expressions
  Line 29:152:   'readline' is not defined                                              no-undef
  Line 29:260:   Expected an assignment or function call and instead saw an expression  no-unused-expressions
  Line 29:350:   Expected an assignment or function call and instead saw an expression  no-unused-expressions
  Line 29:433:   Expected an assignment or function call and instead saw an expression  no-unused-expressions
  Line 30:19:    Expected an assignment or function call and instead saw an expression  no-unused-expressions
...

我还尝试通过在编译时添加 SIDE_MODULE=1 标志来生成独立的 wasm 文件。

// My util function to load wasm file to js
const loadWebAssembly = (filename, imports = {}) =>
    WebAssembly
        .instantiateStreaming(fetch(filename), imports)
        .then(({instance}) => instance.exports);

// wasm file is now in my static folder, in public/
const lss = loadWebAssembly('wasm/lss.wasm')
    // splitIntoCommonSequences is the C++ function I try to call
    .then(module => Promise.resolve(module.splitIntoCommonSequences));

export {lss};

但后来我又犯了一个错误。

WebAssembly.instantiate(): Import #0 module="env" error: module is not an object or function

我试图弄清楚如何为我的情况声明一个正确的导入对象，但没有成功。他们有更好的解决方案吗？我怎么知道要在我的导入对象中放入什么？

谢谢 !

Answer 1

所以我发现他们有更多的步骤来让 WASM 二进制文件与 React 一起工作，特别是如果你想将它导入 React es6 模块(而不是从公共(public)文件夹)。

我不认为这是一个通用的解决方案，只是对我有用的一个(并且似乎在大多数情况下都有效)。

编译器标志

这是我现在使用的 em++ build 命令:

em++ ../main.cpp ../stringFormat.cpp \
      -Os -g1 \
      -s WASM=1 \
      -s MALLOC=emmalloc \
      -s ALLOW_MEMORY_GROWTH=1 \
      -s EXPORT_ES6=1 \
      -s MODULARIZE=1 \
      -s 'EXPORT_NAME="LongerSubSequence"' \
      -s 'ENVIRONMENT="web"' \
      --bind \
      -o lss.mjs \
      -std=c++11 || exit 1

不确定所有选项，它们可能需要在这里进行一些优化。重要的是:

绑定(bind) :在命名 js 模块时，编译器显然有必要覆盖 C++ 名称修改(默认情况下，C++ 编译器将更改所有变量名称，就像 react 对 css 模块所做的那样)。

EXPORT_ES6 : 会稍微改变一下生成的glue js语法，这样就可以用es6的方式导入了。

模块化 :导出一个通用模块下的所有函数(以 EXPORT_NAME 标志命名)，这样您就可以将 js 作为模块导入并在您的 js 代码中调用 Module.My_CPP_Function。

g1 :保持生成的胶水代码足够可读以管理下一步。

添加文件以使用react

该过程生成两个文件:lss.mjs 和 lss.wasm。他们在 React 的项目树中是这样的:

My_React_Project
  |_public
  | |_/path/to/lss.wasm
  |
  |_src
    |_/path/to/lss.mjs

/path/to/可以是文件夹内的任何路径，甚至是根目录。

适应胶水 JS

最后，为了修复错误，我编辑了生成的 lss.mjs 文件:

添加 /* eslint-disable */在文件顶部，以避免 React 语法错误。

替换 var _scriptDir = import.meta.url;与 var _scriptDir = '/path/to/lss.wasm'; ，相对于公用文件夹。不确定它对于以下步骤是否有用，但 React 只会因 import.meta 语法而崩溃。

替换 scriptDirectory = self.location.href;与 scriptDirectory = window.self.location.href; ，因为 React es6 函数没有绑定(bind)到窗口。

删除以下 block :

var dataURIPrefix = "data:application/octet-stream;base64,";

function isDataURI(filename) {
 return String.prototype.startsWith ? filename.startsWith(dataURIPrefix) : filename.indexOf(dataURIPrefix) === 0;
}

编译器使用它来自动定位二进制文​​件，但我自己处理它。

替换 var wasmBinaryFile = "lss.wasm";与 const wasmBinaryFile = '/path/to/lss.wasm'; ('/' 将指向公​​用文件夹)。

删除:

if (!isDataURI(wasmBinaryFile)) {
 wasmBinaryFile = locateFile(wasmBinaryFile);
}

删除:

function getBinary() {
 try {
  if (wasmBinary) {
   return new Uint8Array(wasmBinary);
  }
  if (readBinary) {
   return readBinary(wasmBinaryFile);
  } else {
   throw "both async and sync fetching of the wasm failed";
  }
 } catch (err) {
  abort(err);
 }
}

替换 getBinaryPromise()具有以下功能:

const getBinaryPromise = () => new Promise((resolve, reject) => {
 fetch(wasmBinaryFile, { credentials: 'same-origin' })
   .then(
     response => {
      if (!response['ok']) {
       throw "failed to load wasm binary file at '" + wasmBinaryFile + "'";
      }
      return response['arrayBuffer']();
     }
   )
   .then(resolve)
   .catch(reject);
});

下面几行，替换

if (!wasmBinary && typeof WebAssembly.instantiateStreaming === "function" && !isDataURI(wasmBinaryFile) && typeof fetch === "function")

和

if (!wasmBinary && typeof WebAssembly.instantiateStreaming === "function" && typeof fetch === "function")

这只是删除了 isDataURI 条件，因为我们“信任”我们提供给二进制文件的路径。

现在使用您的二进制代码

这就是我管理它所需要的一切。现在，在我的任何 react 文件中，我都可以像这样使用我的 c++ 函数:

任何文件.js

import LongerSubSequenceGlue from 'path/to/lss.mjs';
// Avoid main function running if you just want to use another function
const lssModule = LongerSubSequenceGlue({
    noInitialRun: true,
    noExitRuntime: true
});

//...

lssModule.my_cpp_function(...my_params);

在 Chrome、Firefox 和 Safari 上的工作就像一个魅力，稍后将进行更多测试。