C++跨平台开发 CMake构建系统配置

CMake是C++跨平台开发的理想选择，它通过一份CMakeLists.txt文件统一管理项目构建，屏蔽不同平台和编译器的差异。开发者只需声明项目结构、源文件、依赖关系和编译标准，CMake即可生成对应平台的构建文件（如Makefile或.sln），实现“一次编写，到处生成”。通过内置变量（如WIN32、UNIX、APPLE）和条件语句，可灵活处理平台特定的源文件、库链接和宏定义，结合find_package等命令简化依赖管理。典型流程包括创建CMakeLists.txt、设置C++标准、添加可执行文件、配置构建目录并使用cmake命令生成和编译项目，从而高效支持Windows、Linux、macOS等多平台编译。

C++跨平台开发中，CMake是解决构建系统复杂性的核心工具。它提供了一种高级、平台无关的方式来定义项目的构建过程，然后生成特定平台和编译器的构建文件（如Makefile、Visual Studio项目文件），从而极大地简化了在Windows、Linux、macOS等不同操作系统上编译和管理C++项目的挑战。

解决方案

在C++跨平台开发中，配置CMake构建系统，其核心在于编写一份声明式的

CMakeLists.txt

CMakeLists.txt

一个典型的流程是：

1. 在项目根目录创建一个

   CMakeLists.txt

   文件。
2. 定义项目的基本信息，比如项目名称、C++标准版本。
3. 添加源文件，并指定生成可执行文件或库。
4. 声明项目的依赖库和头文件路径。
5. 在不同的平台上，使用

   cmake

   命令行工具生成构建文件，例如在Windows上生成

   .sln

   ，在Linux上生成

   Makefile

   。
6. 使用生成的构建文件进行编译。

为什么CMake是C++跨平台开发的理想选择？

我个人觉得，CMake最棒的地方在于它把那些平台和编译器之间的繁琐差异，巧妙地藏在了背后，给我们开发者提供了一个统一的“语言”来描述项目。想想看，如果没有它，你可能得为Windows写一套Visual Studio的工程文件，再为Linux写一套Makefile，macOS可能又是Xcode的配置，这简直是噩梦。每次添加一个源文件，或者引入一个新的库，你都得在所有这些不同的构建系统里同步修改，出错的概率高不说，效率也极低。

立即学习“C++免费学习笔记（深入）”；

CMake提供的是一个高层次的抽象，它不直接构建代码，而是生成其他构建工具（比如

make

ninja

CMakeLists.txt

如何编写一个基础的CMakeLists.txt文件以支持多平台编译？

编写一个基础的

CMakeLists.txt

假设你有一个

main.cpp

// main.cpp
#include 

int main() {
    std::cout << "Hello from CMake Cross-Platform!" << std::endl;
    return 0;
}

你的

CMakeLists.txt

# 声明CMake的最低版本要求，这是一个好习惯
cmake_minimum_required(VERSION 3.10)

# 定义项目名称
project(MyCrossPlatformApp CXX) # CXX表示这是一个C++项目

# 设置C++标准，比如C++17。这很重要，确保不同编译器使用相同的标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON) # 要求编译器必须支持这个标准
set(CMAKE_CXX_EXTENSIONS OFF)       # 禁用GNU扩展，保持代码更纯粹、更跨平台

# 添加一个可执行文件，指定它的源文件
add_executable(MyCrossPlatformApp main.cpp)

# 如果你的项目有头文件，可能需要添加头文件搜索路径
# target_include_directories(MyCrossPlatformApp PUBLIC
#    ${CMAKE_CURRENT_SOURCE_DIR}/include
# )

# 如果你的项目依赖了其他库，比如Boost或者你自己的静态库
# target_link_libraries(MyCrossPlatformApp PUBLIC MyCustomLib)

这个文件就定义了一个名为

MyCrossPlatformApp

main.cpp

HTShop网上购物系统

HTShop网上购物系统由恒天网络科技有限公司根据国际先进技术和国内商务特点自主版权开发的一款具有强大功能的B2C电子商务网上购物平台。HTShop以国际上通用流行的B/S(浏览器/服务器)模式进行设计，采用微软公司的ASP.NET（C#）技术构建而成。 2007-11-10 HTShop CS 通用标准版 v1.1.11.10 更新内容自由更换模版功能开放 修改了购买多款商品，会员中心订单只显示

