c++ - 链接静态库时Cmake链接路径错误

Question

我有一个 cmake 项目，其中包含我自己的静态库和可执行文件。简化后的项目结构为:

顶级cmake:

cmake_minimum_required(VERSION 3.16)

project(mainproject 
    VERSION 0.0.1 
    DESCRIPTION ""
    LANGUAGES CXX
)

list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_LIST_DIR}/cmake")

#include libs
include(LibsPath)

add_subdirectory(teststaticlib)
add_subdirectory(testexe)

cmake/LibsPath.cmake:

        set(CMAKE_PREFIX_PATH
            "C:/tesseract41_x64-static/leptonica_x64-windows-static"
            "C:/tesseract41_x64-static/tiff_x64-windows-static"
            "C:/tesseract41_x64-static/tesseract_x64-windows-static"
            "C:/tesseract41_x64-static/libpng_x64-windows-static"
            "C:/tesseract41_x64-static/libjpeg-turbo_x64-windows-static"
            "C:/tesseract41_x64-static/giflib_x64-windows-static"
            "C:/tesseract41_x64-static/libwebp_x64-windows-static"
            "C:/opencv4_x64-windows-static"
            "C:/protobuf_x64-windows-static"
            "C:/hdf5_x64-windows-static"
            "C:/szip_x64-windows-static"
    )

基本上是项目直接依赖项的路径 - tesseract 和 opencv 及其依赖项。

静态库的Cmake文件(teststaticlib/CMakeLists.txt):

cmake_minimum_required(VERSION 3.16)

project(teststaticlib)

set(CMAKE_GENERATOR "Ninja")
set_property(GLOBAL PROPERTY USE_FOLDERS ON)
list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_LIST_DIR}/cmake")

#enable unicode
add_definitions(-DUNICODE -D_UNICODE)

set(SOURCE_FILES
    #...source files
)
set(PRIVATE_HEADER_FILES 
    #... header files
)
set(PUBLIC_HEADER_FILES
    #... header files
)
add_library(teststaticlib STATIC ${SOURCE_FILES} ${PRIVATE_HEADER_FILES} ${PUBLIC_HEADER_FILES})
add_library(teststaticlib::teststaticlib ALIAS teststaticlib)
set_target_properties(teststaticlib PROPERTIES OUTPUT_NAME teststaticlib)
target_include_directories(teststaticlib 
    PRIVATE 
        ${CMAKE_CURRENT_SOURCE_DIR}/src
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}/include
)

#precompiled headers
target_precompile_headers(teststaticlib PRIVATE src/pch.h)

#link libs
find_package(tesseract CONFIG REQUIRED)
find_package(opencv CONFIG REQUIRED core imgproc highgui)

include_directories(${Tesseract_INCLUDE_DIRS})
include_directories(${OpenCV_INCLUDE_DIRS})
target_link_libraries(teststaticlib 
    PRIVATE 
        ${Tesseract_LIBRARIES}
        ${OpenCV_LIBS}
)

到目前为止，一切都运行良好。 teststaticlib.lib 构建正常，没有任何错误。 但是，一旦我将任何可执行文件添加到项目并将 teststaticlib 链接到它:

testexe/CMakeLists.txt

cmake_minimum_required(VERSION 3.16)

project(testexe)

set(SOURCE_FILES
    main.cpp
)
add_executable(testexe ${SOURCE_FILES})

target_link_libraries(testexe 
    PRIVATE 
        teststaticlib::teststaticlib
)

构建时出现此错误:

ninja: error: 'C:/tesseract41_x64-static/leptonica_x64-windows-static/debug/lib/gif.lib', needed by 'debug/mainproject/testexe.exe', missing and no known rule to make it

为什么会出现此错误以及如何修复它？ 为什么 cmake 在 leptonica 文件夹内寻找我的直接依赖项的子依赖项(在本例中 gif 是 tesseract 或 leptonica 的依赖项)当它们的路径不同时，正如您从 LibsPath.cmake 中看到的那样？ 我知道这不是 tess 或 leptonica 特定的问题，因为如果我将这些库更改为任何其他库，模式仍然存在，并且我仍然会遇到相同的错误，但对于其他库。 所以我的cmake文件肯定有问题，但我不知道错误在哪里。

编辑: 尝试更改我的库链接到 PUBLIC 并向 exe 添加相同的依赖项。即使尝试将子依赖项 gif 链接到 exe - 仍然会遇到相同的错误。

teststaticlib/CMakeLists.txt:

target_link_libraries(teststaticlib 
PUBLIC 
    ${Tesseract_LIBRARIES}
    ${OpenCV_LIBS}
)

testexe/CMakeLists.txt

    cmake_minimum_required(VERSION 3.16) 
project(testexe)

set(SOURCE_FILES
    main.cpp
)
add_executable(testexe ${SOURCE_FILES})

    find_package(tesseract CONFIG REQUIRED)
    find_package(opencv CONFIG REQUIRED core imgproc highgui)
    find_package(gif REQUIRED)
    include_directories(${Tesseract_INCLUDE_DIRS})
    include_directories(${OpenCV_INCLUDE_DIRS})
    include_directories(${GIF_INCLUDE_DIRS})

target_link_libraries(testexe 
    PRIVATE 
        ${GIF_LIBRARIES}
        ${Tesseract_LIBRARIES}
        ${OpenCV_LIBS}
        basicemul::basicemul
)

Answer 1

以下内容可能会有所帮助，引用自“mastering cmake by kitware”:

CMAKE_PREFIX_PATH: This specifies a path that will be used by the FIND_XXX() commands. It contains the "base" directories for the FIND_XXX() commands to append appropriate sub-directories to. FIND_PROGRAM() adds /bin to each of the directories in the path; FIND_LIBRARY() appends /lib to each of the directories in the path

因此，我通常只是制作某种库导入脚本，并使用 PATHS/HINTS 来 find_library() 命令指向正确的目录。 据我所知，导入库目标的最可靠方法是不按原样使用 find_library() ，而是使用 cmake INSTALL() 命令从该库生成导入脚本(如果可用)。 请参阅 find_library() docs .

链接静态库也有点奇怪。它们被编译，但在生成最终的二进制文件之前，实际上没有任何东西链接到它们。私有(private)库意味着链接的符号被密封在静态库内，并且依赖关系不会进一步延续。然后，PUBLIC 只需将库添加到 LINK_INTERFACE_LIBRARIES/LINK_LIBRARIES 目标属性中，并且依赖项将继续下去，直到生成最终的二进制文件。 (共享库或可执行文件)

请注意，我有 *nix 背景，如果在 Windows 上构建，我可能会得到一些细节错误。