c++怎么在CMake中进行交叉编译_C++跨平台构建与交叉编译方法

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

c++怎么在CMake中进行交叉编译_C++跨平台构建与交叉编译方法

2025-11-15

浏览次数：次

返回列表

交叉编译是在一个平台上生成另一个平台的可执行文件，CMake通过toolchain文件配置目标系统、编译器和查找路径，结合交叉工具链实现C++项目在不同架构（如ARM）上的构建。

c++怎么在cmake中进行交叉编译_c++跨平台构建与交叉编译方法

在使用 C++ 开发时，如果需要将程序编译到不同于开发主机的平台（如嵌入式设备、ARM Linux 系统等），就需要进行交叉编译。CMake 是一个强大的跨平台构建系统，支持灵活配置交叉编译环境。下面介绍如何在 CMake 中实现 C++ 项目的交叉编译。

什么是交叉编译

交叉编译是指在一个平台上生成另一个平台可运行的可执行文件。例如，在 x86_64 的 Linux 主机上编译出能在 ARM 架构的嵌入式设备上运行的程序。这在嵌入式开发、移动开发中非常常见。

准备交叉编译工具链

要进行交叉编译，首先需要一个针对目标平台的工具链（toolchain），通常包括：

交叉编译器：如 arm-linux-gnueabihf-gcc 和 arm-linux-gnueabihf-g++
链接器、汇编器 和其他配套工具
目标平台的系统库和头文件

安装工具链的方式因平台而异。例如在 Ubuntu 上安装 ARM 工具链：

sudo apt install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf

编写 Toolchain 文件

CMake 使用 toolchain 文件来指定交叉编译所需的参数。创建一个名为 arm-toolchain.cmake 的文件：

</p><h1>arm-toolchain.cmake</h1><p>set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)</p><h1>指定交叉编译器路径（根据实际安装位置调整）</h1><p>set(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)
set(CMAKE_CXX_COMPILER arm-linux-gnueabihf-g++)</p><h1>搜索路径设置</h1><p>set(CMAKE_FIND_ROOT_PATH /usr/arm-linux-gnueabihf)</p><h1>只在目标环境中搜索库和头文件</h1><p>set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)</p>

这个文件告诉 CMake：

Reachout.ai

一个AI驱动的视频开发平台，专为忙碌的企业家和销售团队打造

142 查看详情 Reachout.ai

目标系统是 Linux，架构是 ARM
使用指定的交叉编译器
库和头文件在目标系统路径下查找

使用 CMake 进行交叉编译

在项目根目录下有一个简单的 C++ 项目，结构如下：

.
├── CMakeLists.txt
└── main.cpp

CMakeLists.txt 内容：

cmake_minimum_required(VERSION 3.10)
project(MyApp LANGUAGES CXX)
<p>set(CMAKE_CXX_STANDARD 17)
add_executable(myapp main.cpp)</p>

接下来创建构建目录并指定 toolchain 文件：

mkdir build && cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=../arm-toolchain.cmake
make

如果一切正常，生成的可执行文件就是为 ARM 平台编译的。可以用 file 命令验证：

file myapp

输出应包含类似：ELF 32-bit LSB executable, ARM，说明交叉编译成功。

常见问题与注意事项

找不到库或头文件：确保目标平台的 sysroot 路径正确，并通过 CMAKE_FIND_ROOT_PATH 指定
编译器无法执行：检查工具链是否安装完整，权限是否正常
动态库链接失败：可能需要在链接时指定 sysroot：-Wl,--sysroot=/path/to/sysroot
静态编译更简单：对于嵌入式设备，建议使用静态链接避免依赖问题，可在 CMake 中添加：
```
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static")
```