下載並安裝¶
注意
如果您不想使用 emsdk 下載二進位檔，也可以從原始碼建置 Emscripten。
提示
如果您想使用非官方套件而不是官方支援的 emsdk 安裝 emscripten，請參閱頁面底部。
使用 emsdk 的安裝說明（推薦）¶
首先檢查下面的平台特定注意事項，並安裝任何先決條件。
核心 Emscripten SDK (emsdk) 驅動程式是一個 Python 腳本。您可以第一次使用以下方式取得它
# Get the emsdk repo git clone https://github.com/emscripten-core/emsdk.git # Enter that directory cd emsdk
注意
您也可以在 emsdk GitHub 頁面上選擇「Clone or download => Download ZIP」來取得 emsdk，而無需 git。
執行下列 emsdk 命令，從 GitHub 取得最新工具並將它們設定為作用中
# Fetch the latest version of the emsdk (not needed the first time you clone) git pull # Download and install the latest SDK tools. ./emsdk install latest # Make the "latest" SDK "active" for the current user. (writes .emscripten file) ./emsdk activate latest # Activate PATH and other environment variables in the current terminal source ./emsdk_env.sh注意
在 Windows 上，執行
emsdk.bat而不是./emsdk，以及emsdk_env.bat而不是source ./emsdk_env.sh。注意
在 Windows 上，如果您使用
activate命令，則emsdk_env.bat的步驟是選用的。如果您想了解更多資訊，請參閱啟動 SDK 版本。注意
git pull將會提取目前的標籤清單，但最近的標籤可能尚未出現在那裡。您可以執行./emsdk update-tags直接更新標籤清單。
如果您變更 SDK 的位置（例如，將它帶到 USB 上的另一台電腦），請重新執行 ./emsdk activate latest 和 source ./emsdk_env.sh 命令。
Emsdk 安裝目標¶
在上面的說明中，我們要求 emsdk 安裝並啟動 latest，這是最新的標記版本。這通常是您想要的。
您也可以透過指定它來安裝特定版本，例如，
./emsdk install 1.38.45
注意
當從建置基礎結構重寫之前安裝舊版本時（任何早於 1.38.33 的版本），您需要撰寫類似 ./emsdk install sdk-1.38.20-64bit 的程式碼（新增 sdk- 和 -64bit），因為那是當時的命名慣例。
還有「樹狀結構頂端建置」，這是通過 Chromium CI 整合測試的最新程式碼。它的更新頻率比標記版本高得多，但可能較不穩定（我們使用更謹慎的程序手動標記版本）。樹狀結構頂端建置可能適用於使用 emsdk 的持續整合（如同 Emscripten 的 GitHub CI 所做的那樣），您可能也想在自己的 CI 中使用它，這樣如果您在專案中發現回歸問題，可以回報它並防止它進入標記版本。如果您想測試剛加入但尚未發布的功能，樹狀結構頂端建置也可能很有用。若要使用樹狀結構頂端建置，請使用 tot 目標，並請注意，您必須明確指定後端，
# Get a tip-of-tree ./emsdk install tot
（在上面的範例中，我們安裝了各種目標；請記住也要像稍早的完整範例一樣 activate 它們。）
平台特定注意事項¶
Windows¶
安裝 Python 3.6 或更新版本（較舊的版本可能因為 GitHub 變更與 SSL 而無法運作）。
注意
您可以使用適用於 Linux 的 Windows 子系統在 Linux 環境中執行它，而不是直接在 Windows 上執行 emscripten。
macOS¶
注意
Emscripten 需要 macOS 10.14 Mojave 或以上版本。
如果您使用 Emscripten SDK，它會包含一個捆綁的 Python 3 版本。否則，您需要手動安裝並使用 Python 3.6 或更新版本。
這些說明解釋了如何安裝所有所需的工具。您可以測試平台是否已安裝其中一些工具，並跳過這些步驟。
安裝 Xcode Command Line Tools。這是 git 的先決條件。
從 macOS App Store 安裝 Xcode。
在 Xcode | 偏好設定 | 下載 中，安裝 Command Line Tools。
安裝 git
安裝 Xcode 和 Xcode Command Line Tools (應該已經完成)。這會將 git 提供給系統 PATH (請參閱這個 stackoverflow 貼文)。
直接從 https://git.dev.org.tw/ 下載並安裝 git。
如果您還沒有安裝 cmake，請安裝它
從 Kitware CMake 下載 下載並安裝最新的 CMake。
Linux¶
注意
Emsdk 不會將任何工具安裝到系統中，也不會與 Linux 套件管理器互動。所有檔案變更都在 emsdk/ 目錄內完成。
Python 不是由 emsdk 提供。使用者需要事先使用系統套件管理器安裝。
# Install Python sudo apt-get install python3 # Install CMake (optional, only needed for tests and building Binaryen or LLVM) sudo apt-get install cmake
注意
如果您想使用系統的 Node.js 而不是 emsdk 的，它可能是 node 而不是 nodejs，您可以調整您的 .emscripten 檔案的 NODE_JS 屬性以指向它。
Git 不會自動安裝。只有當您想使用開發分支中的工具時，才需要 Git。
# Install git sudo apt-get install git
驗證安裝¶
驗證安裝的最簡單方法是使用 Emscripten 編譯一些程式碼。
您可以直接跳到Emscripten 教學，但如果您在建置時遇到任何問題，您應該執行 驗證 Emscripten 開發環境 中的基本測試和疑難排解說明。
更新 SDK¶
提示
您只需要安裝一次 SDK！之後，您可以隨時使用Emscripten SDK (emsdk)更新到最新的 SDK。
在命令提示字元中輸入以下內容
# Fetch the latest registry of available tools.
./emsdk update
# Download and install the latest SDK tools.
./emsdk install latest
# Set up the compiler configuration to point to the "latest" SDK.
./emsdk activate latest
# Activate PATH and other environment variables in the current terminal
source ./emsdk_env.sh
套件管理器可以執行許多其他維護任務，從擷取 SDK 的特定舊版本到使用 GitHub 上工具的版本（甚至您自己的分支）。請在「操作指南」中查看所有可能性。
解除安裝 Emscripten SDK¶
如果您想移除整個 SDK，只需刪除包含 SDK 的目錄即可。
使用 Docker 映像檔¶
整個 Emscripten SDK 也以docker 映像檔的形式提供。例如
docker run --rm -v $(pwd):/src -u $(id -u):$(id -g) \
emscripten/emsdk emcc helloworld.cpp -o helloworld.js
請參閱 Docker Hub 頁面以取得更多詳細資訊和範例。
使用非官方套件安裝¶
注意
emsdk 是 Emscripten 專案支援的唯一官方支援的使用 Emscripten 的方式，也是我們不斷測試的方式（emsdk CI、Emscripten GitHub CI、Chromium CI）。
雖然我們不正式支援其他取得 Emscripten 的方式，但我們絕對感謝第三方為方便使用者而封裝 Emscripten所做的努力，並且我們很樂意提供協助，如果您是這樣的封裝者，請與我們聯絡！
以下是非官方 emscripten 套件的部分清單
- Windows
套件資訊：emscripten 在 chocolatey 中
維護者：@aminya
- Homebrew
維護者：@chenrui333
- Arch Linux
維護者：Sven-Hendrik Haase <svenstaro@archlinux.org>