说明:
Qt Creator 5.15 的官方二进制版本是基于 glibc 2.31 编译的,与 Ubuntu 20.04 系统完全兼容。同时,ROS Industrial 插件的 0.4.x 及 5.0 系列也依赖于相同版本的 glibc。因此,只要版本匹配,安装过程可以一次性顺利完成。
以下是在 Ubuntu 20.04 上实测有效的完整配置流程(已验证,约 10 分钟内完成)。
1. 快速安装步骤(适用于 Ubuntu 20.04)
安装 ROS Noetic(若已安装可跳过此步):
sudo apt update
sudo apt install ros-noetic-desktop-full python3-catkin-tools
2. 获取 Qt 5.14 离线安装包(包含 Qt Creator 5.14)
目前 Qt 官方主推在线安装方式,但会自动跳转至 Qt 6.10 或更高版本,不适用于当前需求。
建议使用离线安装包以避免版本错配问题。
推荐获取方式:
下载地址:https://pan.quark.cn/s/a7c3ee933f10#/list/share/35b723f187854fba9bb8b6128e43bbac
文件名:qt-opensource-linux-x64-5.14.2.run
下载后赋予执行权限并运行即可完成安装。
chmod +x qt-opensource-linux-x64-5.14.2.run
./qt-opensource-linux-x64-5.14.2.run
[此处为图片1]
替代方案:也可下载源码包
qt-everywhere-opensource-src-5.15.12.zip,通过编译方式进行安装(具体操作请自行查阅资料)。
3. 安装 ROS 插件
安装插件所需依赖库:
sudo apt install libgl1-mesa-dev ninja-build libyaml-cpp-dev libqtermwidget5-0-dev
克隆 ROS Industrial 插件仓库,并切换至 5.0 分支:
git clone https://github.com/ros-industrial/ros_qtc_plugin -b 5.0
cd ros_qtc_plugin
python3 setup.py --qtcreator_path ~/Qt/Tools/QtCreator --install_path ~/Qt
4. 插件文件拷贝与环境配置
将生成的插件文件复制到 Qt Creator 的插件目录中:
cp -r ROSProjectManager-5.0-Linux-x86_64/* ~/Qt/Tools/QtCreator/lib/qtcreator/plugins/
确保每次启动终端时自动加载 ROS 环境:
echo 'source /opt/ros/noetic/setup.bash' >> ~/.bashrc
[此处为图片2]
5. 启动并验证安装结果
启动 Qt Creator:
~/Qt/Tools/QtCreator/bin/qtcreator
进入软件后进行验证:
- 菜单栏选择 Help → About Plugins,确认 "ROS Project Manager" 已被勾选;
- 创建新项目时(New Project),应能看到 “ROS Workspace” 模板出现,表示安装成功。
6. 常见问题与注意事项
- 避免使用 10.x 或 18.x 版本的插件,这些版本要求 glibc 2.32 及以上,而在 Ubuntu 20.04 上会导致加载失败。
- 若第 3 步中插件下载缓慢,可手动下载
ROSProjectManager-5.0-Linux-x86_64.zip 并解压至
~/Qt/Tools/QtCreator 的同级目录下。
- 日后升级 Qt Creator 至小版本(如 5.15.x)通常不影响使用;但升级至大版本(如 6.x)需重新运行安装脚本或切换对应插件分支。
完成上述步骤后,您将获得一个原生集成的 Qt Creator 5.15 与 ROS 插件组合,可在 Ubuntu 20.04 系统中图形化地创建、调试、构建 catkin_make 或 colcon 类型的 ROS 工作空间。
7. 替代方案:快速部署(“邪修”方法)
由于部分资源受限或网络封锁,常规方法可能失败。
若上述流程过于繁琐或无法成功,可采用以下简化方式快速部署:
sudo snap install qtcreator-ros --classic
该方式绕过复杂依赖配置,直接安装预集成 ROS 支持的 Qt Creator 版本,适合希望快速上手、减少调试时间的用户。
[此处为图片3]