在Bazel中使用Emscripten工具链构建WASM项目

概述

本文介绍如何在Bazel构建系统中正确配置和使用Emscripten工具链来构建WebAssembly(WASM)项目。我们将探讨常见的配置问题及其解决方案，特别是关于工具链提供者(TemplateVariableInfo)缺失的问题。

工具链配置要点

在Bazel中使用Emscripten工具链时，需要注意以下几个关键配置：

1. 平台指定：必须通过--platforms=@emsdk//:platform_wasm参数明确指定目标平台为WASM。这个参数可以放在命令行中，也可以放在项目的.bazelrc配置文件中。

2. 工具链选择：当使用genrule规则时，Bazel期望工具链提供TemplateVariableInfo。对于Emscripten工具链，推荐使用@bazel_tools//tools/cpp:current_cc_toolchain作为工具链引用。

3. 全局配置：如果整个项目都针对Emscripten/WASM平台，建议将平台配置放在.bazelrc文件中，这样可以避免每次构建都需要指定平台参数。

实际应用示例

以构建libffi库为例，正确的Bazel配置应包括：

1. 在WORKSPACE文件中定义外部依赖：

http_archive(
    name = "libffi_src",
    # 省略具体配置...
)

2. 在BUILD文件中定义构建规则时，可以省略显式的工具链指定（当已配置全局平台时）：

genrule(
    name = "libffi",
    srcs = ["@libffi_src//:all"],
    cmd = "cd external/libffi_src && ./testsuite/emscripten/build.sh --wasm-bigint",
    outs = ["libffi.a"]
)

常见问题解决

当遇到"does not have mandatory providers: TemplateVariableInfo"错误时，可以采取以下解决方案：

1. 确保已正确设置平台参数：--platforms=@emsdk//:platform_wasm

2. 如果必须显式指定工具链，使用：@bazel_tools//tools/cpp:current_cc_toolchain

3. 检查工具链的完整性，确保Emscripten SDK已正确安装和配置

最佳实践建议

1. 对于纯WASM项目，建议在.bazelrc中设置默认平台，简化构建命令

2. 复杂的构建过程（如autotools/cmake项目）可能需要更细致的工具链配置

3. 考虑使用专门的规则（如wasm_cc_binary）而非通用genrule，以获得更好的工具链集成

通过正确配置平台和工具链，开发者可以在Bazel中充分利用Emscripten工具链构建高效的WASM应用。