下载和安装¶
注意
你也可以 从源代码构建 Emscripten ，如果你更喜欢这样做，而不是使用 emsdk 下载二进制文件。
提示
如果你想使用**非官方**软件包而不是**官方支持**的 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 页面 上选择“克隆或下载 => 下载 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 Subsystem for Linux 来运行 Emscripten，而不是直接在 Windows 上运行它。
macOS¶
注意
Emscripten 需要 macOS 10.14 Mojave 或更高版本。
如果你使用 Emscripten SDK，它将包含一个捆绑的 Python 3 版本。否则，你需要手动安装和使用 Python 3.6 或更新版本。
这些说明解释了如何安装**所有** 所需工具。你可以在平台上 测试其中一些工具是否已安装 并跳过这些步骤。
安装Xcode 命令行工具。这些是git的先决条件。
从 macOS App Store 安装 Xcode。
在Xcode | 首选项 | 下载中，安装命令行工具。
安装git
安装 Xcode 和 Xcode 命令行工具（应该已经完成）。这将为系统 PATH 提供git（请参阅 这篇文章）。
直接从 https://git.js.cn/ 下载并安装 git。
如果你还没有安装cmake，请安装它
从 Kitware CMake 下载 下载并安装最新版本的 CMake。
Linux¶
注意
Emsdk不会将任何工具安装到系统中，也不会与 Linux 软件包管理器交互。所有文件更改都将在emsdk/目录内完成。
Emsdk不会提供Python。用户应该事先使用系统软件包管理器安装它
# 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.js，它可能是 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 的目录即可。
你也可以 使用 emsdk 删除 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 页面以获取更多详细信息和示例。
使用非官方软件包安装¶
注意
Emscripten 项目官方唯一支持使用 Emscripten 的方法是使用 emsdk，也是我们持续测试的唯一方法（emsdk CI、Emscripten GitHub CI、Chromium CI）。
虽然我们不官方支持其他获取 Emscripten 的方法，但我们非常感谢第三方为了用户的便利而对 打包 Emscripten做出的努力，我们很乐意提供帮助，如果您是打包者，请联系我们！
以下是部分非官方 Emscripten 包列表
- Windows
包信息：chocolatey 中的 emscripten
维护者：@aminya
- Homebrew
维护者：@chenrui333
- Arch Linux
维护者：Sven-Hendrik Haase <svenstaro@archlinux.org>