Ubuntu 20.04 环境下 QGroundControl 安装指南
在 Ubuntu 20.04 上运行 QGroundControl (QGC) 需要配置好依赖环境,特别是串口通信和图形库支持。以下是基于官方文档整理的实战步骤。
1. 准备依赖环境
首先确保当前用户有串口权限,并移除可能冲突的调制解调器管理器。接着安装必要的 GStreamer 插件和 X11 相关库。
sudo usermod -a -G dialout $USER
sudo apt-get remove modemmanager -y
sudo apt install gstreamer1.0-plugins-bad gstreamer1.0-libav gstreamer1.0-gl -y
sudo apt install libfuse2 -y
sudo apt install libxcb-xinerama0 libxkbcommon-x11-0 libxcb-cursor0 -y
执行完上述命令后,建议重新登录或重启终端使权限生效。
2. 获取安装包
推荐直接访问 QGroundControl 官网下载最新版 AppImage 文件,避免第三方渠道的版本风险: QGroundControl 官方下载页面
下载完成后,将文件名统一为标准的 QGroundControl.AppImage(注意大小写),方便后续调用:
mv ~/Downloads/QGroundControl.appimage ~/Downloads/QGroundControl.AppImage
3. 启动程序
进入下载目录,赋予执行权限并运行:
cd ~/Downloads
chmod +x QGroundControl.AppImage
./QGroundControl.AppImage
4. 常见问题处理
如果启动后地图显示为空白,通常是因为网络原因导致离线地图数据无法自动下载。此时可以手动清理缓存并替换为本地数据包。
先删除旧的缓存目录:
rm -rf ~/.cache/QGCMapCache300
然后将准备好的地图缓存文件夹复制到该路径下即可正常运行。如果是初次遇到此问题,建议检查网络连接或使用代理工具加速地图瓦片加载。

