CMake -如何在安装(目标)中安装(目录)？

CMake 是一个跨平台的构建系统生成器，用于自动化软件的编译、测试和安装过程。在 CMake 中，install() 命令用于指定如何安装项目的文件和目标。如果你想在安装过程中指定一个目录，可以使用 install() 命令的不同选项来实现。

基础概念

install() 命令的基本语法如下：

install(TARGETS <target> [EXPORT <export-name>] ...)
install(DIRECTORY <dir> ...)

• TARGETS: 用于安装构建目标（如可执行文件、库等）。
• DIRECTORY: 用于安装目录及其内容。

相关优势

1. 跨平台: CMake 支持多种操作系统和编译器。
2. 灵活性: 可以精确控制文件的安装位置和方式。
3. 自动化: 自动处理依赖关系和构建过程。

类型与应用场景

安装目标 (TARGETS)

适用于安装编译生成的可执行文件、库等。

应用场景: 当你需要安装项目生成的可执行文件或共享库时。

安装目录 (DIRECTORY)

适用于安装整个目录及其内容。

应用场景: 当你需要安装包含多个文件的目录（如配置文件、资源文件等）时。

示例代码

假设你有一个项目，包含一个可执行文件和一个资源目录，你想将它们安装到特定的目录中。

CMakeLists.txt

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 添加可执行文件
add_executable(my_executable main.cpp)

# 安装可执行文件到 bin 目录
install(TARGETS my_executable DESTINATION bin)

# 安装资源目录到 share 目录
install(DIRECTORY resources DESTINATION share)

解决常见问题

问题：安装目录为空

原因: 可能是因为目录中没有文件，或者 CMake 没有正确识别目录中的文件。

解决方法: 确保目录中有文件，并且使用 FILE(GLOB ...) 来动态获取目录中的文件。

file(GLOB RESOURCES "${CMAKE_SOURCE_DIR}/resources/*")
install(FILES ${RESOURCES} DESTINATION share)

问题：安装路径不正确

原因: 可能是因为 DESTINATION 路径设置错误，或者安装脚本没有正确执行。

解决方法: 检查 DESTINATION 路径是否正确，并确保在安装时指定了正确的安装前缀。

install(TARGETS my_executable DESTINATION ${CMAKE_INSTALL_PREFIX}/bin)
install(DIRECTORY resources DESTINATION ${CMAKE_INSTALL_PREFIX}/share)

通过以上步骤，你可以有效地使用 CMake 来管理和安装项目的文件和目录。