从源代码手动构建时配置 Emscripten 设置

Emscripten 可以通过 编译器配置文件 (.emscripten) 配置。这些设置包括工具(LLVM、Clang、Binaryen 等)的路径以及编译器用于中间构建文件的临时目录。

此配置文件是可选的。默认情况下,emscripten 将在 PATH 中搜索它所需的工具。

本文介绍了在从源代码 手动 构建 Emscripten 时如何创建和更新该文件。

创建编译器配置文件

运行 emcc(或任何其他 Emscripten 工具)时可以使用设置文件。您可以使用 --generate-config 运行 emcc 以在默认位置生成一个文件。

  1. 导航到您克隆 Emscripten 存储库的目录。

  2. 输入命令

./emcc --generate-config

您应该会收到一个 An Emscripten settings file has been generated at: 消息,以及配置文件的内容。

生成此文件时,Emscripten 将根据当前的 PATH 对工具的正确位置进行“最佳猜测”。

在大多数情况下,您需要编辑生成的文件并修改至少 LLVM_ROOTBINARYEN_ROOT 设置以指向您本地 LLVM 和 Binaryen 安装的正确位置。

定位编译器配置文件 (.emscripten)

设置文件 (.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

  1. 编辑变量 LLVM_ROOT 以指向您构建 LLVM 二进制文件的目录,例如

    LLVM_ROOT = '/home/ubuntu/a-path/llvm/build/bin'
    

    注意

    使用正斜杠!

设置好这些路径后,再次运行 emcc。它应该再次执行完整性检查以测试指定的路径。在 验证 Emscripten 开发环境 中提供了更多验证测试。