在Qt项目中使用spdlog共享库的注意事项

spdlog是一个高性能的C++日志库，支持多种使用方式，包括头文件方式和编译为库的方式。本文将重点介绍在Qt项目中使用spdlog共享库时需要注意的关键配置。

spdlog的两种使用模式

spdlog提供了两种主要的使用方式：

1. 头文件方式：直接包含头文件即可使用，所有实现都在头文件中
2. 编译为库方式：将spdlog编译为静态库或动态库后链接使用

在Windows平台上使用Qt开发时，如果需要将spdlog编译为动态链接库(DLL)使用，需要特别注意一些配置细节。

正确编译spdlog为共享库

要正确编译spdlog为共享库，需要使用以下CMake命令：

cmake -H. -B_builds -G "MinGW Makefiles" \
      -DSPDLOG_BUILD_EXAMPLES=OFF \
      -DCMAKE_BUILD_TYPE=Release \
      -DSPDLOG_BUILD_SHARED=ON \
      -DSPDLOG_BUILD_PIC=TRUE
cmake --build _builds --config Release

关键参数说明：

• SPDLOG_BUILD_SHARED=ON：指示构建共享库
• SPDLOG_BUILD_PIC=TRUE：启用位置无关代码，这对共享库是必需的

Qt项目中的配置要点

在Qt项目(.pro文件)中引入spdlog共享库时，必须同时定义以下两个宏：

DEFINES += SPDLOG_COMPILED_LIB SPDLOG_SHARED_LIB

这两个宏的作用：

• SPDLOG_COMPILED_LIB：告诉spdlog使用编译后的库实现
• SPDLOG_SHARED_LIB：指示使用动态链接库版本

如果只定义SPDLOG_COMPILED_LIB而没有定义SPDLOG_SHARED_LIB，spdlog可能会回退到头文件方式实现，导致虽然链接了库但实际上并未使用。

库文件路径配置

在Qt项目中正确配置库文件路径：

win32:CONFIG(release, debug|release): LIBS += -L$$PWD/../../third/Spdlog/libs/ -lspdlog
else:win32:CONFIG(debug, debug|release): LIBS += -L$$PWD/../../third/Spdlog/libs/ -lspdlogd
else:unix: LIBS += -L$$PWD/../../third/Spdlog/libs/ -lspdlog

INCLUDEPATH += $$PWD/../../third/Spdlog/include
DEPENDPATH += $$PWD/../../third/Spdlog/include

注意Windows平台下Debug和Release版本使用不同的库文件名(spdlogd vs spdlog)。

运行时依赖

当使用spdlog共享库时，在Windows平台上需要确保：

1. 生成的DLL文件(spdlog.dll)位于可执行文件所在目录
2. 或者DLL位于系统PATH环境变量包含的目录中

如果没有正确配置运行时依赖，程序可能会因为找不到DLL而无法启动。

总结

在Qt项目中使用spdlog共享库时，关键在于：

1. 正确编译spdlog为共享库
2. 在项目中同时定义SPDLOG_COMPILED_LIB和SPDLOG_SHARED_LIB宏
3. 确保运行时能够找到所需的DLL文件

遵循这些要点可以确保spdlog以共享库方式正常工作，避免意外回退到头文件方式实现的情况。