问题：如何在Ubuntu系统中安装和配置QGC（QGroundControl）？

Question

**问题：** 如何在Ubuntu系统中安装和配置QGroundControl（QGC），并解决常见依赖或运行问题？

Answer 1

如何在Ubuntu系统中安装和配置QGroundControl（QGC），并解决常见依赖或运行问题？

1. 环境准备与系统要求

在开始安装QGroundControl之前，确保你的Ubuntu系统满足以下最低要求：

• Ubuntu 20.04 LTS 或更高版本
• 至少 4GB 内存
• 至少 5GB 可用磁盘空间
• 支持 OpenGL 3.3 或更高版本的显卡驱动

2. 安装方式选择

QGroundControl 支持多种安装方式，包括：

1. 从官方AppImage文件安装
2. 通过源码编译安装
3. 使用Snap安装（适用于部分Ubuntu版本）

推荐使用AppImage方式，因为它无需root权限，且安装简单。

3. 使用AppImage安装QGroundControl

步骤如下：

wget https://d171o61g2zq69n.cloudfront.net/QGroundControl.AppImage
chmod +x QGroundControl.AppImage
./QGroundControl.AppImage
    

如果遇到无法运行的情况，可能是缺少依赖库，下一节将详细说明。

4. 常见依赖问题及解决方法

运行QGC时可能出现如下错误：

• “Failed to load platform plugin 'xcb'”
• “Could not find the Qt platform plugin 'xcb'”
• “libGL error: unable to load driver”

解决方法如下：

问题	解决方案
Qt平台插件缺失	安装Qt5默认插件：sudo apt install qt5-qmake qt5-default
libGL加载失败	安装Mesa驱动：sudo apt install libgl1-mesa-glx

5. 使用源码编译安装QGroundControl

如果你需要定制化功能或参与开发，建议从源码安装：

sudo apt-get update
sudo apt-get install build-essential libqt5gui5 qt5-qmake
git clone https://github.com/mavlink/qgroundcontrol.git
cd qgroundcontrol
git checkout stable
qmake
make -j$(nproc)
./QGroundControl
    

编译过程中可能需要根据提示安装更多Qt模块，如libqt5serialport5-dev等。

6. 运行时问题排查流程图

graph TD
    A[启动QGC失败] --> B{是否为AppImage方式?}
    B -->|是| C[检查依赖库是否完整]
    B -->|否| D[检查Qt模块是否安装]
    C --> E[安装libgl1-mesa-glx]
    D --> F[安装qt5-qmake qt5-default]
    E --> G[重新运行QGC]
    F --> G
    G --> H{是否成功启动?}
    H -->|是| I[完成]
    H -->|否| J[查看日志文件]
        

7. 配置QGroundControl连接无人机

配置步骤如下：

1. 启动QGC后，点击“设置” -> “Comm Links”
2. 添加一个新的连接，选择“MAVLink Serial”或“MAVLink UDP”
3. 设置波特率（默认57600）或IP地址和端口
4. 点击“Connect”开始连接无人机

如果无法连接，请检查串口权限：

sudo usermod -a -G dialout $USER

然后重新登录系统。

8. 常见问题汇总与解决建议

• QGC启动时崩溃：尝试更新显卡驱动或使用软件渲染模式。
• 无法识别飞控设备：检查串口连接和波特率设置。
• 地图加载失败：检查网络连接或配置代理。
• 无法更新固件：确保使用管理员权限运行QGC。