开始使用源代码和构建​本主题说明如何获取QGroundControl源代码，并以本机方式或在流浪汉环境。它还提供有关可选或操作系统特定功能的信息。

　　每日构建​如果你只是想测试 (而不是调试) 最近的构建QGroundControl您可以使用每日构建。为所有平台提供版本。

　　源代码​源代码QGroundControl保存在GitHub上:https://github.com/mavlink/qgroundcontrol。它是Apache 2.0和GPLv3双重授权。

　　要获取源文件:

　　克隆回购 (或你的叉)，包括子模块:

　　shgit clone --recursive -j8 https://github.com/mavlink/qgroundcontrol.git

　　更新子模块 (需要每次你拉新的源代码):

　　shgit submodule update --recursive

　　小费

　　无法使用Github源代码zip文件，因为这些文件不包含相应的子模块源代码。你必须使用git!

　　构建QGroundControl​使用容器​我们使用存储库源代码树上的容器支持Linux构建，该容器可以帮助您开发和部署QGC应用程序，而无需在本地环境中安装任何要求。

　　容器指南

　　本机版本​QGroundControlmacOS、Linux、Windows和Android支持内部版本。从理论上讲，为iOS创建QGC版本是可能的，但不再支持作为标准构建。QGroundControl用途Qt作为其跨平台支持库。

　　所需的Qt版本是6.8.3(仅)。

　　警告

　　不要使用任何其他版本的Qt!QGC已使用指定版本的Qt (6.8.3) 进行了全面测试。存在其他Qt版本注入影响稳定性和安全性的错误 (即使QGC编译) 的重大风险。

　　有关详细信息，请参见:Qt 6支持的平台列表。

　　安装Qt​你必须按如下所述安装Qt而不是使用来自Linux发行版的预构建包。

　　要安装Qt:

　　下载并运行Qt在线安装程序

　　Ubuntu:

　　使用以下方法将下载的文件设置为可执行文件:chmod +x。

　　您可能还需要安装libxcb-cursor0

　　在安装文件夹页面选择 "自定义安装"

　　在选择组件页面:

　　我你不明白Qt 6.8.3列出的检查存档复选框，然后单击过滤器。

　　在Qt -> 下Qt 6.8.3选择:

　　窗户: MSVC 2022拱门-在哪里拱门是你的机器的架构

　　Mac: 桌面

　　Linux: 桌面gcc 64位

　　Android: Android

　　全选额外的图书馆

　　取消选择QT Design Studio

　　安装其他软件包 (特定于平台)

　　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 设置。最新更新版本需要JDK17。NDK版本: 25.1.8937393您可以通过查看项目设置来确认它正在使用:项目> 管理工具包> 设备> Android (选项卡) > Android设置>JDK位置。注意: 请访问此处了解更多详细配置android.yml

　　安装可选/操作系统特定功能

　　信息

　　依赖于操作系统和用户安装的库的可选功能如下所述。这些功能可以通过指定额外的值来强制启用/禁用。

　　视频流/Gstreamer:-见视频流

　　安装Visual Studio (仅限Windows)​安装Visual Studio 2022社区版。

　　安装时，选择C ++ 桌面开发如图所示:

　　信息

　　Visual Studio仅用于获取编译器。建筑物QGroundControl是使用Qt创建者或C制造直接如下所述。

　　使用Qt Creator构建​发射Qt创建者,选择Open Project并选择CMakeLists.txt文件。

　　在配置项目页面应该默认为使用上面的指令安装的Qt版本。如果没有，请从列表中选择该套件，然后单击配置项目。

　　使用 "锤子" (或 "播放") 图标或菜单进行构建:

　　在CLI上使用cbuild​构建默认QGC并随后运行的示例命令:

　　确保之前克隆了存储库并更新了子模块，请参阅第章源代码上方并切换到存储库文件夹:

　　shcd qgroundcontrol

　　配置:

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

　　更改qt-cmaker的目录以匹配qt的安装位置和要使用的工具包。

　　构建

　　shcmake --build build --config Debug

　　运行刚刚构建的QGroundcontrol二进制文件:

　　sh./build/Debug/QGroundControl

　　流浪汉​流浪汉可用于构建和运行QGroundControl在Linux虚拟机中 (如果兼容，构建也可以在主机上运行)。

　　下载和安装流浪汉

　　从根目录的QGroundControl存储库运行vagrant up

　　要使用图形环境，请运行vagrant reload

　　所有受支持操作系统的其他构建说明​并行生成:对于非Windows版本，您可以使用-j#运行parellel构建的选项。

　　如果运行时出现此错误QGroundControl:/usr/lib/x86_64-linux-gnu/libstdc++.so.6: version 'GLIBCXX_3.4.20' not found.,您需要要么更新到最新的gcc,或安装最新的libstdc ++.6使用:sudo apt-get install libstdc++6。

　　单元测试:要运行单元测试,内置debug模式与QGC_UNITTEST_BUILD定义，然后复制deploy/qgroundcontrol-start.sh脚本到debug运行测试之前的目录。

　　构建QGC安装文件​您还可以创建安装文件 (s)QGroundControl作为正常构建过程的一部分。

　　shcmake --install . --config Release