Emscripten SDK

Emscripten工具链以独立的Emscripten SDK形式分发。该SDK提供所有必需的工具，如Clang、Python和Node.js，以及一个更新机制，使得在新版本Emscripten发布时能够迁移到更新的版本。

您也可以不使用预构建的SDK，从源代码安装Emscripten，详见下文"从源代码安装"部分。

下载 / 如何获取最新的Emscripten构建？

要开始Emscripten开发，请参阅Emscripten网站文档。

该文档解释了如何使用emsdk获取最新的二进制构建（无需从源代码编译）。基本上，步骤如下：

./emsdk install latest
./emsdk activate latest

SDK概念

Emscripten SDK实际上是一个小型包管理器，用于管理与Emscripten配合使用的工具。以下术语表突出了重要概念，有助于理解SDK的内部工作原理：

工具：SDK中捆绑的软件基本单元。工具有名称和版本。例如，'clang-3.2-32bit'是一个包含32位版本Clang v3.2编译器的工具。
SDK：一组工具的集合。例如，'sdk-1.5.6-32bit'是一个SDK，包含clang-3.2-32bit、node-0.10.17-32bit、python-2.7.5.1-32bit和emscripten-1.5.6这些工具。
活动工具/SDK：Emscripten SDK在emsdk目录中的.emscripten文件中存储编译器配置。该文件指向Emscripten、Python、Clang等的路径。如果配置文件指向特定目录中的工具，则该工具被称为活动工具。这种机制允许在不同已安装的工具和SDK之间切换。
emsdk：这是访问Emscripten SDK的管理脚本的名称。大多数操作的形式为emsdk <命令>。

系统要求

使用emsdk预编译包只需要最少的依赖项，如下所列。从源代码构建时，需要更广泛的工具，包括git、cmake和主机编译器。详见： https://emscripten.org/docs/building_from_source/toolchain_what_is_needed.html。

Mac OS X

对于基于Intel的Mac，需要macOS 10.13或更高版本。对于基于ARM64 M1的Mac，需要macOS 11.0或更高版本。
java：用于运行closure编译器（可选）。通过emsdk安装emscripten后，输入'emcc --help'应该会弹出一个OS X对话框"Java未安装。要打开java，您需要Java SE 6运行时。是否现在安装？"，这将自动下载Java运行时到系统中。

Linux

python：版本2.7.0或更高。
java：用于运行closure编译器（可选）

emsdk预编译二进制文件是针对Ubuntu/Focal 20.04 LTS构建的，因此依赖于与该版本中glibc和libstdc++版本兼容的系统库。如果您的Linux发行版非常旧，可能无法使用预编译的二进制包。

Windows

java：用于运行closure编译器（可选）

卸载Emscripten SDK

要删除Emscripten SDK，只需删除emsdk目录即可。

SDK维护

以下是Emscripten SDK的常见任务：

如何使用emsdk工具？

运行emsdk help或仅emsdk以获取所有可用命令的信息。

如何检查SDK和工具的安装状态和版本？

要获取所有当前已安装工具和SDK版本的列表，以及所有可用工具，请运行emsdk list。

每个可安装的工具/SDK都会打印一行。
已安装的每个工具旁边会显示"INSTALLED"文字。
如果工具/SDK当前处于活动状态，其旁边会显示一个星号*。
如果工具/SDK当前处于活动状态，但您调用emsdk的终端尚未设置PATH和环境以使用该工具，其旁边会显示括号中的星号(*)。运行emsdk_env.bat（Windows）或source ./emsdk_env.sh（Linux和OS X）以为调用终端设置环境。

如何安装工具/SDK版本？

运行命令emsdk install <工具/SDK名称>以下载并安装新工具或SDK版本。

如何删除工具或SDK？

运行命令emsdk uninstall <工具/SDK名称>以从本地硬盘完全删除给定的工具或SDK。

如何检查Emscripten SDK的更新？

emsdk update将获取所有新工具和SDK版本的包信息。之后，运行emsdk install <工具/SDK名称>以安装新版本。

如何安装旧版本的Emscripten编译器？

Emsdk包含旧编译器版本的历史记录，您可以使用它们来维护迁移路径。输入emsdk list --old以获取存档工具和SDK版本的列表，然后使用emsdk install <工具名称>进行安装。

我想从源代码构建！

一些Emsdk工具和SDK目标引用预编译的包，安装时无需编译。其他Emsdk工具和SDK目标"来自源代码"，这意味着它们将使用git获取源代码仓库，并按需编译包。

当您运行emsdk list时，它会将工具和SDK分为这两类。

要从源代码获取并构建最新的wasm SDK，请运行

emsdk install sdk-main-64bit
emsdk activate sdk-main-64bit

您可以使用此目标来引导开发LLVM、Binaryen或Emscripten的补丁。（初始安装后，在克隆的树中使用git remote add添加您自己的分支，以推送更改作为补丁）

