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

trivial 和 POD 类型

POD 类型 (Plain Old Data) POD 类型也就是传统 C 类型,脱离或不使用 OOP 的特征。 POD 多用于类和结构体,拥有以下特性: 允许通过直接内存操作进行构造或析构。 兼容 C。 保证静态初始化有效,可以放入 .bss 段。 trivial or non-trivial 对于类的四种函数,有 trivial (平凡)和 non-trivial (非平凡)的概念。 构造函数 (ctor) 拷贝构造函数 (copy) 赋值函数 (assignment) 析构函数 (dtor) 如果满足以下条件之一: 显示定义了上诉四种函数之一 类内存在非 POD 成员 有基类 那么上述四种函数为 non-trival 函数。 参考

October 30, 2021 · 1 min · lyincc

一次 CEF 崩溃排查

崩溃信息 dump 原始堆栈 WARNING: Continuing a non-continuable exception (2978.5e4): Access violation - code c0000005 (first chance) First chance exceptions are reported before any exception handling. This exception may be expected and handled. eax=00b5f130 ebx=0b746000 ecx=00000000 edx=00b5f278 esi=0b746000 edi=00b5f220 eip=116b5c90 esp=00b5f0b8 ebp=00b5f0d8 iopl=0 nv up ei pl nz na pe nc cs=0023 ss=002b ds=002b es=002b fs=0053 gs=002b efl=00010206 libcef!ui::Compositor::SetScaleAndSize+0xe: 116b5c90 f30f1089c4000000 movss xmm1,dword ptr [ecx+0C4h] ds:002b:000000c4=???????? 0:000> k # ChildEBP RetAddr 00 00b5f0d8 116b48a3 libcef!...

July 31, 2021 · 2 min · lyincc

boost 使用

编译 boost 支持使用 bjam.exe 或 b2.exe 编译。b2 是 bjam 的升级版本。所以推荐使用 b2。 目前 boost 库中可以看到 CMakeLists.txt 文件,说明官方也在支持 CMake 编译,但官方表示 CMake 编译支持还在开发中,还不能使用。 .\bootstrap.bat 先使用初始脚本编译构建工具。 .\b2 install --toolset=msvc-15.0 --prefix="E:\library\cpp\msvc-15.0_x86_Release\boost" link=static runtime-link=shared threading=multi address-model=32 release 编译 32 位静态库。 在 CMake 中使用 find_package 导入 boost 在项目 CMake 工程文件中增加 SET(Boost_ADDITIONAL_VERSIONS "1.76" "1.76.0")SET(BOOST_ROOT "E:/library/cpp/msvc-15.0_x86_Release/boost")SET(BOOST_USE_STATIC_LIBS ON)SET(BOOST_USE_MULTITHREADING ON)SET(BOOST_USE_STATIC_RUNTIME OFF)find_package(Boost "1.76.0" COMPONENTS interprecess REQUIRED)if(Boost_FOUND) include_directories(${Boost_INCLUDE_DIRS}) target_link_libraries(progname ${Boost_LIBRARIES})endif()

April 16, 2021 · 1 min · lyincc