1. 为什么要在树莓派4B上手动编译ROS2 Humble?
如果你手头有一块树莓派4B,并且刚刚给它装上了最新的Debian 12(代号Bookworm)系统,想用它来跑机器人应用,那么ROS2大概率是你的首选框架。官方的二进制安装包虽然方便,但在树莓派这种ARM架构的设备上,特别是面对Debian 12这种较新的发行版时,经常会遇到依赖库版本不匹配、预编译包缺失或者架构不兼容的问题。我试过直接apt install,结果不是这个库找不到,就是那个库版本太高,编译好的节点一跑就崩溃。
所以,手动编译就成了最靠谱、也是最能学到东西的路子。这个过程就像是自己从头到尾组装一台精密仪器,虽然步骤繁琐,但你能清楚地知道每一个零件(依赖库)是怎么装上去的,系统是怎么构建起来的。一旦成功,这套ROS2环境就和你的树莓派4B、你的Debian 12系统深度绑定了,稳定性会好很多。更重要的是,在资源有限的边缘设备上,你可以通过编译选项去掉一些用不上的功能(比如一些复杂的GUI工具),让ROS2运行得更轻快。接下来,我就带你走一遍我从依赖解决到实战测试的全过程,把踩过的坑和找到的捷径都分享给你。
2. 编译前的系统准备与依赖大作战
在动手编译ROS2 Humble之前,我们必须把树莓派4B的Debian 12系统基础打好。这一步看似简单,却是后续所有操作的地基,地基不稳,楼盖到一半就得塌。
2.1 基础工具链安装
首先,更新系统并安装最核心的编译工具。打开终端,执行以下命令:
sudo apt update && sudo apt upgrade -y
sudo apt install -y git cmake build-essential
git用于拉取源码,cmake是ROS2构建系统的核心,build-essential则包含了GCC、G++、make等一整套编译工具。这些通常不会有什么问题。
接下来是Python环境。ROS2 Humble主要依赖Python 3.10+,Debian 12默认的Python 3.11是完美匹配的。我们需要的是pip3和一些基础Python工具:
sudo apt install -y python3-pip python3-venv python3-dev
安装完pip3后,我强烈建议你先升级一下pip本身,并用国内镜像源来加速后续的包安装,这能避免大量网络超时错误:
pip3 install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
2.2 解决Python依赖的“钉子户”
根据原始文章的经验,有几个Python包是“钉子户”,容易出问题。我们按顺序来攻克。
首先是setuptools。有时候系统自带的版本太旧,会导致安装其他包(如gnupg)失败。如果遇到相关错误,别慌,手动安装一个较新版本即可:
# 如果安装gnupg等包时报setuptools错误,执行以下步骤
wget https://pypi.python.org/packages/source/s/setuptools/setuptools-69.1.1.tar.gz
tar -zxvf setuptools-69.1.1.tar.gz
cd setuptools-69.1.1/
python3 setup.py build
sudo python3 setup.py install
然后,我们批量安装那些关键的Python包。这里我结合原始文章和自身经验,整理了一个更稳定的安装列表,并使用国内镜像源:
sudo pip3 install defusedxml rospkg netifaces empy==3.3.2 -i https://mirror.baidu.com/pypi/simple
sudo pip3 install pycryptodomex wheel sip gnupg -i https://mirror.baidu.com/pypi/simple
注意:安装过程中如果出现ReadTimeoutError: HTTPSConnectionPool...这类网络超时错误,这是正常的,因为网络波动或者镜像源暂时不稳定。最简单的办法就是重试命令,多试一两次通常就能成功。安装gnupg时如果还报setuptools错,那就再执行一次上面手动安装s
4501



被折叠的 条评论
为什么被折叠?



