cmake 链接错误

我试图理解为什么在编译使用 CMake 生成的项目时出现链接错误。

CMakeFiles.txt 为项目的每个文件夹构建一个静态库，然后通过以下方式将所有它们链接在一起：

# root CMakeLists.txt

add_subdirectory(subfolder1)
add_subdirectory(subfolder2)
add_subdirectory(...)

add_executable(target ${SOURCES})

set(LIBRARIES
  LIB_FOO
  LIB_BAR
  ...
)

target_link_libraries(target
  ${LIBRARIES}
)

然后在每个子文件夹中我都有一个简单的 CMakeLists.txt ，例如

file(GLOB FOO_SOURCE *.cpp)
add_library(LIB_FOO ${FOO_SOURCE})

现在，这可以正常工作并编译所有内容，但在链接时我得到了未定义的引用，因此我尝试调查最后所有内容是否可用，看起来像这样。实际错误如下：

libLIB_WORLD.a(World.cpp.o): In function `World::generate(WorldGenOptions)':
World.cpp:(.text+0x803): undefined reference to `MapGenerator::MapGenerator(BlockMap*)'
World.cpp:(.text+0x837): undefined reference to `MapGenerator::generate(bool, WorldGenOptions)'

现在，MapGenerator.cpp 是LIB_MAP，所以我检查文件是否存在并包含符号：

:~$ nm libLIB_MAP.a | grep generate
....
00000000000044dc T _ZN12MapGenerator8generateEb15WorldGenOptions

:~$ nm CMakeFiles/LIB_MAP.dir/MapGenerator.cpp.o | grep generate
....
00000000000044dc T _ZN12MapGenerator8generateEb15WorldGenOptions

所以这个符号是存在的，此时我检查了它是否被 ld 正确链接：

:~$ make VERBOSE=1
/usr/bin/g++  ... libLIB_MAP.a libLIB_WORLD.a ...

因此，它实际上与其他无法找到该符号的库一起存在于链接阶段。

我缺少什么微不足道的东西吗？我对 CMake 很陌生，所以我没有想法。

这是 CMake 中未正确建模的库依赖关系问题。

Your LIB_WORLD参考方法来自LIB_MAP。此依赖项未在您的 CMake 脚本中建模。由于这两个都是静态库，因此它们仍然可以自行构建良好。 （请记住，静态库本质上是一堆打包在一起的目标文件，但它们从不通过链接器。）

但是，一旦将它们链接到可执行文件或共享库，您就会遇到问题。即使您的可执行文件链接到两者LIB_WORLD and LIB_MAP，它这样做以错误的顺序。因此，当链接器尝试解决缺少的符号时LIB_WORLD，它还不知道导出的符号LIB_MAP，因此您遇到了错误消息。

正确的解决方法是引入对LIB_WORLD:

add_library(LIB_WORLD [...])
target_link_libraries(LIB_WORLD LIB_MAP)

现在，每当您链接某些内容时LIB_WORLD你也总是会链接到LIB_MAP and CMake 会注意顺序是否正确。 （特别是，如果您的可执行文件不直接使用来自LIB_MAP您可能想将其从其中删除target_link_libraries共。）

作为一个额外的好处，它现在允许您构建LIB_WORLD作为共享库，以前会因链接器错误而失败。