Xmake构建Windows动态库时缺失导入库(.lib)文件的问题解析

问题现象

在使用xmake 2.9.6构建Windows平台动态库时，开发者发现构建系统只生成了.dll文件，而没有生成对应的导入库(.lib)文件。当其他可执行程序尝试链接这个动态库时，链接器会报错找不到shared.lib文件。

技术背景

在Windows平台上，动态链接库(DLL)的构建会生成两个重要文件：

1. .dll文件 - 包含实际的二进制代码
2. .lib文件 - 导入库，包含DLL中导出符号的信息

当其他程序要使用这个DLL时，链接阶段需要.lib文件来解析外部符号引用，而运行时才需要加载.dll文件。

问题根源

经过分析，这个问题并非xmake构建系统的缺陷，而是开发者代码中没有正确定义导出符号。在Windows平台上，必须显式声明哪些函数/类需要从DLL中导出，通常有两种方式：

1. 使用__declspec(dllexport)修饰符
2. 使用模块定义文件(.def)

在示例代码中，shared.cpp中的foo函数没有使用任何导出声明，因此编译器不会生成包含导出符号信息的.lib文件。

解决方案

方法一：使用__declspec(dllexport)

修改头文件shared.hpp：

#pragma once

#ifdef SHARED_EXPORTS
#define API __declspec(dllexport)
#else 
#define API __declspec(dllimport)
#endif

namespace foo {
  API void foo();
}

然后在xmake.lua中为shared目标添加定义：

target("shared")
    set_kind("shared")
    add_files("shared.cpp")
    add_defines("SHARED_EXPORTS")

方法二：使用模块定义文件

1. 创建shared.def文件：

EXPORTS
    ?foo@@YAXXZ

2. 修改xmake.lua：

target("shared")
    set_kind("shared")
    add_files("shared.cpp", "shared.def")

构建系统行为说明

xmake在构建Windows动态库时，会正确调用MSVC工具链生成.dll和.lib文件。但前提是代码中有实际需要导出的符号。如果没有导出任何符号，MSVC编译器(cl.exe)不会生成.lib文件，这是预期的行为。

最佳实践建议

1. 对于跨平台项目，建议使用宏来统一处理不同平台的导出声明
2. 在xmake配置中，可以为Windows平台单独设置导出定义
3. 使用xmake f -c清除缓存后重新构建，确保修改生效

总结

这个问题揭示了Windows平台动态库开发的一个重要特性：必须显式声明导出符号。xmake作为构建工具，忠实地执行了编译器的行为。开发者需要理解平台特性，正确定义导出接口，才能生成完整的动态库文件集合。