Getting Started with Source and Builds

本主题说明如何获取QGroundControl源代码并在本机或在Vagrant(虚拟机)环境中构建它。 本主题还提供其他可选功能信息及特定于操作系统的功能信息。 It also provides information about optional or OS specific functionality.

每日构建

If you just want to test (and not debug) a recent build of QGroundControl you can use the Daily Build. Versions are provided for all platforms.

源代码

QGroundControl 的源代码保存在 github 上，下载地址为: https://github.com/mavlink/qgroundcontrol。 QGroundControl源代码在Apache 2.0和GPLv3下是双许可的。 有关更多信息，请参阅：许可证。 It is dual-licensed under Apache 2.0 and GPLv3.

要获取源文件, 请执行以下操作:

1. Clone the repo (or your fork) including submodules:

克隆存储库 (或您的分叉), 包括子模块: `git clone --recursive -j8 https://github.com/mavlink/qgroundcontrol.git`

2. Update submodules (required each time you pull new source code):

2.更新子模块（每次拉新源代码时都这样做）： `git submodule update --recursive`

TIP

提示：不能使用Github以zip形式下载源文件，因为zip压缩包中不包含相应的子模块源代码。 你必须使用git工具！ You must use git!

构建QGroundControl开发环境

Using Containers

We support Linux builds using a container found on the source tree of the repository, which can help you develop and deploy the QGC apps without having to install any of the requirements on your local environment.

Container Guide

Native Builds

QGroundControl builds are supported for macOS, Linux, Windows, and Android. Creating a version of QGC for iOS is theoretically possible but is no longer supported as a standard build. QGroundControl uses Qt as its cross-platform support library.

The required version of Qt is 6.8.3 (only).

WARNING

Do not use any other version of Qt! QGC has been thoroughly tested with the specified version of Qt (6.8.3). There is a significant risk that other Qt versions will inject bugs that affect stability and safety (even if QGC compiles).

For more information see: Qt 6 supported platform list.

安装Qt

You must install Qt as described below instead of using pre-built packages from say, a Linux distribution.

To install Qt:

1. Download and run the Qt Online Installer

• Ubuntu:
  • 使用以下命令将下载的文件设置为可执行文件：chmod + x
  • You may also need to install libxcb-cursor0

2. On the Installation Folder page select "Custom Installation"

3. On the Select Components page:

• I you don't see Qt 6.8.3 listed check the Archive checkbox and click Filter.

• Under Qt -> Qt 6.8.3 select:

  • Windows: MSVC 2022 arch - where arch is the architecture of your machine
  • Mac: Desktop
  • Linux: Desktop gcc 64-bit
  • Android: Android

• Select all Additional Libraries

• Deselect QT Design Studio

1. Install Additional Packages (Platform Specific)

• Ubuntu: sudo bash ./qgroundcontrol/tools/setup/install-dependencies-debian.sh
• Fedora: sudo dnf install speech-dispatcher SDL2-devel SDL2 systemd-devel patchelf
• Arch Linux: pacman -Sy speech-dispatcher patchelf
• Mac sh qgroundcontrol/tools/setup/macos-dependencies.sh
• Android Setup. JDK17 is required for the latest updated versions. NDK Version: 25.1.8937393 You can confirm it is being used by reviewing the project setting: Projects > Manage Kits > Devices > Android (tab) > Android Settings > JDK location. Note: Visit here for more detailed configurations android.yml

2. Install Optional/OS-Specific Functionality

Optional features that are dependent on the operating system and user-installed libraries are linked/described below. These features can be forcibly enabled/disabled by specifying additional values to qmake. :::

• Video Streaming/Gstreamer: - see Video Streaming

Install Visual Studio (Windows Only)

Install Visual Studio 2022 Community Edition.

When installing, select Desktop development with C++ as shown:

INFO

Visual Studio is ONLY used to get the compiler. Building QGroundControl is done using Qt Creator or cmake directly as outlined below.

Building using Qt Creator

1. Launch Qt Creator, select Open Project and select the CMakeLists.txt file.

2. On the Configure Project page it should default to the version of Qt you just installed using the instruction above. If not select that kit from the list and click Configure Project.

3. Build using the "hammer" (or "play") icons or the menus:

Build using CMake on CLI

Example commands to build a default QGC and run it afterwards:

1. Make sure you cloned the repository and updated the submodules before, see chapter Source Code above and switch into the repository folder: cd qgroundcontrol

cd qgroundcontrol

2. Configure:

~/Qt/6.8.3/gcc_64/bin/qt-cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug

Change the directory for qt-cmake to match your install location for Qt and the kit you want to use.

3. Build

cmake --build build --config Debug

4. Run the QGroundcontrol binary that was just built: ./staging/QGroundControl

./build/Debug/QGroundControl

Vagrant

Vagrant can be used to build and run QGroundControl within a Linux virtual machine (the build can also be run on the host machine if it is compatible).

1. Download and Install Vagrant
2. From the root directory of the QGroundControl repository run vagrant up
3. To use the graphical environment run vagrant reload

Additional Build Notes for all Supported OS

• Parallel builds: For non Windows builds, you can use the -j# option to run parellel builds.
• If you get this error when running QGroundControl: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version 'GLIBCXX_3.4.20' not found., you need to either update to the latest gcc, or install the latest libstdc++.6 using: sudo apt-get install libstdc++6.
• Unit tests: To run the unit tests, build in debug mode with QGC_UNITTEST_BUILD definition, and then copy deploy/qgroundcontrol-start.sh script into the debug directory before running the tests.

Building QGC Installation Files

You can additionally create installation file(s) for QGroundControl as part of the normal build process.

cmake --install . --config Release