当前位置:

首页 > 编程开发 > C++如何用CMake管理项目_CMake跨平台教程

C++如何用CMake管理项目_CMake跨平台教程

CMake是跨平台构建系统生成器,通过CMakeLists.txt生成多平台构建文件。1.安装:Linux用apt,macOS用brew,Windows从官网下载;2.项目结构含src、include和CMakeLists.txt;3.基本语法包括设置版本、项目名、C++标准及添加可执行文件;4.推荐out-of-source构建,使用mkdirbuild、cmake..、make编译;5.配置头文件路径用target_include_directories,链接库用find_package和target

本文目录

    CMake是跨平台构建系统生成器,通过CMakeLists.txt生成多平台构建文件。1. 安装:Linux用apt,macOS用brew,Windows从官网下载;2. 项目结构含src、include和CMakeLists.txt;3. 基本语法包括设置版本、项目名、C++标准及添加可执行文件;4. 推荐out-of-source构建,使用mkdir build、cmake ..、make编译;5. 配置头文件路径用target_include_directories,链接库用find_package和target_link_libraries;6. 支持条件判断处理跨平台差异,如WIN32、APPLE、UNIX;7. 现代CMake提倡target_*命令提升模块化;8. 可集成测试与安装规则,enable_testing()和install()实现自动化。掌握这些核心用法即可高效管理跨平台C++项目。

    c++怎么用CMake来管理项目_c++跨平台构建工具CMake使用教程

    CMake 是一个强大的跨平台构建系统生成器,广泛用于 C++ 项目中。它不直接编译代码,而是根据 CMakeLists.txt 文件生成适用于不同平台的构建文件(如 Makefile、Visual Studio 工程等),从而实现“一次编写,多平台构建”。

    1. 安装 CMake

    在使用前需确保已安装 CMake:

    • Linux(Ubuntu/Debian):sudo apt install cmake
    • macOS:brew install cmake
    • Windows:从 官网下载安装包,或使用 vcpkg、MSYS2 等工具安装

    安装完成后,可通过以下命令验证:

    cmake --version

    2. 基本项目结构

    一个典型的 C++ 项目结构如下:

    my_project/
    ├── CMakeLists.txt
    ├── src/
    │   └── main.cpp
    └── include/
        └── my_header.h
    

    在项目根目录创建 CMakeLists.txt,内容如下:

    cmake_minimum_required(VERSION 3.10)
    project(MyProject LANGUAGES CXX)

    # 设置 C++ 标准
    set(CMAKE_CXX_STANDARD 17)
    set(CMAKE_CXX_STANDARD_REQUIRED ON)

    # 添加可执行文件
    add_executable(${PROJECT_NAME}
    src/main.cpp
    )

    说明:

    • cmake_minimum_required:指定所需最低 CMake 版本
    • project:定义项目名称和语言
    • set(CMAKE_CXX_STANDARD ...):启用 C++17 支持
    • add_executable:将源文件编译为可执行程序

    3. 编译与运行项目

    推荐使用 out-of-source 构建方式,避免污染源码目录:

    mkdir build
    cd build
    cmake ..
    make

    生成后可在 build/ 目录下找到可执行文件 MyProject,运行:

    ./MyProject

    4. 添加头文件目录和库依赖

    若项目包含头文件或第三方库,需配置包含路径:

    target_include_directories(${PROJECT_NAME} PRIVATE
    ${PROJECT_SOURCE_DIR}/include
    )

    如果需要链接外部库(例如 Boost 或 OpenCV):

    find_package(OpenCV REQUIRED)
    target_link_libraries(${PROJECT_NAME} PRIVATE ${OpenCV_LIBS})

    对于静态或动态库,可使用 add_library 创建:

    add_library(mylib STATIC src/mylib.cpp)
    target_include_directories(mylib PUBLIC include)
    target_link_libraries(${PROJECT_NAME} PRIVATE mylib)

    5. 跨平台兼容性处理

    CMake 可自动识别平台并做条件判断:

    if(WIN32)
    message("Building on Windows")
    add_compile_definitions(IS_WINDOWS)
    elseif(APPLE)
    message("Building on macOS")
    elseif(UNIX)
    message("Building on Linux")
    endif()

    也可针对不同构建类型(Debug/Release)设置编译选项:

    if(CMAKE_BUILD_TYPE STREQUAL "Debug")
    add_compile_definitions(DEBUG_MODE)
    endif()

    6. 使用现代 CMake 最佳实践

    现代 CMake 推荐使用 target_* 系列命令,而非全局设置:

    • target_include_directories():只为特定目标添加头文件路径
    • target_compile_features():指定目标所需的编译特性
    • target_link_libraries():精确控制库依赖传递

    这样可以提升模块化程度,便于大型项目维护。

    7. 集成测试与安装

    启用测试功能:

    enable_testing()
    add_test(NAME run_main COMMAND MyProject)

    设置安装规则:

    install(TARGETS ${PROJECT_NAME}
    DESTINATION bin
    )
    install(DIRECTORY include/
    DESTINATION include
    )

    执行安装:

    make install(可指定 CMAKE_INSTALL_PREFIX)

    基本上就这些。CMake 功能丰富,但掌握基本语法后就能高效管理大多数 C++ 项目,尤其适合希望支持 Windows、Linux 和 macOS 的跨平台开发场景。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    Visual Studio2019更改解决方案名称与项目命名方法
    Visual Studio2019更改解决方案名称与项目命名方法

    在 Visual Studio 2019 中正确更改解决方案和项目名称的方法指南。包括如何区分解决方案名、项目名与命名空间,使用快捷键 Ctrl+Alt+L 打开资源管理器进行重命名,以及后续对 .sln 文件、.csproj 文件和代码 namespace 的同步调整与验证步骤。

    VisualStudio2026企业版离线安装包创建详细步骤
    VisualStudio2026企业版离线安装包创建详细步骤

    通过 Microsoft 官方文档确认的 vs_enterprise.exe 引导程序,逐步指导用户创建包含特定工作负载的离线布局,实现跨设备的高效部署与更新。

    VisualStudio2019命令行参数自定义安装工作负载
    VisualStudio2019命令行参数自定义安装工作负载

    详解 Visual Studio 2019 命令行安装方法,包括使用 --add 指定工作负载 ID、--includeRecommended 包含推荐组件,以及区分新装与修改实例的正确命令入口,适用于自动化部署场景。

    如何在Visual Studio2022导入已有代码文件夹创建项目
    如何在Visual Studio2022导入已有代码文件夹创建项目

    详解 Visual Studio 2022 如何从现有代码文件夹创建 C++、C# 或 VB 项目,对比打开文件夹与加载 .sln 文件的区别,避免重复构建结构,确保项目配置正确。

    Visual Studio2019导出导入IDE布局窗口配置文件
    Visual Studio2019导出导入IDE布局窗口配置文件

    详细步骤指南:在 VS2019 中调整并保存工具窗口布局,使用导入导出向导选择 Window Layouts 类别生成 .vssettings 文件,并在另一台机器或实例中恢复布局,同时处理多显示器适配问题。

    VisualStudio2022社区版如何从官网下载安装包
    VisualStudio2022社区版如何从官网下载安装包

    详细讲解 Visual Studio 2022 社区版的官方下载入口、引导程序获取、工作负载配置及安装启动步骤,确保用户正确安装开发环境。

    Visual Studio2017调试附加到进程,附加运行中程序
    Visual Studio2017调试附加到进程,附加运行中程序

    学习在 Visual Studio 2017 中通过“附加到进程”功能调试正在运行的应用程序。了解如何正确选择进程实例、配置调试类型,并解决因符号文件或源码不匹配导致的断点失效问题。

    Visual Studio2019禁用IDE后台自动代码扫描提升速度
    Visual Studio2019禁用IDE后台自动代码扫描提升速度

    针对 Visual Studio 2019 编辑大型项目时的卡顿问题,提供分语言关闭后台代码分析的具体步骤,包括 C#/VB 的分析范围设置、C++ 的后台分析禁用选项以及 .NET Framework 的项目文件配置方法。

    Visual Studio2017解决方案资源管理器窗口不见了找回办法
    Visual Studio2017解决方案资源管理器窗口不见了找回办法

    Visual Studio 2017 解决方案资源管理器不见了怎么办?通过快捷键 Ctrl+Alt+L、视图菜单或重置窗口布局即可快速恢复。本文详解各种场景下的找回技巧及注意事项。

    Visual Studio2022代码注释插件管理与卸载方法
    Visual Studio2022代码注释插件管理与卸载方法

    详细指南:如何在 Visual Studio 2022 中安全卸载代码注释扩展。涵盖打开扩展管理器、区分禁用与卸载、处理待处理更改及确认卸载结果的操作步骤。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。