在 Windows 11 中使用自定义 MinGW 工具链构建和链接 .dll 的常见问题解答

2024-03-02 10:32:24

在 Windows 11 中使用自定义 MinGW 工具链构建和链接 .dll

前言

本文档将指导您如何在 Windows 11 上使用自定义 MinGW 工具链构建和链接动态链接库（.dll）。我们还将解决您在构建可执行文件时可能遇到的错误，例如找不到 -lmath_d_shared 库。

问题

在使用 Bazel 构建 .dll 并将其链接到可执行文件时，可能会出现以下错误：

C:/msys64/ucrt64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: cannot find -lmath_d_shared: No such file or directory

解决方法

方法 1：修改工具链

修改工具链的 artifact_name_patterns 字段，添加以下内容：

artifact_name_pattern(
    category_name = "dynamic_library",
    prefix = "lib",
    extension = ".dll",
)

这样做会强制 Bazel 为所有动态库生成 .dll 扩展名。

方法 2：重命名 .so 为 .dll

创建一个 Bazel 规则（dll_library.bzl）来重命名库文件：

def dll_library(
        name,
        srcs = [],
        deps = [],
        hdrs = [],
        visibility = None,
        **kwargs):               
    static_library_name = name + "_static"
    dll_lib_name = name + "_shared"
    
    cc_library(
        name = static_library_name,
        srcs = srcs,
        hdrs = hdrs,
        deps = deps,        
        **kwargs
    )
    
    cc_shared_library(
        name = dll_lib_name,                        
        deps = [":" + static_library_name] 
    )
    
    native.genrule(
        name = name + "_rename_so_to_dll",
        srcs = [dll_lib_name + ".so"],
        outs = [dll_lib_name + ".dll"],
        cmd = "mv $(SRCS) $(OUTS)"
    )

在 BUILD 文件中使用此规则：

load("//main:dll_library.bzl", "dll_library")

...

dll_library(
    name = "math_d.dll",
    srcs = ["math_dll_interface.cpp"],
    hdrs = DLL_HDRS,
    deps = [":math"],
    defines = ["MATH_DLL"]
)

...

cc_binary(
    name = "sum_numbers_mingw",
    srcs = ["main.cpp"] + DLL_HDRS, 
    dynamic_deps = [":math_d.dll"]                   
)