如果您只打算为Emscripten仓库做贡献，而不是LLVM或Binaryen，您也可以使用它们的预编译版本，只需git克隆Emscripten仓库。有关更多详细信息，请参阅

https://emscripten.org/docs/contributing/developers_guide.html?highlight=developer#setting-up

在处理从源代码编译的git分支时，如何更新到较新的编译器版本？

与标签和预编译版本不同，一些SDK包基于"移动"的git分支并从源代码编译（例如sdk-main、emscripten-main、binaryen-main）。因此，随着新提交被引入开发分支，编译版本最终会过时。要更新这些分支之一的旧编译安装，只需对该工具/SDK重新发出"emsdk install"命令。这将git pull分支的最新更改，并对目标进行增量重新编译。通过这种方式，您可以继续调用emsdk install来保持Emscripten安装与给定git分支同步。请注意，如果之前编译的分支非常旧，有时 CMake 会感到困惑，无法正确重建项目。这在过去曾经发生过，例如当 LLVM 迁移到要求更新的 CMake 版本时。如果出现任何奇怪的编译错误，建议在重新执行 emsdk install 之前尝试删除中间构建目录（例如 "emsdk/clang/fastcomp/build_xxx/"）以清除构建。

如何更改当前激活的 SDK 版本？

您可以通过运行 emsdk activate <工具/SDK名称> 在不同的工具和 SDK 版本之间切换。激活一个工具将设置 ~/.emscripten 指向该特定工具。在 Windows 上，您可以向 activate 命令传递 --permanent 选项，为当前用户永久注册环境。使用 --system 可以为所有用户执行此操作。

如何使用 SDK 跟踪最新的 Emscripten 开发？

Emscripten SDK 的一个常见且受支持的用例是启用直接与 GitHub 存储库交互的工作流程。这允许您在新功能和最新修复被推送到 GitHub 存储库时立即获得它们，而无需等待发布标签。您不需要 GitHub 账户或 Emscripten 的分支来执行此操作。要切换到使用最新的 git 开发分支 main，请运行以下命令：

emsdk install git-1.9.4 # 安装 git。如果系统已有则跳过。
emsdk install sdk-main-64bit # 克隆并拉取最新的 emscripten-core/emscripten/main。
emsdk activate sdk-main-64bit # 将 main SDK 设置为当前活动的 SDK。

如何在 SDK 中使用我自己的 Emscripten GitHub 分支？

也可以通过 SDK 使用您自己的 Emscripten 存储库分支。这是通过标准的 git 机制实现的，所以如果您已经熟悉在 git 克隆中处理多个远程仓库，这些步骤对您来说应该很熟悉。当您想对 Emscripten 工具链进行自己的修改，但仍然继续使用 SDK 环境和工具时，这很有用。要将您自己的分支设置为当前活动的 Emscripten 工具链，首先按照上一节所示安装 sdk-main SDK，然后在 emsdk 目录中运行以下命令：

cd emscripten/main
# 添加指向您自己存储库的 git 远程链接。
git remote add myremote https://github.com/mygituseraccount/emscripten.git
# 获取您链接中的更改。
git fetch myremote
# 将 emscripten-main 工具切换到使用您的分支。
git checkout -b mymain --track myremote/main

通过这种方式，您可以使用 Emscripten SDK 工具的同时使用您自己的 git 分支。您可以像往常一样通过 git checkout 命令在远程仓库之间切换。

如何使用 Emscripten SDK 与自定义版本的 Python、Java、Node.js 或其他工具？

提供的 Emscripten SDK 目标是元包，它们引用了一组经过测试可以一起工作的特定工具。例如，sdk-1.35.0-64bit 是 clang-e1.35.0-64bit、node-4.1.1-64bit、python-2.7.5.3-64bit 和 emscripten-1.35.0 这些单独包的别名。这意味着如果您安装此版本的 SDK，Python 和 Node.js 也会被安装在 emsdk 内。如果您想使用自己的或系统的 Python 或 Node.js，您可以选择通过指定想要使用的单独包集来安装 emsdk。例如，emsdk install clang-e1.35.0-64bit emscripten-1.35.0 将只安装 Emscripten LLVM/Clang 编译器和 Emscripten 前端，而不提供 Python 和 Node.js。

我的安装失败，出现 "fatal error: ld terminated with signal 9 [Killed]"？

这可能是因为系统内存不足。如果您正在尝试从源代码构建某个包，并且在虚拟操作系统中运行或可能有相对较少的 RAM 和磁盘空间可用，那么构建可能会失败。请尝试为您的计算机提供更多内存。另一种方法是强制 emsdk install 在单线程模式下构建，这将同时需要更少的 RAM。要做到这一点，请向 emsdk install 命令传递 -j1 标志。

如何在 32 位系统或非 x86-64 系统上运行 Emscripten？

Emscripten SDK 发布版不再为 32 位系统打包或维护。如果您想在 32 位系统上运行 Emscripten，可以尝试手动构建编译器。按照上面"从源代码构建 Emscripten 标签或分支"部分的步骤开始操作。