CMake教程：核心指令与最佳实践

"CMAKEnote.md" CMake是一个跨平台的开源构建系统，它用于管理软件项目的构建过程。它的设计目标是简化构建过程，并允许开发者使用统一的方式管理不同的编译器和构建工具。CMake不直接构建软件，而是生成特定的构建系统脚本，如Unix的Makefile或Windows的Visual Studio项目文件。 ### CMake基本概念 **PROJECT** 函数是CMake脚本的起点，用于声明项目名称，并可以选择支持的语言（如C、C++、Fortran等）。例如，`PROJECT(HELLO)` 定义了一个名为HELLO的项目，支持所有默认语言。 **MESSAGE** 函数用于在构建过程中向用户输出信息。它可以接受三个级别：`SEND_ERROR` 会终止构建过程；`STATUS` 输出带有前缀"-"的信息；`FATAL_ERROR` 立即停止所有CMake操作。 **ADD_EXECUTABLE** 用于创建可执行文件。例如，`ADD_EXECUTABLE(hello ${SRC_LIST})` 指令将根据变量`SRC_LIST`中列出的源文件生成名为hello的可执行程序。 **SET** 命令用于设置变量。如 `SET(SRC_LIST main.cpp)` 创建了一个名为`SRC_LIST`的变量，其值为`main.cpp`。 ### 内部构建与外部构建 内部构建将生成的编译文件放置在源代码目录内，导致大量临时文件，不易于清理。外部构建则将临时文件和中间产物放在一个独立的“build”目录下，保持源代码目录的整洁。推荐使用外部构建，因为它不会污染源代码。实现外部构建，通常会在项目根目录的CMakeLists.txt中使用 `ADD_SUBDIRECTORY` 指令，指向包含源文件的子目录。 **ADD_SUBDIRECTORY** 用于将一个子目录添加到当前工程，并可以指定编译输出路径。例如，`ADD_SUBDIRECTORY(source bin)` 将`source`目录下的子项目添加到构建过程，并将编译输出（包括中间二进制和最终目标）放在`bin`目录下。 ### 安装目标 **INSTALL** 命令用于在构建完成后将工程中的特定文件或目录安装到系统的特定位置。这通常是将可执行文件或库放置在用户可执行路径，以便后续使用。例如，`INSTALL(TARGETS hello DESTINATION bin)` 将生成的hello可执行文件安装到系统的`bin`目录下。 CMake的灵活性和跨平台特性使其成为大型项目和多模块项目理想的构建工具。通过使用CMake，开发者可以轻松地在不同平台上进行构建和部署，而无需关心底层构建系统的细节。