QGroundControl开发环境搭建指南

QGroundControl开发环境搭建指南

qgroundcontrol Cross-platform ground control station for drones (Android, iOS, Mac OS, Linux, Windows) 项目地址: https://gitcode.com/gh_mirrors/qg/qgroundcontrol

前言

QGroundControl是一款功能强大的地面站软件，广泛应用于无人机系统开发和管理。本文将详细介绍如何搭建QGroundControl的开发环境，包括获取源代码、配置构建环境以及编译运行等完整流程。

开发环境准备

获取源代码

QGroundControl采用Git进行版本控制，获取源代码的正确方式是使用Git克隆仓库：

git clone --recursive -j8 仓库地址

克隆完成后，每次更新代码后都需要同步子模块：

git submodule update --recursive

Qt环境配置

QGroundControl基于Qt框架开发，必须使用特定版本的Qt（当前为6.8.3）。安装Qt时需要注意：

1. 从官网下载在线安装器
2. 选择自定义安装
3. 根据平台选择对应组件：
   • Windows：MSVC 2022对应架构版本
   • Mac：Desktop版本
   • Linux：Desktop gcc 64位版本
   • Android：Android版本

重要提示：不要使用其他版本的Qt，这可能导致稳定性问题。

平台特定配置

Windows平台

需要额外安装Visual Studio 2022 Community Edition，选择"Desktop development with C++"组件。注意VS仅用于提供编译器，实际构建仍使用Qt Creator或CMake。

Linux平台

不同发行版需要安装的依赖有所不同：

• Ubuntu/Debian：

  sudo bash ./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 tools/setup/macos-dependencies.sh

Android平台

需要配置JDK17和NDK（版本25.1.8937393），具体可参考Qt官方文档中的Android开发指南。

构建QGroundControl

使用Qt Creator构建

1. 打开Qt Creator，选择项目中的CMakeLists.txt文件
2. 选择之前安装的Qt版本对应的构建套件
3. 点击构建或运行按钮

使用命令行构建

1. 配置项目：

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

2. 执行构建：

   cmake --build build --config Debug
   

3. 运行程序：

   ./build/Debug/QGroundControl
   

高级构建选项

• 并行构建：在非Windows平台上可使用-j#参数加速构建
• 单元测试：在Debug模式下构建时添加QGC_UNITTEST_BUILD定义
• 安装包构建：使用cmake --install命令生成安装文件

常见问题解决

1. GLIBCXX版本问题：

   sudo apt-get install libstdc++6
   

2. 视频流支持：需要单独配置GStreamer
3. 跨平台兼容性问题：确保使用指定版本的Qt

容器化构建方案

QGroundControl提供了基于容器的Linux构建方案，可以避免在本地安装各种依赖。这种方式特别适合需要干净构建环境的开发者。

总结

本文详细介绍了QGroundControl开发环境的搭建过程。正确配置开发环境是进行QGroundControl二次开发的基础，建议开发者严格按照指南操作，特别是Qt版本的选择和平台特定依赖的安装。对于初学者，推荐从Qt Creator开始，逐步熟悉整个构建流程。

qgroundcontrol Cross-platform ground control station for drones (Android, iOS, Mac OS, Linux, Windows) 项目地址: https://gitcode.com/gh_mirrors/qg/qgroundcontrol