QGroundControl_CMake_Qt_version

Hello QGroundControl documentation maintainers,

While building QGroundControl on Windows, I noticed a mismatch between the documentation and the current build requirements.

The documentation states that Qt 6.8.3 (only) should be used and strongly warns against other Qt versions. However, the current master branch CMakeLists.txt requires Qt 6.10.0–6.10.1, and the project fails to configure when using Qt 6.8.3.

This caused some confusion during setup, as following the documented Qt version leads to CMake configuration errors on the master branch.

It might help new contributors if the documentation clearly distinguishes between:

  • Stable/release builds (Qt 6.8.3)

  • Master/development branch (Qt 6.10.x)

A short note clarifying this would likely save time for developers setting up the project.

Thank you for your work on QGroundControl.

Best regards,
Muhammad Ali

Thanks for the note @Muhammad_Ali_dev.

The documentation might reference the last stable release while the master branch has moved along.

Generally, whatever runs in a branch in CI is the source of truth.

FYI for when you’re back: @hamishwillee

Thanks @JulianOes - I’m not really back, just dropping in.

@Muhammad_Ali_dev The docs for mainline (master branch) state 6.10.1 in Getting Started with Source and Builds | QGC Guide . The docs for v5 Getting Started with Source and Builds | QGC Guide (v5.0) do state 6.8.3.

So it is as Julian says, you’re building master but looking at the release docs.

Not sure what to do about this. The default docs version is master, which matches the default branch. For other versions the docs version is listed in the top left of the documentation.

@DonLakeFlyer FYI

1 Like