Emscripten学习笔记之胶水代码

本文介绍: Em script e n 是一个可以将 C 和 C++ 代码编译为 Jav aScri p t 的工具链。它可以将 C/C++ 代码转换为高效的 Jav aSc rip t，并生成相应的 HTML 和 Jav aSc rip t 胶水代码，以便在浏览器中运行。这将生成一个 HTML 文件（）和一个 Jav aSc rip t 文件（3. 最后，我们需要在浏览器中打开生成的 HTML 文件。这将会运行我们的 C 代码，并输出 “Hel lo, Wo r ld!生成的文件就是我们的 Jav aSc rip t 胶水代码。

Em script e n 是一个可以将 C 和 C++ 代码编译为 Jav aSc rip t 的工具链。它可以将 C/C++ 代码转换为高效的 Jav aSc ript，并生成相应的 HTML 和 Ja vaSc ript 胶水代码，以便在浏览器中运行。

下面是一个简单的例子，展示了如何使用 Em script en 生成 Ja vaScr ipt 胶水代码：

首先，我们需要编写一段简单的 C 代码，例如：

#include <stdio.h&gt;  
  
int main() {  
    printf("Hello, World!n");  
    return 0;  
}

然后，我们需要使用 Em scripten 将这段 C 代码编译为 Ja vaScr ipt：

emcc hello_world.c -s WASM=1 -O3 -o hello_world.html

这将生成一个 HTML 文件（hello_world.html）和一个 JavaScript 文件（hello_world.js）。

3. 最后，我们需要在浏览器中打开生成的 HTML 文件。这将会运行我们的 C 代码，并输出 “Hel lo, World!”。

生成的 hello_world.js 文件就是我们的 JavaScript 胶水代码。它包含了将 C/C++ 代码与 JavaScript 运行时环境连接起来所需的所有代码。我们可以直接使用这个文件，或者修改它以满足我们的特定需求。

由Em scripten生成的JavaScript胶水代码hello_world.js，我们可以发现，大多数的操作，都围绕全局对象Module展开，而该对象正是Emsc ri pten程序运行时的核心所在。

WebAssem bly 模块的载入（`.wasm`文件）

WebAssembly 模块（既.wasm文件）的载入是在createWasm 函数中完成的。

createWasm 函数的代码干了这几件事：

尝试使用WebAssembly.instantiateStreaming()方法创建 wasm模块的实例；
如果流式创建失败，则改用WebAssembly.instantiate()方法创建实例；
成功实例化后的返回值交由receiveInstantiatedSource()方法处理。

receiveInstantiatedSource()相关代码如下：

    function receiveInstance(instance, module) {
      exports = instance.exports;
      if (exports.memory) mergeMemory(exports.memory);
      Module['asm'] = exports;
      Module["usingWasm"] = true;
      removeRunDependency('wasm-instantiate');
    }

    ......

    function receiveInstantiatedSource(output) {
      // 'output' is a WebAssemblyInstantiatedSource object which has both the module and instance.
      // receiveInstance() will swap in the exports (to Module.asm) so they can be called
      assert(Module === trueModule, 'the Module object should not be replaced during async compilation - perhaps the order of HTML elements is wrong?');
      trueModule = null;
      receiveInstance(output['instance'], output['module']);
    }

receiveInstantiatedSource()方法调用了receiveInstance()方法，后者的这条指令：

      Module['asm'] = exports;

将wasm模块实例的导出对象传给了Module的子对象asm。

Module对象：

mscri pten生成的JavaScript胶水代码中，全局对象Module是非常重要的部分。Module对象为Emscripten应用提供了许多功能，包括访问浏览器API、处理输入输出、存储数据等。

Module对象是Emscripten运行时环境的核心，它充当了宿主程序与JavaScript运行环境之间的桥梁。使用Module对象，可以将C/C++代码与JavaScript运行环境集成在一起，实现高效的代码转换和执行。

在生成的JavaScript胶水代码中，你可以看到很多对Module对象的调用，比如Module.onRuntimeInitialized = function() {...}、Module.ccall('my_function', 'number', ['number'])等等。这些都是利用Module对象来执行一些特定的操作，比如在运行时初始化、调用C/C++函数等。