使用FetchContent引入的nfd库安装导出报错问题求助

问题背景 #

在Windows环境下，通过CMake的FetchContent拉取nativefiledialog-extended（nfd）的c++-version分支，成功编译生成nfd.lib后，添加安装导出命令时触发报错，提示nfd目标的INTERFACE_INCLUDE_DIRECTORIES包含构建/源码目录下的绝对路径。

报错原因 #

1. nfd库自身的CMake配置中，INTERFACE_INCLUDE_DIRECTORIES指向了FetchContent下载的本地源码目录（_deps/nfd-src/src/include/），这是仅当前构建环境有效的绝对路径，无法在安装导出后被其他项目复用。
2. 安装命令中PUBLIC_HEADER DESTINATION使用了${nfd_SOURCE_DIR}这个源码目录绝对路径，不符合CMake安装路径的规范要求。

解决方案 #

步骤1：修正头文件安装路径 #

将nfd的头文件复制到标准安装目录，使用GNUInstallDirs提供的${CMAKE_INSTALL_INCLUDEDIR}变量指定目标路径，避免依赖本地源码目录。

步骤2：调整nfd目标的接口包含目录 #

覆盖nfd目标原有的INTERFACE_INCLUDE_DIRECTORIES，通过BUILD_INTERFACE和INSTALL_INTERFACE分别指定构建时和安装后的头文件路径，确保导出的CMake配置能在不同环境下正确找到头文件。

步骤3：规范安装导出命令 #

确保install(TARGETS)和install(EXPORT)的路径符合CMake安装规范，使用标准变量替代绝对路径。

修改后的完整CMakeLists.txt #

cmake_minimum_required(VERSION 3.24)
project(mynfd VERSION 1.0.0)
include(FetchContent)
include(GNUInstallDirs)

# 拉取nfd库
FetchContent_Declare(nfd
        GIT_REPOSITORY https://github.com/btzy/nativefiledialog-extended.git
        GIT_TAG c++-version)
FetchContent_MakeAvailable(nfd)

# 修正nfd目标的接口包含目录，适配构建和安装两种场景
set_target_properties(nfd PROPERTIES
        INTERFACE_INCLUDE_DIRECTORIES "$<BUILD_INTERFACE:${nfd_SOURCE_DIR}/src/include>;$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>"
)

# 安装库文件与头文件
install(TARGETS nfd
        EXPORT ${PROJECT_NAME}Targets
        ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
        RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
        FILE_SET HEADERS DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
)

# 确保nfd头文件被完整复制到安装目录
install(DIRECTORY ${nfd_SOURCE_DIR}/src/include/
        DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
        FILES_MATCHING PATTERN "*.h" PATTERN "*.hpp"
)

# 导出CMake配置文件
install(EXPORT ${PROJECT_NAME}Targets
        FILE ${PROJECT_NAME}Targets.cmake
        NAMESPACE ${PROJECT_NAME}::
        DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/${PROJECT_NAME}
)

关键说明 #

• $<BUILD_INTERFACE>：指定本地构建当前项目时使用的头文件路径（源码目录）
• $<INSTALL_INTERFACE>：指定安装后其他项目引用时的头文件路径（标准安装目录）
• CMAKE_INSTALL_LIBDIR、CMAKE_INSTALL_INCLUDEDIR等变量由GNUInstallDirs提供，会根据系统自动适配标准路径（Windows下默认对应lib、include目录）

内容的提问来源于stack exchange，提问作者shashashamti2008