WebAssembly 上手

た入场券 2021-11-01 15:14 542阅读 0赞

<table> 
 <tbody> 
 <tr> 
 <td> <h2>安装</h2> Mac 上最便捷的安装方式当然是通过 Homebrew: 
 <div> 
 <pre>$ brew install emscripten</pre> 
 </div> 安装好之后讲道理就已经自动配置好一切，然后 <code>emcc</code> 命令便可用了。 下面看非 Homebrew 安装的方式。 通过官方 <a href="https://webassembly.org/getting-started/developers-guide/" rel="nofollow">WebAssembly - Developer’s Guide</a> 提供的安装配置步骤进行环境相关设置。这里以 macOS 为例。 <h3>下载工具链</h3> 通过 clone emscripten 仓库到本地进行工具链（toolchain）的下载安装。 
 <div> 
 <pre>$ git clone https://github.com/emscripten-core/emsdk.git
$ cd emsdk</pre> 
 </div> <h3>安装及配置</h3> 执行安装： <pre><code>$ ./emsdk install latest
</code></pre> 激活工具链，生成相应环境配置： 
 <div> 
 <pre>$ ./emsdk activate latest</pre> 
 </div> `./emsdk activate latest` 命令的输出 <pre><code>$ ./emsdk activate latest
Writing .emscripten configuration file to user home directory /Users/wayou/
The Emscripten configuration file /Users/wayou/.emscripten has been rewritten with the following contents:

import os
LLVM_ROOT = '/Users/wayou/dev/emsdk/fastcomp/fastcomp/bin'
BINARYEN_ROOT = '/Users/wayou/dev/emsdk/fastcomp'
NODE_JS = '/Users/wayou/dev/emsdk/node/8.9.1_64bit/bin/node'
SPIDERMONKEY_ENGINE = ''
V8_ENGINE = ''
TEMP_DIR = '/var/folders/qr/dlqjq3zj10xgf2xfx3mybn500000gn/T'
COMPILER_ENGINE = NODE_JS
JS_ENGINES = [NODE_JS]

To conveniently access the selected set of tools from the command line, consider adding the following directories to PATH, or call 'source ./emsdk_env.sh' to do this for you.

/Users/wayou/dev/emsdk:/Users/wayou/dev/emsdk/fastcomp/emscripten:/Users/wayou/dev/emsdk/node/8.9.1_64bit/bin
Set the following tools as active:
 releases-fastcomp-3b8cff670e9233a6623563add831647e8689a86b-64bit
 node-8.9.1-64bit
</code></pre> 小贴士：其中 install 过程会从 <code>https://chromium.googlesource.com</code>，<code>https://storage.googleapis.com</code> 及 <code>https://s3.amazonaws.com</code> 域下载东西，所以最好在命令行配置科学 上网，否则安装会失败。 <h3>环境变量</h3> 通过执行以下命令添加相应命令及目录到环境变量以方便调用： 
 <div> 
 <pre>$ source ./emsdk_env.sh --build=Release</pre> 
 </div> 如果进行到这一步发生如下错误： 
 <div> 
 <pre>$ source ./emsdk_env.sh --build=Release
./emsdk_env.sh (line 19): Missing end to balance this if statement
if [ "$SRC" = "" ]; then
^
from sourcing file ./emsdk_env.sh
 called on standard input

source: Error while reading file './emsdk_env.sh'</pre> 
 </div> 这多半是因为你用的 shell 是 <a href="https://fishshell.com" rel="nofollow">fish</a> 语法不兼容的原因。 两个解决办法： 
 <ul> 
 <li>可通过来自<a href="https://github.com/emscripten-core/emsdk/issues/111" rel="nofollow">emscripten-core/emsdk issue#111</a> 中提供的方法，执行下面的命令来绕开：</li> 
 </ul> 
 <div> 
 <pre>$ bash ./emsdk_env.sh</pre> 
 </div> 
 <ul> 
 <li>因为其也提供了对应的 <code>.fish</code> 脚本，所以，也可以直接选择运行该 fish 脚本来解决上面语法报错的问题：</li> 
 </ul> 
 <div> 
 <pre>$ source ./emsdk_env.fish</pre> 
 </div> 执行成功的输出： 
 <div> 
 <pre>$ source ./emsdk_env.fish
Adding directories to PATH:
PATH += /Users/wayou/dev/emsdk

