C++/CMake 构建系统:(二)包管理

共享公共包 用过 npm、pip 或是 go 等的包管理系统就知道,对于工程来说,除了工程目录下的依赖包,还可以有一些系统范围共享的依赖包,以便减少重复包所占用的空间。 CMake 也提供了这个功能,允许设置全局范围的默认包搜索路径。 在系统范围内设置 CMAKE_PREFIX_PATH 环境变量可以指定包管理的前缀路径。而 CMAKE_INSTALL_PREFIX 环境变量可以指定安装和搜索包的前缀路径,所以这里优先使用后者方便同时设置安装和搜索包路径。 安装一个包到公共目录 对于可执行文件,可以简单的统一安装到公共目录的 bin 文件夹下。 install(TARGETS base_test DESTINATION bin)对于库文件,这里希望可以按工程区分不同的包,方便管理。 install(TARGETS libbase ARCHIVE DESTINATION "${PROJECT_NAME}/lib")install(FILES ${public_headers} DESTINATION "${PROJECT_NAME}/include/libbase")区分接口文件包含路径 如果需要安装的库包含接口目录,则有可能因为安装路径变化,导致头文件搜索错误。 这里需要区分构建和安装时的接口文件路径。 target_include_directories(libbase INTERFACE $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}> $<INSTALL_INTERFACE:${PROJECT_NAME}/include>)安装时导出目标 为了方便其他工程引用安装到公共目录的包,可以使用 install 命令增加导出。 install(FILES ${public_headers} EXPORT "${PROJECT_NAME}Targets" DESTINATION "${PROJECT_NAME}/include/libbase")对于导出的包,需要增加一个 cmake 文件方便其他工程使用。 安装时导出配置 为了方便 find_package 命令导入包,还需要生成 Config 文件。CMake 提供了脚本来自动生成导出的 Config。 include(CMakePackageConfigHelpers)configure_package_config_file( "${PROJECT_SOURCE_DIR}/cmake/${PROJECT_NAME}Config.cmake.in" "${PROJECT_BINARY_DIR}/cmake/${PROJECT_NAME}Config.cmake" INSTALL_DESTINATION "${PROJECT_NAME}/cmake")write_basic_package_version_file( "${PROJECT_BINARY_DIR}/cmake/${PROJECT_NAME}ConfigVersion.cmake" VERSION "${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}" COMPATIBILITY AnyNewerVersion)同时要提供配置文件模板 LibBaseConfig.cmake.in。 @PACKAGE_INIT@ include("${CMAKE_CURRENT_LIST_DIR}/@PROJECT_NAME@Targets.cmake")check_required_components(@PROJECT_NAME@)最后把生成好的文件也安装到全局目录下。 install(DIRECTORY "${PROJECT_BINARY_DIR}/cmake" DESTINATION ${PROJECT_NAME})使用包 安装好的包,其他工程就可以通过 find_package 命令直接使用了。...

December 24, 2022 · 1 min · lyincc

C++/CMake 构建系统:(一)基本工程结构

主工程文件 首先要创建工程的主要入口,也就是一个 CMakeLists.txt 文件。 构建工程时就需要指定这个文件的所在目录。 CMake 版本和策略 主工程文件首先要描述的就是对 CMake 的版本选择和全局策略开关。 主要涉及 cmake_minimum_required 和 cmake_policy 两个命令。 对整个工程使用的 CMake 特性进行约定。 cmake_minimum_required(VERSION 3.24)全局变量 这部分定义工程需要的全局变量,如工程名、版本号等。 可以直接用 project 命令定义,也可以用 set 命令对变量进行指定。 project("base" VERSION 0.0.1)将全局变量同步到 C++ 代码 如果有些全局变量希望可以共享给 C++ 代码,比如工程版本号,可以使用 configure_file 修改部分文件的代码,将全局变量赋给文件中的指定占位符。 创建一个 project_config.h.in 文件,写入以下内容。 constexpr int kBaseVersionMajor = @Base_VERSION_MAJOR@; constexpr int kBaseVersionMinor = @Base_VERSION_MINOR@; constexpr char kBaseVersion = @Base_VERSION@; 在 CMakeLists.txt 中增加生成文件的命令。 configure_file(global_config.h.in global_config.h)构建后就会自动生成解析后的 global_config.h 文件供其他 C++ 源码使用。 全局编译选项 修改全局编译器配置,也可以使用默认配置不做修改。 这里指定默认的 C++ 语言标准版本。 set(CMAKE_CXX_STANDARD 20)set(CMAKE_CXX_STANDARD_REQUIRED True)添加自定义命令 如果有些构建的准备工作需要处理,比如将配置阶段生成的 project_config....

December 18, 2022 · 1 min · lyincc

CMake 使用

命令行 生成 mkdir build cd build cmake .. -G "Visual Studio 15 2019" -A Win32 在 build 文件夹中创建 CMake 工程。建议对所有工程都这样采用独立目录建立工程,这样方便删除工程,不易污染源文件。 不能重复执行,如果需要重建工程需要删除这个目录。 cmake . 构建 在一个已经创建的 cmake 工程中执行,可以更新该工程。 编译工程,指定配置。 cmake --build . --config Release 开启并行编译 cmake --build . -j8 安装 安装工程,可以指定安装目录。 cmake --install . --config Release --prefix "E:/library/cmake/OpenSSL" CMAKE 变量 CMAKE_PREFIX_PATH 搜索路径。 CMAKE_MODULE_PATH 模块搜索路径。 CMAKE_CURRENT_LIST_DIR 当前 CMakeLists.txt 文件目录 CMAKE_CURRENT_BINARY_DIR 当前输出目录 CMAKE_COMMAND cmake 执行文件路径 指令 命令行输出 message("Output.")源文件编码 在 VS2017 以上版本,可以指定编译参数使用 UTF-8 编码...

April 15, 2021 · 1 min · lyincc