Emscripten 可以通过 编译器配置文件 (.emscripten) 配置。这些设置包括工具(LLVM、Clang、Binaryen 等)的路径以及编译器用于中间构建文件的临时目录。
此配置文件是可选的。默认情况下,emscripten 将在 PATH
中搜索它所需的工具。
本文介绍了在从源代码 手动 构建 Emscripten 时如何创建和更新该文件。
运行 emcc(或任何其他 Emscripten 工具)时可以使用设置文件。您可以使用 --generate-config
运行 emcc
以在默认位置生成一个文件。
导航到您克隆 Emscripten 存储库的目录。
输入命令
./emcc --generate-config您应该会收到一个
An Emscripten settings file has been generated at:
消息,以及配置文件的内容。
生成此文件时,Emscripten 将根据当前的 PATH
对工具的正确位置进行“最佳猜测”。
在大多数情况下,您需要编辑生成的文件并修改至少 LLVM_ROOT
和 BINARYEN_ROOT
设置以指向您本地 LLVM 和 Binaryen 安装的正确位置。
设置文件 (.emscripten
) 默认情况下是在 emscripten 目录(与 emcc
本身并列)中创建的。在 emscripten 目录为只读的情况下,将使用用户的 home 目录
在 Linux 和 macOS 上,此文件名为 ~/.emscripten,其中 ~ 是用户的 home 目录。
注意
以“.”为前缀的文件默认情况下是隐藏的。您可能需要更改查看设置才能找到该文件。
在 Windows 上,该文件可以在以下路径中找到:C:/Users/yourusername_000/.emscripten。
注意
尽管语法相同,但 emcc 创建的默认 .emscripten 文件的外观与 emsdk 创建的文件截然不同。这是因为 emsdk 管理多个目标环境,并且在激活新环境时,它尽可能地对这些工具的位置进行硬编码。相比之下,默认文件由用户管理,并且旨在使该任务尽可能地轻松。
该文件只是将值分配给许多表示 Emscripten 使用的主要工具的变量。例如,如果您的 binaryen 安装在 C:\tools\binaryen\ 中,则该文件可能包含以下行
BINARYEN_ROOT = 'C:\\tools\\binaryen\\'
您可以从默认的 .emscripten 文件或 此处示例 中找出其他变量名称。
可以使用您选择的文本编辑器编辑编译器配置文件。如果您是从源代码手动构建,则最有可能需要更新变量 LLVM_ROOT
编辑变量 LLVM_ROOT
以指向您构建 LLVM 二进制文件的目录,例如
LLVM_ROOT = '/home/ubuntu/a-path/llvm/build/bin'注意
使用正斜杠!
设置好这些路径后,再次运行 emcc
。它应该再次执行完整性检查以测试指定的路径。在 验证 Emscripten 开发环境 中提供了更多验证测试。