Setting environment variables:
EMSDK = /Users/wayou/dev/emsdk
EM_CONFIG = /Users/wayou/.emscripten</pre> 
 </div> <h3>检查安装</h3> 完成上面步骤后，可通过运行 <code>emcc --version</code> 命令查看是否安装成功： 
 <div> 
 <pre>$ emcc --version</pre> 
 </div> `emcc --version` 命令的输出 
 <div> 
 <pre>$ emcc --version
cache:INFO: generating system asset: is_vanilla.txt... (this will be cached in "/Users/wayou/.emscripten_cache/is_vanilla.txt" for subsequent builds)
cache:INFO: - ok
emcc (Emscripten gcc/clang-like replacement) 1.38.33 (commit 0490c5f7aaf0e61aafd3b4cfe22cc56b803026b1)
Copyright (C) 2014 the Emscripten authors (see AUTHORS.txt)
This is free and open source software under the MIT license.
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</pre> 
 </div> 如果执行 <code>emcc</code> 时报如下错误： 
 <div> 
 <pre>$ emcc --version
emscripten requires python 2.7.12 or above</pre> 
 </div> 大概率是 macOS 自带的是老版本的 Python2，而 <code>emcc</code> 需要 Python3。解决办法有很多，这里说一个。 尝试过在命令的配置文件中添加 <code>alias</code> 配置 <code>aliast python=python3</code>，是不生效的，但可以将 <code>emcc</code> 命令配置 <code>alias</code> 显式指定使用 <code>python3</code> 来启动。将如下配置添加到相应 shell 的配置文件中，以 fish 为例其配置文件为 <code>~/.config/fish/config.fish</code>: 
 <div> 
 <pre>alias emcc="python3 /Users/wayou/Documents/dev/github/emsdk/fastcomp/emscripten/emcc"
alias em++="python3 /Users/wayou/Documents/dev/github/emsdk/fastcomp/emscripten/em++"
alias emrun="python3 /Users/wayou/Documents/dev/github/emsdk/fastcomp/emscripten/emrun"</pre> 
 </div> 根据官方文档的描述： 
 <blockquote> 
 use em++ to force compilation as C++ --<a href="https://emscripten.org/docs/getting_started/Tutorial.html" rel="nofollow">Emscripten Tutorial</a> 
 </blockquote> <code>em++</code> 用于编译 c++ 代码，所以这里将 <code>em++</code> 也添加上了。 这里同时也将 <code>emrun</code> 添加上了别名，方便后面使用它来启动本地服务以调试。 小贴士：新开命令行窗口或重启命令行后，需要重新执行 <code>source</code> 命令，可将其添加到你所使用的命令行的配置文件中，<code>.bash_profile</code>，<code>.zshrc</code>，或 <code>.</code> 以 fish 为例： ~/.config/fish/config.fish.fish 
 <div> 
 <pre>source "/Users/wayou/dev/emsdk/emsdk_env.fish";</pre> 
 </div> 这样每次启动命令行后 <code>emcc</code> 都是可用状态。 <h2>编译及运行</h2> 安装配置完成后，便可以尝试编译并运行一个简单的 demo 程序了。 一些注意点： 
 <ul> 
 <li>运行 <code>emcc</code> 时需要指定 <code>-s WASM=1</code> 参数，否则默认情况下其输出为 <code>asm.js</code>。</li> 
 <li>除了生成 Wasm 二进制文件及对应的 JavaScript 封装，如果还想要生成一个可直接查看的 HTML 页面，可在输出时指定一个后缀为 <code>.html</code> 的文件。</li> 
 <li>实际运行时不能直接打开这个生成的 HTML 文件，因为 <code>file:///</code> 协议不支持跨域，所以需要本地启一个服务器来查看。</li> 
 </ul><h3>编写 Hello World</h3> 创建 <code>hello.c</code> 文件并输出以下内容： hello.c 
 <div> 
 <pre>#include &lt;stdio.h&gt;
