cmake find_package，find_library可以定位glfw，但是TARGET glfw为假答案

【问题标题】：cmake find_package, find_library can locate glfw, but TARGET glfw is falsecmake find_package，find_library可以定位glfw，但是TARGET glfw为假
【发布时间】：2021-07-26 05:35:39
【问题描述】：

我的 glfw3 是从源代码构建的，并且使用 FindGLFW.cmake 来查找库：

find_path(
  GLFW_INCLUDE_DIR
  NAMES
  GLFW
  PATHS
  include)

find_library(
  GLFW_LIBRARY
  NAMES
  glfw glfw3 glfw3dll
  PATHS
  lib)

include(FindPackageHandleStandardArgs)

find_package_handle_standard_args(GLFW REQUIRED_VARS GLFW_LIBRARY GLFW_INCLUDE_DIR)

我可以在其他项目中使用find_package(GLFW REQUIRED) 和target_link_libraries(xxx glfw3) 而不会出现构建错误。但是，if(TARGET glfw) 或 if(TARGET glfw3) 中的语句总是给我错误的结果。可能是什么原因？

例子：

find_package(GLFW REQUIRED)
MESSAGE(STATUS "GLFW: ${GLFW_FOUND}")
if(TARGET glfw)
    MESSAGE(STATUS "Found it")
else()
    MESSAGE(STATUS "Not Found")
endif()
target_link_libraries(xxx glfw3)

这给了我GLFW: TRUE 和Not Found 的输出，但没有构建错误。

【问题讨论】：

您正在使用，而不是构建 glfw。即它不是你的“目标”。 xxx 是你的目标。
@wcochran 对，我正在构建使用 glfw 的 xxx。也许我在原始问题中不清楚。我试图通过首先find_package(GLFW)，然后if(TARGET glfw) 输出一些东西，最后target_link_libraries(xxx glfw3) 来查看cmake 是否可以找到glfw
但是……为什么？你读过docs吗？喜欢第一行：<PackageName>_FOUND will be set to indicate whether the package was found
@KamilCuk 和 ${GLFW_FOUND} 是真的

标签： c++ cmake glfw cmakelists-options

【解决方案1】：

您的FindGLFW.cmake 文件不足。事实上，它根本不应该被需要或存在。 GLFW 已经提供了一个配置包。以下是您应该如何构建和使用任何表现良好的 CMake 包：

首先，获取源代码，构建包，并将其安装到本地前缀：

$ git clone https://github.com/glfw/glfw
Cloning into 'glfw'...
remote: Enumerating objects: 27050, done.
remote: Counting objects: 100% (96/96), done.
remote: Compressing objects: 100% (66/66), done.
remote: Total 27050 (delta 40), reused 54 (delta 24), pack-reused 26954
Receiving objects: 100% (27050/27050), 13.27 MiB | 2.87 MiB/s, done.
Resolving deltas: 100% (19047/19047), done.
$ cd glfw/
glfw$ cmake -G Ninja -DCMAKE_BUILD_TYPE=Release -S . -B build
...
-- Generating done
-- Build files have been written to: /path/to/glfw/build
glfw$ cmake --build build
...
glfw$ cmake --install build --prefix install
-- Install configuration: "Release"
-- Installing: /path/to/glfw/install/lib/libglfw3.a
-- Installing: /path/to/glfw/install/include/GLFW
-- Installing: /path/to/glfw/install/include/GLFW/glfw3.h
-- Installing: /path/to/glfw/install/include/GLFW/glfw3native.h
-- Installing: /path/to/glfw/install/lib/cmake/glfw3/glfw3Config.cmake
-- Installing: /path/to/glfw/install/lib/cmake/glfw3/glfw3ConfigVersion.cmake
-- Installing: /path/to/glfw/install/lib/cmake/glfw3/glfw3Targets.cmake
-- Installing: /path/to/glfw/install/lib/cmake/glfw3/glfw3Targets-release.cmake
...

然后为您的示例项目创建一个文件夹并将您的 CMakeLists.txt 放在那里：

glfw$ mkdir ../glfw-test ; cd ../glfw-test
glfw-test$ vim CMakeLists.txt
glfw-test$ cat CMakeLists.txt
cmake_minimum_required(VERSION 3.20)
project(example)

find_package(glfw3 REQUIRED)

message(STATUS "GLFW: ${glfw3_FOUND}")
if (TARGET glfw)
  message(STATUS "Target exists")
else ()
  message(STATUS "Target does not exist")
endif()

然后您可以构建它并使用<pkg>_ROOT 变量告诉CMake 在哪里可以找到glfw3。如果您在系统范围内安装了软件包，则无需设置此变量。

glfw-test$ cmake -S . -B build -Dglfw3_ROOT=/path/to/glfw/install
...
-- GLFW: 1
-- Target exists
-- Configuring done
-- Generating done
-- Build files have been written to: /path/to/glfw-test/build

【讨论】：

【解决方案2】：

可能是什么原因？

在您的 cmake 配置中没有名为 glfw 或 glfw3 的此类目标。

请注意，target_link_libraries(xxx glfw3) 很可能与库 glfw3 链接，而不管您的 find_package 调用。我认为你应该更喜欢target_include_directories(xxx ${GLFW_INCLUDE_DIR}) 和target_link_libraries(xxx ${GLFW_LIBRARY})。

【讨论】：

但是glfw在构建的时候，有一个叫glfw3的target：github.com/glfw/glfw/blob/master/CMakeLists.txt#L301
是的。 ... 和？当它建成时，就在了。但它不在您的 cmake 配置中，所以没有。 .. 和？
所以当我运行find_library( GLFW_LIBRARY NAMES glfw glfw3) 的find_package(GLFW REQUIRED) 时，不应该自动找到glfw3 作为目标，然后我可以将它与target_link_libraries(xxx glfw3) 链接？
@Tim - 不，一点也不。 CMake 不会神奇地创建目标。 Find 模块必须调用 add_library 并适当地设置属性。
find_library 定位磁盘上的库文件并将该文件的路径保存在缓存变量中。而已。它没有说find_library 将创建一个目标。