Emscripten SDKemsdk完全指南命令语法、安装配置与多版本维护实战【免费下载链接】emscriptenEmscripten: An LLVM-to-WebAssembly Compiler项目地址: https://gitcode.com/gh_mirrors/em/emscriptenEmscripten SDK简称emsdk是 Emscripten 官方提供的 SDK 维护工具负责完成工具链的全部下载、安装、卸载与版本切换工作——你只需安装一次 SDK之后所有更新都可以交给 emsdk 完成。本文以 emsdk.rst 为核心系统讲解 emsdk 的命令行语法、SDK 核心概念、.emscripten编译器配置文件并结合仓库源码如 tools/config.py说明配置的底层加载机制最后给出从安装最新版到使用自己的 fork的完整实操指南。emsdk 是什么Emscripten 工具链本身由多种工具组成包括Clang、Emscripten、Java、Git、Node等。emsdk本质上是一个轻量级包管理器负责两件事控制安装哪些工具——从可用的工具/SDK 清单中下载并安装到本地控制激活哪些工具——从已安装的工具集合中选出当前默认使用的一套编译器配置。通过 emsdk你可以下载、安装或移除任意SDK 或 Tool甚至可以在开发中使用 GitHub 上持续构建的 :ref:bleeding edge 版本即tot/sdk-main-64bit目标。所有操作的基本形式为./emsdk command。在 Windows 上使用 emsdk 前需要先启动 Emscripten Command PromptLinux/macOS 直接使用./emsdkWindows 使用emsdk。命令行语法与参数说明emsdk 的命令行语法为./emsdk [help | list [--old] | update | install tool/sdk | uninstall tool/sdk | activate tool/sdk]各命令的作用如下表所示命令说明list [--old]列出当前所有可用的 SDK 与工具及其安装状态加上--old参数时同时显示历史归档版本update获取最新可用工具与 SDK 的注册表信息只更新清单不安装install tool/sdk下载并安装指定的工具或 SDKuninstall tool/sdk从磁盘上删除指定的工具或 SDKactivate tool/sdk将指定工具或 SDK 设为系统环境中的默认工具在 Linux 上还需用source ./emsdk_env.sh启用环境设置见下文如何切换当前激活的 SDK 版本help列出所有支持的命令不指定任何命令时输出同样的列表注意事项Linux 和 macOS 上命令以./emsdk调用Windows 上直接使用emsdk。命令参数tool/sdk就是./emsdk list或./emsdk list --old输出中的某个目标名称。某些工具和 SDK 名称中包含master或main这些目标用于从 Emscripten 的 main/master 分支克隆并拉取最新代码。可以指定latest目标来获取当前最新的 SDK。SDK 核心概念工具Tool与 SDK 目标Tool 与 SDK 的区别Tool单个可安装组件例如node-0.10.17-64bit、git-1.8.3、clang-upstream-main-64bit。可以使用./emsdk install node-0.10.17-64bit单独安装也可以用空格分隔一次性安装多个./emsdk install node-0.10.17-64bit java-7.45-64bit。SDK为某个特定 Emscripten 发行版打包的完整工具集合的便捷目标。例如下面两条命令是等价的./emsdk install sdk-upstream-main-64bit ./emsdk install git-1.8.3 clang-upstream-main-64bit node-0.10.17-64bit python-2.7.5.3-64bit java-7.45-64bit llvm-git-main-64bit emscripten-main-64bit可见 SDK 目标是对一组工具目标的聚合别名省去了逐个安装的繁琐操作。激活状态与存储位置安装好的 SDK或 Tool可以被设为active激活状态表示运行 Emscripten 时默认使用这套工具。激活的编译器配置存储在 emsdk 目录下的配置文件.emscripten中。不同工具和 SDK 在首次安装时指定的根目录下按工具名 版本分组存放在各自独立的子目录中便于版本隔离与切换。Emscripten 编译器配置文件.emscripten文件的作用编译器配置文件代表emsdk保存当前active配置它定义了在 Emscripten Command Prompt 中调用 Emscripten 时默认使用的具体工具集合。文件名固定为.emscripten它是 emsdk 专属的不会与系统中其他地方可能存在的配置文件冲突。除非你正在 从源码构建 Emscripten否则一般不应直接修改该文件正确做法是使用emsdk activate tool/SDK来激活特定 SDK 或工具让 emsdk 代为写入配置。配置示例Windows SDK 生成的.emscripten文件示例# .emscripten file from Windows SDK import os LLVM_ROOTC:/Program Files/Emscripten/clang/e1.21.0_64bit NODE_JSC:/Program Files/Emscripten/node/0.10.17_64bit/node.exeLinux SDK 生成的.emscripten文件示例# .emscripten file from Linux SDK import os NODE_JS node LLVM_ROOT/home/ubuntu/emsdk/upstream/bin注意示例中的变量名LLVM_ROOT指向 Clang/LLVM 工具链目录NODE_JS指向 Node.js 解释器。从 tools/config.py 的源码看编译器实际支持的配置键还包括BINARYEN_ROOTBinaryen 工具根目录、LLVM_ADD_VERSION、CLANG_ADD_VERSION、CLOSURE_COMPILERClosure Compiler 路径、FROZEN_CACHE、CACHE缓存目录、PORTS端口库目录与COMPILER_WRAPPER。配置文件的底层加载机制从源码层面看emcc启动时会通过 tools/config.py 中的parse_config_file()用 Python 的exec解析.emscripten文件。值得注意的实现细节环境变量覆盖任何CONFIG_KEYS中的键都可以通过EM_KEY形式的环境变量覆盖配置文件中的值例如EM_LLVM_ROOT、EM_CACHE、EM_BINARYEN_ROOT等且这些路径类环境变量必须是绝对路径否则会报错退出。CFGDIR 展开解析前会在环境中设置CFGDIR指向配置文件所在目录支持类似 LLVM 配置文件中的路径展开语法。自动探测兜底如果配置文件缺失或未设置某键read_config()会尝试在 PATH 中查找clang、node、wasm-opt来推断LLVM_ROOT、NODE_JS、BINARYEN_ROOT见 tools/config.py若仍找不到则提示config file not found并建议手动创建或运行emcc --generate-config。How to 实战指南以下示例均以 Linux/macOS 为准Windows 上命令相同只需把./emsdk替换为emsdk。如何直接获取最新 SDK 发行版先update拉取当前可用工具的注册表再指定latest安装目标获得最新的 SDK# 获取最新的工具注册表 ./emsdk update # 下载并安装最新 SDK 工具 ./emsdk install latest # 将编译器配置指向 latest SDK ./emsdk activate latest如何安装特定版本把上例中的latest换成目标版本号即可例如./emsdk install 4.0.7 ./emsdk activate 4.0.7可能需要先执行./emsdk update刷新版本列表。每个发行版还有一个asserts 版本它在 LLVM 和 Binaryen 中带有更多运行时检查适合在怀疑这些工具存在 bug 时用于排查。asserts 版本的命名是在发行版名称后加-asserts后缀例如4.0.7-asserts用法相同./emsdk install 4.0.7-asserts ./emsdk activate 4.0.7-asserts如何使用 emsdk 本身运行./emsdk help或直接运行./emsdk即可查看所有可用命令的信息。如何查看已安装的 SDK 与工具版本运行./emsdk list会为每个可安装的工具和 SDK 打印一行信息。已安装的工具会显示INSTALLED字样当前处于激活状态的工具/SDK 旁边会显示星号*。如何安装某个工具/SDK 版本使用install参数下载并安装新工具或 SDK 版本./emsdk install tool/sdk name例如./emsdk install sdk-1.38.21-64bit注意已安装的工具只是存在于本地机器上并不一定就是当前激活环境。要使已安装的 SDK 生效还需要执行activate命令。如何移除某个工具或 SDK使用uninstall参数从本地删除指定工具或 SDK./emsdk uninstall tool/sdk name如需将 Emscripten 从系统中彻底卸载请参考 downloads 页面的卸载指南其中还包含清理环境变量与配置文件的完整步骤。如何检查 Emscripten SDK 是否有更新先用update命令拉取所有新工具和 SDK 版本的包信息再用install tool/sdk name安装新版本# 获取最新的工具注册表 ./emsdk update # 下载并安装指定的新版本 ./emsdk install tool/sdk name如何切换当前激活的 SDK 版本使用activate命令在不同工具和 SDK 版本之间切换。该命令会把.emscripten指向目标工具./emsdk activate tool/sdk name # Linux 和 macOS 上还需设置环境变量 source ./emsdk_env.sh关于环境变量的重要说明在 Linux 和 macOS 上activate只会把必要信息写入配置文件无法自动设置当前终端的环境变量因此必须在activate之后执行source ./emsdk_env.sh。使用source是 Unix shell 的一项安全特性。Windows 上执行activate会自动设置所需的路径与环境变量。如果把./emsdk_env.sh加入默认 shell 配置emsdk 工具包括 emsdk 自带的 node 版本会被加入 PATH这可能影响系统默认的 node 版本需注意。如何安装并激活旧的 Emscripten SDK 与工具emsdk中保存了历史工具与 SDK 的归档记录可用于维护迁移路径。用list --old获取归档版本列表用install name_of_tool安装指定工具# 获取工具的旧版本列表 ./emsdk list --old # 安装所需版本 ./emsdk install name_of_tool # 激活所需版本 ./emsdk activate name_of_tool如何用 SDK 追踪最新变更要体验 emsdk 的最新变更可以安装并激活名为totTip-Of-Tree的特殊版本——它持续构建通常在其提交后几小时内就包含 Emscripten 和 LLVM 的最新改动./emsdk install tot ./emsdk activate tot如果想完全从最新源码自行构建一切可以使用sdk-main-64bit# 安装 git若系统已有可跳过 ./emsdk install git-1.8.3 # 克隆 拉取最新的 emscripten-core/emscripten/main ./emsdk install sdk-main-64bit # 将其设为激活版本 ./emsdk activate sdk-main-64bit如何通过 SDK 使用自己的 Emscripten fork如果你希望修改 Emscripten 工具链本身但又想继续使用 SDK 的环境与工具可以把自己的 Emscripten fork 接入 SDKcd my_emscripten/ # 让 emscripten 使用 emsdk 的配置文件 export EM_CONFIG/path/to/emsdk/.emscripten # 现在你的 emscripten 版本会使用当前激活的 emsdk 中的 LLVM 和 binaryen 二进制 ./emcc核心原理正是前文提到的EM_CONFIG环境变量覆盖机制通过 tools/config.py 中EM_CONFIG的设置emcc会读取你指定的.emscripten配置文件从而复用 emsdk 中已激活的 LLVM/Binaryen 等二进制而把自己的 emscripten checkout 放在 PATH 最前面则保证运行时调用的是你的 fork 版本。小结emsdk 把 Emscripten 工具链的版本管理收敛为寥寥几条命令update刷新清单、list查看状态、install/uninstall管理安装、activate决定默认工具集。配合.emscripten配置文件与EM_CONFIG等环境变量覆盖机制无论是快速上手latest、锁定特定版本含-asserts排查版本、回退旧版、体验tot每日构建还是接入自己的 fork都能在统一的 SDK 环境下完成。更多安装与卸载细节可参考 downloads 快速上手文档命令提示符的使用说明见 Emscripten Command Prompt。【免费下载链接】emscriptenEmscripten: An LLVM-to-WebAssembly Compiler项目地址: https://gitcode.com/gh_mirrors/em/emscripten创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Emscripten SDK（emsdk）完全指南：命令语法、安装配置与多版本维护实战
Emscripten SDKemsdk完全指南命令语法、安装配置与多版本维护实战【免费下载链接】emscriptenEmscripten: An LLVM-to-WebAssembly Compiler项目地址: https://gitcode.com/gh_mirrors/em/emscriptenEmscripten SDK简称emsdk是 Emscripten 官方提供的 SDK 维护工具负责完成工具链的全部下载、安装、卸载与版本切换工作——你只需安装一次 SDK之后所有更新都可以交给 emsdk 完成。本文以 emsdk.rst 为核心系统讲解 emsdk 的命令行语法、SDK 核心概念、.emscripten编译器配置文件并结合仓库源码如 tools/config.py说明配置的底层加载机制最后给出从安装最新版到使用自己的 fork的完整实操指南。emsdk 是什么Emscripten 工具链本身由多种工具组成包括Clang、Emscripten、Java、Git、Node等。emsdk本质上是一个轻量级包管理器负责两件事控制安装哪些工具——从可用的工具/SDK 清单中下载并安装到本地控制激活哪些工具——从已安装的工具集合中选出当前默认使用的一套编译器配置。通过 emsdk你可以下载、安装或移除任意SDK 或 Tool甚至可以在开发中使用 GitHub 上持续构建的 :ref:bleeding edge 版本即tot/sdk-main-64bit目标。所有操作的基本形式为./emsdk command。在 Windows 上使用 emsdk 前需要先启动 Emscripten Command PromptLinux/macOS 直接使用./emsdkWindows 使用emsdk。命令行语法与参数说明emsdk 的命令行语法为./emsdk [help | list [--old] | update | install tool/sdk | uninstall tool/sdk | activate tool/sdk]各命令的作用如下表所示命令说明list [--old]列出当前所有可用的 SDK 与工具及其安装状态加上--old参数时同时显示历史归档版本update获取最新可用工具与 SDK 的注册表信息只更新清单不安装install tool/sdk下载并安装指定的工具或 SDKuninstall tool/sdk从磁盘上删除指定的工具或 SDKactivate tool/sdk将指定工具或 SDK 设为系统环境中的默认工具在 Linux 上还需用source ./emsdk_env.sh启用环境设置见下文如何切换当前激活的 SDK 版本help列出所有支持的命令不指定任何命令时输出同样的列表注意事项Linux 和 macOS 上命令以./emsdk调用Windows 上直接使用emsdk。命令参数tool/sdk就是./emsdk list或./emsdk list --old输出中的某个目标名称。某些工具和 SDK 名称中包含master或main这些目标用于从 Emscripten 的 main/master 分支克隆并拉取最新代码。可以指定latest目标来获取当前最新的 SDK。SDK 核心概念工具Tool与 SDK 目标Tool 与 SDK 的区别Tool单个可安装组件例如node-0.10.17-64bit、git-1.8.3、clang-upstream-main-64bit。可以使用./emsdk install node-0.10.17-64bit单独安装也可以用空格分隔一次性安装多个./emsdk install node-0.10.17-64bit java-7.45-64bit。SDK为某个特定 Emscripten 发行版打包的完整工具集合的便捷目标。例如下面两条命令是等价的./emsdk install sdk-upstream-main-64bit ./emsdk install git-1.8.3 clang-upstream-main-64bit node-0.10.17-64bit python-2.7.5.3-64bit java-7.45-64bit llvm-git-main-64bit emscripten-main-64bit可见 SDK 目标是对一组工具目标的聚合别名省去了逐个安装的繁琐操作。激活状态与存储位置安装好的 SDK或 Tool可以被设为active激活状态表示运行 Emscripten 时默认使用这套工具。激活的编译器配置存储在 emsdk 目录下的配置文件.emscripten中。不同工具和 SDK 在首次安装时指定的根目录下按工具名 版本分组存放在各自独立的子目录中便于版本隔离与切换。Emscripten 编译器配置文件.emscripten文件的作用编译器配置文件代表emsdk保存当前active配置它定义了在 Emscripten Command Prompt 中调用 Emscripten 时默认使用的具体工具集合。文件名固定为.emscripten它是 emsdk 专属的不会与系统中其他地方可能存在的配置文件冲突。除非你正在 从源码构建 Emscripten否则一般不应直接修改该文件正确做法是使用emsdk activate tool/SDK来激活特定 SDK 或工具让 emsdk 代为写入配置。配置示例Windows SDK 生成的.emscripten文件示例# .emscripten file from Windows SDK import os LLVM_ROOTC:/Program Files/Emscripten/clang/e1.21.0_64bit NODE_JSC:/Program Files/Emscripten/node/0.10.17_64bit/node.exeLinux SDK 生成的.emscripten文件示例# .emscripten file from Linux SDK import os NODE_JS node LLVM_ROOT/home/ubuntu/emsdk/upstream/bin注意示例中的变量名LLVM_ROOT指向 Clang/LLVM 工具链目录NODE_JS指向 Node.js 解释器。从 tools/config.py 的源码看编译器实际支持的配置键还包括BINARYEN_ROOTBinaryen 工具根目录、LLVM_ADD_VERSION、CLANG_ADD_VERSION、CLOSURE_COMPILERClosure Compiler 路径、FROZEN_CACHE、CACHE缓存目录、PORTS端口库目录与COMPILER_WRAPPER。配置文件的底层加载机制从源码层面看emcc启动时会通过 tools/config.py 中的parse_config_file()用 Python 的exec解析.emscripten文件。值得注意的实现细节环境变量覆盖任何CONFIG_KEYS中的键都可以通过EM_KEY形式的环境变量覆盖配置文件中的值例如EM_LLVM_ROOT、EM_CACHE、EM_BINARYEN_ROOT等且这些路径类环境变量必须是绝对路径否则会报错退出。CFGDIR 展开解析前会在环境中设置CFGDIR指向配置文件所在目录支持类似 LLVM 配置文件中的路径展开语法。自动探测兜底如果配置文件缺失或未设置某键read_config()会尝试在 PATH 中查找clang、node、wasm-opt来推断LLVM_ROOT、NODE_JS、BINARYEN_ROOT见 tools/config.py若仍找不到则提示config file not found并建议手动创建或运行emcc --generate-config。How to 实战指南以下示例均以 Linux/macOS 为准Windows 上命令相同只需把./emsdk替换为emsdk。如何直接获取最新 SDK 发行版先update拉取当前可用工具的注册表再指定latest安装目标获得最新的 SDK# 获取最新的工具注册表 ./emsdk update # 下载并安装最新 SDK 工具 ./emsdk install latest # 将编译器配置指向 latest SDK ./emsdk activate latest如何安装特定版本把上例中的latest换成目标版本号即可例如./emsdk install 4.0.7 ./emsdk activate 4.0.7可能需要先执行./emsdk update刷新版本列表。每个发行版还有一个asserts 版本它在 LLVM 和 Binaryen 中带有更多运行时检查适合在怀疑这些工具存在 bug 时用于排查。asserts 版本的命名是在发行版名称后加-asserts后缀例如4.0.7-asserts用法相同./emsdk install 4.0.7-asserts ./emsdk activate 4.0.7-asserts如何使用 emsdk 本身运行./emsdk help或直接运行./emsdk即可查看所有可用命令的信息。如何查看已安装的 SDK 与工具版本运行./emsdk list会为每个可安装的工具和 SDK 打印一行信息。已安装的工具会显示INSTALLED字样当前处于激活状态的工具/SDK 旁边会显示星号*。如何安装某个工具/SDK 版本使用install参数下载并安装新工具或 SDK 版本./emsdk install tool/sdk name例如./emsdk install sdk-1.38.21-64bit注意已安装的工具只是存在于本地机器上并不一定就是当前激活环境。要使已安装的 SDK 生效还需要执行activate命令。如何移除某个工具或 SDK使用uninstall参数从本地删除指定工具或 SDK./emsdk uninstall tool/sdk name如需将 Emscripten 从系统中彻底卸载请参考 downloads 页面的卸载指南其中还包含清理环境变量与配置文件的完整步骤。如何检查 Emscripten SDK 是否有更新先用update命令拉取所有新工具和 SDK 版本的包信息再用install tool/sdk name安装新版本# 获取最新的工具注册表 ./emsdk update # 下载并安装指定的新版本 ./emsdk install tool/sdk name如何切换当前激活的 SDK 版本使用activate命令在不同工具和 SDK 版本之间切换。该命令会把.emscripten指向目标工具./emsdk activate tool/sdk name # Linux 和 macOS 上还需设置环境变量 source ./emsdk_env.sh关于环境变量的重要说明在 Linux 和 macOS 上activate只会把必要信息写入配置文件无法自动设置当前终端的环境变量因此必须在activate之后执行source ./emsdk_env.sh。使用source是 Unix shell 的一项安全特性。Windows 上执行activate会自动设置所需的路径与环境变量。如果把./emsdk_env.sh加入默认 shell 配置emsdk 工具包括 emsdk 自带的 node 版本会被加入 PATH这可能影响系统默认的 node 版本需注意。如何安装并激活旧的 Emscripten SDK 与工具emsdk中保存了历史工具与 SDK 的归档记录可用于维护迁移路径。用list --old获取归档版本列表用install name_of_tool安装指定工具# 获取工具的旧版本列表 ./emsdk list --old # 安装所需版本 ./emsdk install name_of_tool # 激活所需版本 ./emsdk activate name_of_tool如何用 SDK 追踪最新变更要体验 emsdk 的最新变更可以安装并激活名为totTip-Of-Tree的特殊版本——它持续构建通常在其提交后几小时内就包含 Emscripten 和 LLVM 的最新改动./emsdk install tot ./emsdk activate tot如果想完全从最新源码自行构建一切可以使用sdk-main-64bit# 安装 git若系统已有可跳过 ./emsdk install git-1.8.3 # 克隆 拉取最新的 emscripten-core/emscripten/main ./emsdk install sdk-main-64bit # 将其设为激活版本 ./emsdk activate sdk-main-64bit如何通过 SDK 使用自己的 Emscripten fork如果你希望修改 Emscripten 工具链本身但又想继续使用 SDK 的环境与工具可以把自己的 Emscripten fork 接入 SDKcd my_emscripten/ # 让 emscripten 使用 emsdk 的配置文件 export EM_CONFIG/path/to/emsdk/.emscripten # 现在你的 emscripten 版本会使用当前激活的 emsdk 中的 LLVM 和 binaryen 二进制 ./emcc核心原理正是前文提到的EM_CONFIG环境变量覆盖机制通过 tools/config.py 中EM_CONFIG的设置emcc会读取你指定的.emscripten配置文件从而复用 emsdk 中已激活的 LLVM/Binaryen 等二进制而把自己的 emscripten checkout 放在 PATH 最前面则保证运行时调用的是你的 fork 版本。小结emsdk 把 Emscripten 工具链的版本管理收敛为寥寥几条命令update刷新清单、list查看状态、install/uninstall管理安装、activate决定默认工具集。配合.emscripten配置文件与EM_CONFIG等环境变量覆盖机制无论是快速上手latest、锁定特定版本含-asserts排查版本、回退旧版、体验tot每日构建还是接入自己的 fork都能在统一的 SDK 环境下完成。更多安装与卸载细节可参考 downloads 快速上手文档命令提示符的使用说明见 Emscripten Command Prompt。【免费下载链接】emscriptenEmscripten: An LLVM-to-WebAssembly Compiler项目地址: https://gitcode.com/gh_mirrors/em/emscripten创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考