下载和安装

TIP

These are daily build download links with the latest features. If you are looking for the last stable release, see the stable docs.

TIP

如果 QGroundControl 没有在安装后启动和正常运行，请参阅故障排除QGC配置！

系统配置要求

QGC可以在任何当下流行的计算机或移动设备上正常运行。 性能表现将取决于系统环境、第三方应用程序和当前系统可使用的资源状况。 性能更强的硬件将带来更好的体验。 一台拥有至少 8GB 内存、固态硬盘、Nvidia 或 AMD 显卡以及英特尔酷睿i5或更优CPU的电脑，将适用于大多数应用场景。

为了获得最好的体验和兼容性，我们推荐您使用最新版本的操作系统。

Windows 系统

Supported versions: Windows 10 (1809 or later), Windows 11:

1. Download the installer:
   • x86_64
   • Arm64
2. Double-click the executable to launch the installer.

INFO

Windows 安装程序创建 3 个快捷方式：QGroundControl，GPU 兼容模式，GPU 安全模式。 使用第一个快捷方式，除非您遇到启动或视频渲染问题。 更多信息请见QGC 设置故障排查 > Windows：用户界面渲染 / 视频驱动问题。

Mac OS

Supported versions: macOS 13 (Ventura) or later:

1. Download QGroundControl.dmg.
2. Double-click the .dmg file to mount it. In the window that opens, drag the QGroundControl icon onto the Applications folder shortcut shown next to it.

INFO

The download is a universal binary that runs natively on both Apple Silicon and Intel Macs. Official builds are signed and notarized, so no Gatekeeper security overrides are needed to run the app.

Ubuntu Linux 系统

Supported versions: Ubuntu 24.04 LTS, 26.04 LTS:

INFO

The AppImage downloads below run on Ubuntu 24.04 LTS and 26.04 LTS. If you need a version of QGroundControl that runs on Ubuntu 22.04, it is possible, but you have to build it yourself.

Ubuntu 自带一个串口调制解调器管理器，它会干扰串口（或 USB 转串口）在任何与机器人相关方面的使用。 在安装 QGroundControl 之前，您应该删除调制解调器管理器并授予自己访问串行端口的权限。

Before installing QGroundControl for the first time:

1. Enable serial-port access Add your user to the dialout group so you can talk to USB devices without root:

sudo usermod -aG dialout "$(id -un)"

INFO

At login, your shell takes a snapshot of your user and group memberships. Because you just changed groups, you need a fresh login shell to pick up “dialout” access. Logging out and back in reloads that snapshot, so you get the new permissions.

1. (Optional) Disable ModemManager On some Ubuntu-based systems, ModemManager can claim serial ports that QGC needs. If you don't use it elsewhere, mask or remove it.

# preferred: stop and mask the service
sudo systemctl mask --now ModemManager.service

# or, if you’d rather remove the package
sudo apt remove --purge modemmanager

1. On the command prompt, enter:

sudo apt install -y libfuse2 libxcb-xinerama0 libxkbcommon-x11-0 libxcb-cursor0

To install QGroundControl:

1. Download the AppImage for your architecture:

   • Linux x86_64
   • Linux aarch64

2. Make the AppImage executable

chmod +x QGroundControl-<arch>.AppImage

1. Run QGroundControl Either double-click the AppImage in your file manager or launch it from a terminal:

./QGroundControl-<arch>.AppImage

Android

Supported versions: Android 9 (API 28) or later (arm 32/64):

• Android APK

:::important The version of Qt used by QGroundControl requires Android 9 (API 28) as the minimum supported version. It is not possible to support older Android releases. This means that some integrated controllers running older versions of Android are no longer compatible with current builds of QGroundControl. QGroundControl 5.0 stable is the last release that supports these older devices. Note that 5.0 may not fully support firmware versions released after it, so users on older controllers may experience limited compatibility with newer autopilot firmware. :::

旧稳定版本

Old stable releases can be found on GitHub.