如何使Bazel的genrule依赖外部http_archive资源？

我之前在跨平台用Bazel拆分GUI和共享库模块的时候，也遇到过genrule没法直接依赖http_archive的问题——毕竟genrule确实没有deps属性。不过不用合并模块，有几个靠谱的方案能解决：

方案1：用filegroup中转依赖 #

genrule虽然没有deps，但它的srcs属性可以接收文件或文件组，我们可以把http_archive的外部库包装成filegroup，让genrule通过srcs间接依赖，这样Bazel就会自动触发外部库的下载流程。

步骤示例： #

1. 先在WORKSPACE里定义你的http_archive：

http_archive(
    name = "external_gui_lib",
    urls = ["https://example.com/gui_platform_lib.zip"],
    sha256 = "你的文件哈希值",
    build_file = "@//gui_module:BUILD.external_gui_lib", # 若需自定义外部库的BUILD规则可添加
)

2. 在GUI模块的BUILD文件里创建filegroup，把外部库的目标包含进去：

filegroup(
    name = "gui_external_deps",
    srcs = [
        "@external_gui_lib//:core_lib",
        "@external_gui_lib//:platform_support_files",
        # 把所有需要的外部库文件/目标都列在这里
    ],
    visibility = ["//visibility:public"], # 确保genrule能访问到这个filegroup
)

3. 最后在genrule里引用这个filegroup作为srcs：

genrule(
    name = "build_platform_gui",
    srcs = [":gui_external_deps", ":gui_source_files"],
    outs = select({
        "@bazel_tools//src/conditions:windows": ["MyApp.exe"],
        "@bazel_tools//src/conditions:darwin": ["MyApp.app"],
    }),
    cmd = select({
        "@bazel_tools//src/conditions:windows": "msbuild ./gui_project.sln /p:LibDir=$(location @external_gui_lib//:core_lib) /out:$(OUTS)",
        "@bazel_tools//src/conditions:darwin": "xcodebuild -project ./gui_project.xcodeproj -target MyApp -library $(location @external_gui_lib//:core_lib) -o $(OUTS)",
    }),
)

这样Bazel在执行genrule之前，会先处理filegroup的依赖，自动完成http_archive的下载。

方案2：自定义Starlark规则（更灵活） #

如果你的GUI构建逻辑比较复杂，或者需要更像普通规则那样使用deps属性，可以自己写一个简单的自定义规则——自定义规则原生支持deps，能直接依赖http_archive的目标。

步骤示例： #

1. 在GUI模块里创建一个gui_build_rules.bzl文件，定义自定义规则：

def _platform_gui_build_impl(ctx):
    # 收集所有构建需要的输入文件
    all_inputs = ctx.files.srcs + ctx.files.deps
    # 根据平台生成对应的构建命令
    build_cmd = ""
    if ctx.target_platform_has_constraint("@bazel_tools//platforms:windows"):
        build_cmd = "msbuild ./gui_project.sln /p:LibPath=$(location @external_gui_lib//:win_lib) /out:$(OUTS)"
    else:
        build_cmd = "xcodebuild -project ./gui_project.xcodeproj -target MyApp -library $(location @external_gui_lib//:mac_lib) -o $(OUTS)"
    
    # 执行构建命令
    ctx.actions.run_shell(
        command = build_cmd,
        inputs = all_inputs,
        outputs = ctx.outputs.outs,
    )

platform_gui_build = rule(
    implementation = _platform_gui_build_impl,
    attrs = {
        "srcs": attr.label_list(allow_files = True, mandatory = True),
        "deps": attr.label_list(allow_files = True), # 这里支持deps属性
        "outs": attr.output_list(mandatory = True),
    },
    # 指定规则支持的平台
    compatible_with = [
        "@bazel_tools//platforms:windows",
        "@bazel_tools//platforms:darwin",
    ],
)

2. 在GUI模块的BUILD文件里加载并使用这个规则：

load(":gui_build_rules.bzl", "platform_gui_build")

platform_gui_build(
    name = "build_gui",
    srcs = [":gui_source_files"],
    deps = ["@external_gui_lib//:core_lib"], # 直接依赖http_archive的目标
    outs = select({
        "@bazel_tools//src/conditions:windows": ["MyApp.exe"],
        "@bazel_tools//src/conditions:darwin": ["MyApp.app"],
    }),
)

自定义规则的deps会触发Bazel自动处理http_archive的下载，完美绕过genrule的限制。

额外注意点 #

• 跨平台差异可以用select或者平台约束来处理，确保不同系统下的构建命令和依赖路径正确。
• 如果http_archive的外部库需要特定的BUILD规则来暴露目标，记得在http_archive里指定build_file或build_file_content。

内容的提问来源于stack exchange，提问作者Clearer