int main(int argc, char ** argv) {
 printf("Hello, world!\n");
}</pre> 
 </div> <h3>编译</h3> 执行以下命令进行编译： 
 <div> 
 <pre>$ emcc hello.c -s WASM=1 -o hello.html</pre> 
 </div> <h3>运行</h3> 通过工具链中提供的 <code>smrun</code> 来开启一个本地服务器以查看刚刚生成的程序： 
 <div> 
 <pre>$ emrun --no_browser --port 8080 .</pre> 
 </div> 当然，使用其他任意 server 也是可以的，比如 Python 的： 
 <div> 
 <pre>$ python -m http.server 8080</pre> 
 </div> 启动成功后浏览器访问 <a href="http://localhost:8080/hello.html" rel="nofollow">http://localhost:8080/hello.html</a>。不出意外你会看到页面中 Emscripten 的控制台展示了 <code>Hello, world!</code>。 <a href="https://user-images.githubusercontent.com/3783096/58644777-8e45fc00-8334-11e9-81cb-b4d27945df56.png" rel="nofollow"><img src="https://user-images.githubusercontent.com/3783096/58644777-8e45fc00-8334-11e9-81cb-b4d27945df56.png" alt="WebAssembly Hello Wrold 运行效果"></a> WebAssembly Hello Wrold 运行效果 但用 <code>emrun</code> 的好处在于它已经处理好了 <code>.wasm</code> 文件的返回类型为 <code>Content-type: application/wasm</code>，而其他 server 可能需要额外的配置，否则默认情况下 <code>.wasm</code> 文件返回到浏览器时其 <code>Content-Type</code> 不对会报错。 <h2>调用 C++ 中的方法</h2> 下面来看如何在 JavaScript 中调用 C++ 定义的方法。 默认情况下，Emscripten 编译后的代码只包含 <code>main</code> 方法相关的调用，其他无关的代码将会在编译时去掉。可通过在方法名前加 <code>EMSCRIPTEN_KEEPALIVE</code> 来防止需要导出的方法被去掉。 将以下代码放入 <code>hello.c</code> 并保存。 
 <div> 
 <pre>#include &lt;stdio.h&gt;
#include &lt;emscripten/emscripten.h&gt;

int main(int argc, char ** argv) {
 printf("Hello World\n");
}

#ifdef __cplusplus
extern "C" {
#endif

void EMSCRIPTEN_KEEPALIVE myFunction(int argc, char ** argv) {
 printf("MyFunction Called\n");
}

#ifdef __cplusplus
}
#endif</pre> 
 </div> 此时编译需要加上 <code>NO_EXIT_RUNTIME</code> 参数，否则默认情况下 C++ 模块中 <code>main</code> 方法返回后程序就结束了。 执行以下命令编译代码： 
 <div> 
 <pre>$ emcc -o hello3.html hello3.c -O3 -s WASM=1 -s NO_EXIT_RUNTIME=1 -s "EXTRA_EXPORTED_RUNTIME_METHODS=['ccall']"</pre> 
 </div> 打开在发生的 <code>hello.html</code>，在第一个 <code>&lt;script&gt;</code> 标签开始前加上一个按钮： 
 <div> 
 <pre>&lt;button class="mybutton"&gt;Run myFunction&lt;/button&gt;</pre> 
 </div> 添加以下点击调用逻辑到第一个 <code>&lt;script&gt;</code> 代码块的末尾： 
 <div> 
 <pre>document.querySelector(".mybutton").addEventListener("click", function() {
 alert("check console");
 var result = Module.ccall(
 "myFunction", // name of C function
 null, // return type
 null, // argument types
 null // arguments
 );
});</pre> 
 </div> 再次启动服务器运行后，点击页面中按钮在控制台观察输出。 <a href="https://user-images.githubusercontent.com/3783096/58781578-e28bfd00-860e-11e9-9cf2-3e26b7030a03.gif" rel="nofollow"><img src="https://user-images.githubusercontent.com/3783096/58781578-e28bfd00-860e-11e9-9cf2-3e26b7030a03.gif" alt="JavaScript 中调用 C++ 方法的示例"></a> JavaScript 中调用 C++ 方法的示例 <h2>相关资源</h2> 
 <ul> 
 <li><a href="https://webassembly.org/getting-started/developers-guide/" rel="nofollow">WebAssembly - Developer’s Guide</a></li> 
 <li><a href="https://developer.mozilla.org/en-US/docs/WebAssembly/C_to_wasm" rel="nofollow">Compiling a New C/C++ Module to WebAssembly</a></li> 
 </ul></td> 
 </tr> 
 </tbody> 
</table>

转载于:https://www.cnblogs.com/Wayou/p/webassembly\_quick\_start.html