Emscripten 工具链要求

以下说明列出了 Emscripten 环境中的主要工具和依赖项，以及有关如何测试哪些依赖项已安装的说明。

提示

该 SDK 提供获取、使用、更新和管理 Emscripten 环境的最简单和最可靠方法。如果你正在使用 SDK，你将不需要这些说明——它们仅供参考。

以下说明适用于你 手动 从源代码构建的情况。

你需要什么

Emscripten 工具和依赖项

一般来说，完整的 Emscripten 环境需要以下工具。首先使用 以下说明 测试它们是否已安装。

  • Node.js（0.8 或更高版本；0.10.17 或更高版本可在 node 中运行使用 websockets 的服务器）

  • Python（3.6 或更高版本）

  • Java（1.6.0_31 或更高版本）。Java 是可选的。它可用于运行 java 版本的 term:Closure Compiler。

  • Git 客户端。如果要从源代码构建工具，则需要 Git。

  • LLVM（LLVM，包括 clang 和 wasm-ld）

  • Binaryen（Binaryen，包括 wasm-opt、wasm-emscripten-finalize 等）

  • GitHub 上的 Emscripten 代码

注意

如果你想运行测试套件中的100%测试（特别是针对仅在 d8 中存在的极新功能的测试），还需要 d8 shell。大多数开发者不需要这样做，应该使用node.js。

编译器工具链

从源代码构建 Emscripten 时，无论是以“手动”方式还是使用 SDK，都需要编译器工具链

  • Windows：安装 Visual Studio 2017 和 cmake。

    注意

    • SDK 用户还可以安装并激活 MinGW 编译器工具链，以便构建自己的项目

      emsdk install mingw-4.6.2-32bit
emsdk activate mingw-4.6.2-32bit

  • Linux：安装gcc 和cmake

    #Install gcc
sudo apt-get install build-essential
# Install cmake
sudo apt-get install cmake

  • macOS：安装Xcode 命令行工具

    • 从 macOS App Store 安装 Xcode。

    • 在Xcode | 首选项 | 下载中，安装命令行工具。

注意

从源代码构建 LLVM 和 Clang 可能需要大量内存和硬盘空间。具体要求会因 LLVM 版本而异，但你可能至少需要 2GB 的 RAM，最好是 4GB 或更多。调试构建或带有断言的构建可能需要更多内存。

测试哪些工具已安装

某些工具在各种平台上预先安装（例如，Python 始终在 Linux 构建中可用）。

你可以使用以下命令检查哪些工具已存在

# Check for Python
python --version

# Check for node.js on Linux
nodejs --version

# Check for node.js on Windows
node --version

# Check for node.js on macOS
node -v

# Check for git
git --version

# Check for Java
java -version

# Check for gcc / g++
gcc --version
g++

# Check for cmake
cmake