Raspberry Pi Imager 在 Apple Silicon 上的编译问题解析

问题背景

在 macOS Silicon（即 Apple M 系列芯片）设备上编译 Raspberry Pi Imager 项目时，开发者可能会遇到一个典型的架构兼容性问题。错误信息显示链接器无法找到 x86_64 架构所需的符号，而系统上安装的库却是 arm64 架构版本。

错误现象

编译过程中会出现以下关键错误信息：

ld: warning: ignoring file '/opt/homebrew/Cellar/libnghttp2/1.65.0/lib/libnghttp2.dylib': found architecture 'arm64', required architecture 'x86_64'
Undefined symbols for architecture x86_64:

这表明编译系统正在尝试构建 x86_64 架构的二进制文件，但 Homebrew 为 Apple Silicon 安装的是 arm64 架构的依赖库。

根本原因

这个问题源于两个关键因素：

1. 跨架构编译需求：Raspberry Pi Imager 默认配置为构建通用二进制（Universal Binary），即同时包含 x86_64 和 arm64 架构的代码。

2. 依赖管理：项目依赖的 nghttp2 库在系统中只有 arm64 版本可用，缺少 x86_64 版本的支持。

解决方案

针对这一问题，开发者有以下几种解决途径：

方案一：单架构编译

对于本地开发和测试，最简单的解决方案是修改 CMake 配置，仅针对主机架构进行编译。这可以通过调整 CMake 环境变量来实现，避免跨架构编译的需求。

方案二：更新项目版本

较新版本的 Raspberry Pi Imager 已经改进了依赖管理方式：

• 使用 FetchContent 机制自动获取和构建依赖项
• 在 macOS 构建时会自动为两种架构（arm64 和 x86_64）构建依赖库
• 避免了对外部系统库的依赖

方案三：手动安装多架构依赖

对于需要保留通用二进制支持的情况，开发者可以：

1. 确保 Homebrew 安装了多架构版本的依赖库
2. 或者手动编译安装 x86_64 版本的依赖项

技术建议

对于 Apple Silicon 用户，建议：

1. 使用最新版本的 Raspberry Pi Imager 源代码，它已经优化了依赖管理
2. 如果必须使用旧版本，优先考虑单架构编译方案
3. 了解 macOS 的通用二进制机制和 Rosetta 2 转译技术，有助于理解这类架构兼容性问题

总结

在 Apple Silicon 设备上开发跨平台应用时，架构兼容性是需要特别注意的问题。Raspberry Pi Imager 项目已经通过改进构建系统解决了这一问题，开发者只需确保使用最新代码并正确配置构建环境即可避免此类错误。