【产出】 > 在 x86_64 的 Ubuntu 电脑上安装 ARM64 交叉编译器,编译出能在开发板上运行的程序;看懂
aarch64-linux-gnu这类三元组的含义,用file确认产物架构,弄清动态链接为什么在板子上跑不起来、sysroot 是什么,最后写一个 CMake toolchain 文件把整个工程交叉编译。
【版本】 > 按 GCC 官方手册(安装配置说明、链接选项、目录选项)和 CMake 官方文档
cmake-toolchains(7)编写。主机为 Ubuntu 22.04 / 24.04,目标为 64 位 ARM Linux(aarch64)。
一、为什么要交叉编译
开发板上的 CPU 通常是 ARM 或 RISC-V,内存小、编译慢,很多系统上甚至没有编译器。做法是在 x86 电脑上编译,把生成的可执行文件拷到板子上运行。
GCC 手册把编译过程涉及的机器分成三类:
| 名称 | 含义 | 本教程中 |
|---|---|---|
| build | 正在执行编译的机器 | x86_64 的 Ubuntu 电脑 |
| host | 编译出来的编译器将运行在哪台机器上 | 同 build |
| target | 编译器生成的代码在哪台机器上运行 | aarch64 开发板 |
只要 target 和 host 不同,就是交叉编译器。
二、三元组:工具链名字的含义
GCC 手册规定,标准的配置名由短横线分成三段:cpu-company-system。实际看到的名字常常是省略或扩展过的:
| 工具链前缀 | CPU | 厂商 | 系统 / ABI |
|---|---|---|---|
aarch64-linux-gnu | aarch64(64 位 ARM) | 省略 | Linux + glibc |
arm-linux-gnueabihf | 32 位 ARM | 省略 | Linux + glibc,硬件浮点 EABI |
x86_64-pc-linux-gnu | x86_64 | pc | Linux + glibc |
riscv64-linux-gnu | 64 位 RISC-V | 省略 | Linux + glibc |
arm-none-eabi | 32 位 ARM | 省略 | 无操作系统(裸机,如 STM32) |
三元组决定了生成什么指令集、链接哪套 C 库、遵循什么调用约定。arm-none-eabi 只能编译单片机裸机程序,不能编译 Linux 应用,这是初学者最常拿错的工具链。
用 -dumpmachine 可以让编译器报告自己的目标机器:
gcc -dumpmachine # 本机编译器,输出 x86_64-linux-gnu
aarch64-linux-gnu-gcc -dumpmachine # 交叉编译器,输出 aarch64-linux-gnu
三、安装交叉编译器
Ubuntu 官方源里有现成的包:
sudo apt install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu
aarch64-linux-gnu-gcc --version
安装后,所有工具都带上前缀:aarch64-linux-gnu-gcc、aarch64-linux-gnu-g++、aarch64-linux-gnu-ld、aarch64-linux-gnu-strip、aarch64-linux-gnu-objdump 等。
【注意】 > 发行版自带的交叉编译器链接的是它自己版本的 glibc。如果开发板系统的 glibc 比 Ubuntu 的旧,程序在板子上会报
version 'GLIBC_2.xx' not found。量产项目应使用和板子系统配套的工具链,例如 Buildroot、Yocto 或板厂 SDK 生成的那一套。
四、编译 hello world 并确认架构
// hello.c
#include <stdio.h>
int main(void)
{
printf("hello from aarch64\n");
return 0;
}
aarch64-linux-gnu-gcc -O2 -o hello hello.c
file hello
file 的输出中应能看到 ELF 64-bit LSB、ARM aarch64 和 dynamically linked,以及解释器路径 /lib/ld-linux-aarch64.so.1。如果看到的是 x86-64,说明误用了本机的 gcc。
在电脑上直接 ./hello 会报 Exec format error,这是正常的。把文件拷到板子上运行即可:
scp hello root@192.168.1.50:/tmp/
ssh root@192.168.1.50 /tmp/hello
【提示】 > 没有板子时,可以装
qemu-user在电脑上试跑:qemu-aarch64 -L /usr/aarch64-linux-gnu ./hello。-L指定去哪里找 ARM64 的动态链接器和 C 库。
五、动态链接与 sysroot
动态链接的程序本身不包含 C 库代码,运行时由动态链接器去加载 libc.so.6 等共享库。这带来两个问题:
- 运行时:板子上必须有相同架构、版本足够新的共享库,以及
file输出里那个解释器路径。 - 编译时:编译器要找到 ARM64 版本的头文件和库,而不是电脑上 x86 的
/usr/include、/usr/lib。
存放目标系统头文件和库的目录就叫 sysroot。GCC 手册对 --sysroot=dir 的定义是:把 dir 当作头文件和库的逻辑根目录,原本搜索 /usr/include 和 /usr/lib 的地方,改为搜索 dir/usr/include 和 dir/usr/lib。
aarch64-linux-gnu-gcc -print-sysroot # 查看编译器默认的 sysroot,未配置时输出为空
aarch64-linux-gnu-gcc -print-file-name=libc.so.6 # 查看链接时实际用到的库文件
当程序依赖第三方库(如 libgpiod、OpenSSL)时,需要一个装好了这些库的 ARM64 sysroot。常见来源:
| 来源 | 说明 |
|---|---|
| Buildroot | 构建后在 output/host/ 下有工具链和 sysroot |
| Yocto | bitbake -c populate_sdk 生成 SDK |
| 板子的根文件系统 | 用 rsync 把板子的 /usr、/lib 拷回电脑 |
aarch64-linux-gnu-gcc --sysroot=$HOME/rootfs-arm64 -o app app.c -lgpiod
六、静态链接
GCC 手册说明:在支持动态链接的系统上,-static 会阻止与共享库链接(并覆盖 -pie)。产物把用到的库代码全部打包进去,不依赖板子上的库:
aarch64-linux-gnu-gcc -static -O2 -o hello_static hello.c
file hello_static # 显示 statically linked
ls -lh hello hello_static
| 动态链接 | 静态链接 | |
|---|---|---|
| 文件大小 | 小 | 大(多出几百 KB 到几 MB) |
| 依赖板子上的库 | 是 | 否 |
| 库有安全更新 | 更新系统库即可 | 必须重新编译 |
| 适合 | 正式产品、有完整根文件系统 | 快速验证、救急工具、极简系统 |
【注意】 > glibc 的部分功能(如
getaddrinfo、getpwnam)在静态链接时仍会尝试加载共享模块,链接时会给出警告。需要真正独立的静态程序时,常用 musl 工具链。
七、CMake toolchain 文件
工程一大,手工写编译命令就不现实了。CMake 用 toolchain 文件描述目标平台。新建 aarch64-linux-gnu.cmake:
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR aarch64)
# 可选:目标系统的 sysroot
# set(CMAKE_SYSROOT /home/user/rootfs-arm64)
set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc)
set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g++)
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)
| 变量 | 作用 |
|---|---|
CMAKE_SYSTEM_NAME | 目标操作系统。设置它之后 CMake 就认为是在交叉编译,CMAKE_CROSSCOMPILING 为真 |
CMAKE_SYSTEM_PROCESSOR | 目标处理器架构 |
CMAKE_SYSROOT | 目标 sysroot,CMake 会把它作为 --sysroot 传给编译器 |
CMAKE_C_COMPILER | 编译器的完整路径,或能在标准位置找到的名字 |
CMAKE_FIND_ROOT_PATH_MODE_* | PROGRAM 设为 NEVER:构建时要运行的工具只从主机找;LIBRARY、INCLUDE、PACKAGE 设为 ONLY:库、头文件、包只从目标环境找 |
后四行最容易被忽略。不写的话,find_package() 可能找到电脑上 x86 的库,链接时才报 file in wrong format。
使用方法(CMake 官方给出的两种写法等价,--toolchain 需要 CMake 3.21 及以上):
cmake -S . -B build-arm64 --toolchain aarch64-linux-gnu.cmake
# 或
cmake -S . -B build-arm64 -DCMAKE_TOOLCHAIN_FILE=aarch64-linux-gnu.cmake
cmake --build build-arm64
file build-arm64/你的程序
【提示】 > toolchain 文件只在第一次配置时读取。改了 toolchain 文件后,删掉
build-arm64目录重新配置。toolchain 文件里引用相对路径时用CMAKE_CURRENT_LIST_DIR,官方文档提醒不要用CMAKE_SOURCE_DIR、CMAKE_BINARY_DIR,它们在try_compile()等场景下的值不同。
八、常见错误
| 现象 | 原因与处理 |
|---|---|
板子上 not found,但文件明明存在 | 板子上没有 file 显示的解释器(动态链接器)。换配套工具链或静态链接 |
GLIBC_2.xx not found | 工具链的 glibc 比板子新,换和板子配套的工具链 |
Exec format error | 架构不对,用 file 检查,确认没用错编译器 |
链接报 file in wrong format / incompatible | 链接到了 x86 的库,检查 sysroot 和 CMake 的 FIND_ROOT_PATH_MODE |
找不到 gpiod.h 等头文件 | sysroot 里没有这个库的开发文件,先把库装进 sysroot |
参考资料
- GCC 配置名(build / host / target):https://gcc.gnu.org/install/configure.html
- GCC 链接选项(-static 等):https://gcc.gnu.org/onlinedocs/gcc/Link-Options.html
- GCC 目录选项(--sysroot):https://gcc.gnu.org/onlinedocs/gcc/Directory-Options.html
- GCC 开发者选项(-dumpmachine、-print-sysroot):https://gcc.gnu.org/onlinedocs/gcc/Developer-Options.html
- CMake cmake-toolchains(7):https://cmake.org/cmake/help/latest/manual/cmake-toolchains.7.html
评价 (0)