Emscripten 工具鏈需求

以下說明列出了 Emscripten 環境中的主要工具和相依性，以及如何測試已安裝哪些相依性的說明。

提示

SDK 提供取得、使用、更新和管理 Emscripten 環境的 最簡單 且 最可靠 的方法。如果您使用的是 SDK，您就 不需要 這些說明 — 它們僅供參考。

如果您要手動從原始碼建置，則以下說明會很有用。

您需要的東西

Emscripten 工具和相依性

一般來說，完整的 Emscripten 環境需要以下工具。首先，使用以下說明測試是否已安裝它們。

  • Node.js (0.8 或以上版本；0.10.17 或以上版本才能在 node 中執行使用 websocket 的伺服器)

  • Python (3.6 或以上版本)

  • Java (1.6.0_31 或更新版本)。Java 是可選的。它可以用來執行 term:Closure Compiler 的 java 版本。

  • 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 Command Line Tools

    • 從 macOS App Store 安裝 Xcode。

    • 在 Xcode | 偏好設定 | 下載 中，安裝 Command Line Tools。

注意

從原始碼建置 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