testdiff2/SpiriQGC/custom
kebab d5db18cf96 finalized 2023-12-21 08:03:49 -05:00
..
android/res finalized 2023-12-21 08:03:49 -05:00
deploy finalized 2023-12-21 08:03:49 -05:00
res finalized 2023-12-21 08:03:49 -05:00
src finalized 2023-12-21 08:03:49 -05:00
InstrumentValueIcons.qrc finalized 2023-12-21 08:03:49 -05:00
README.jpg finalized 2023-12-21 08:03:49 -05:00
README.md finalized 2023-12-21 08:03:49 -05:00
custom.pri finalized 2023-12-21 08:03:49 -05:00
custom.qrc finalized 2023-12-21 08:03:49 -05:00
custom_deploy.pri finalized 2023-12-21 08:03:49 -05:00
qgcresources.exclusion finalized 2023-12-21 08:03:49 -05:00
qgcresources.qrc finalized 2023-12-21 08:03:49 -05:00
qgroundcontrol.exclusion finalized 2023-12-21 08:03:49 -05:00
qgroundcontrol.qrc finalized 2023-12-21 08:03:49 -05:00
updateinstrumentqrc.py finalized 2023-12-21 08:03:49 -05:00
updateqrc.py finalized 2023-12-21 08:03:49 -05:00

README.md

QGroundControl Ground Control Station

Custom Build Example

To build this sample custom version:

  • Clean you build directory of any previous build
  • Rename the directory from custom-example to custom
  • Change to the custom directory
  • Run python updateqrc.py
  • Build QGC

Custom Build Screenshot

More details on what a custom build is and how to create your own can be found in the QGC Dev Guide.

The main features of this example:

  • Assumes an "Off The Shelf" purchased commercial vehicle. This means most vehicle setup is hidden from the user since they should mostly never need to adjust those things. They would be set up correctly by the vehicle producing company prior to sale.
  • The above assumption cause the QGC UI to adjust and not show various things. Providing an even simpler experience to the user.
  • The full experience continues to be available in "Advanced Mode".
  • Brands the build with various custom images and custom color palette which matches corporate branding of the theoretical commercial company this build is for.
  • Customizes portions of the interface such as you can see in the above screenshot which shows a custom instrument widget replacing the standard QGC ui.
  • It also overrides various QGC Application settings to hide some settings the users shouldn't modify as well as adjusting defaults for others.
  • The source code is fully commented to explain what and why it is doing things.

Important Note: This custom build is not automatically built each time regular QGC code changes. This can mean that it may fall out of date with the latest changes in QGC code. This can show up as the python updateqrc.py steps failing due to upstream resource changes. Or possibly fail to compile because the plugin mechanism for custom builds has changed. If this happens please notify the QGC devs and they will bring it up to date. Or even better, submit a pull for the fix yourself!