下载

构建流程：

1. 创建构建目录： 通常我们会在项目根目录外创建一个

   build

   目录，进行“out-of-source”构建，这样可以保持源代码目录的整洁。

   mkdir build
   cd build

2. 运行CMake生成构建文件：
   • 在Linux/macOS上，这通常会生成

     Makefile

     ：

     cmake ..

   • 在Windows上，如果你安装了Visual Studio，它可能会默认生成Visual Studio解决方案文件：

     cmake ..

     你也可以显式指定生成器，例如生成Ninja构建文件：

     cmake -G "Ninja" ..

3. 编译项目：
   • 对于

     Makefile

     或

     ninja

     ：

     cmake --build .

   • 对于Visual Studio，你可以在IDE中打开生成的

     .sln

     文件进行编译，或者通过命令行：

     cmake --build . --config Release # 指定Release或Debug配置

通过这些步骤，你就可以在任何支持CMake的平台上，用一份

CMakeLists.txt

在CMake中如何处理不同的平台特定配置和依赖？

处理平台特定配置和依赖是CMake进阶使用的重要部分，它允许你的项目在不同操作系统或编译器下表现出不同的行为，比如链接不同的库、包含不同的源文件，甚至定义不同的宏。这方面，CMake提供了条件判断语句和一些内置变量来帮助我们实现。

最常用的就是

if()

• WIN32

  ：当在Windows平台下运行时为真。

• APPLE

  ：当在macOS平台下运行时为真。

• UNIX

  ：当在任何Unix-like系统（包括Linux和macOS）下运行时为真。

• MSVC

  ：当使用Microsoft Visual C++编译器时为真。

• CMAKE_SYSTEM_NAME

  ：可以获取更具体的系统名称，比如"Linux"、"Darwin" (macOS)等。

示例1：平台特定的源文件 假设你有一个功能，在Windows上需要使用

windows_specific.cpp

unix_specific.cpp

if(WIN32)
    add_executable(MyApp main.cpp windows_specific.cpp)
else() # 假设非WIN32就是UNIX-like
    add_executable(MyApp main.cpp unix_specific.cpp)
endif()

或者更精确地：

set(COMMON_SOURCES main.cpp)
if(WIN32)
    list(APPEND COMMON_SOURCES windows_specific.cpp)
elseif(UNIX) # 包含了Linux和macOS
    list(APPEND COMMON_SOURCES unix_specific.cpp)
endif()
add_executable(MyApp ${COMMON_SOURCES})

示例2：平台特定的库链接 你的程序在Windows上可能需要链接DirectX库，而在Linux上则使用OpenGL。

target_link_libraries(MyApp PUBLIC
    # 平台无关的库
    MyCommonLib
)

if(WIN32)
    # 在Windows上链接DirectX相关的库
    find_package(DirectX REQUIRED) # 假设你已经配置了DirectX的查找模块
    target_link_libraries(MyApp PUBLIC ${DirectX_LIBRARIES})
elseif(APPLE)
    # 在macOS上链接Cocoa框架和OpenGL
    find_library(COCOA_LIBRARY Cocoa REQUIRED)
    find_library(OPENGL_LIBRARY OpenGL REQUIRED)
    target_link_libraries(MyApp PUBLIC ${COCOA_LIBRARY} ${OPENGL_LIBRARY})
elseif(UNIX) # 适用于Linux
    # 在Linux上链接OpenGL和X11
    find_package(OpenGL REQUIRED)
    find_package(X11 REQUIRED)
    target_link_libraries(MyApp PUBLIC ${OpenGL_LIBRARIES} ${X11_LIBRARIES})
endif()

这里

find_package()

find_library()

示例3：平台特定的宏定义 有时你需要根据平台定义不同的预处理器宏。

if(WIN32)
    target_compile_definitions(MyApp PUBLIC "PLATFORM_WINDOWS")
elseif(UNIX)
    target_compile_definitions(MyApp PUBLIC "PLATFORM_UNIX")
endif()

这样，在你的C++代码中就可以这样写：

#ifdef PLATFORM_WINDOWS
    // Windows特有的代码
#elif defined(PLATFORM_UNIX)
    // Unix-like系统特有的代码
#endif

通过这些条件判断和变量，我们可以在一份

CMakeLists.txt