Qt Setup
We use Qt for much of our C++ development. This page describe how to set up Qt creator and the Maria Qt projects to build correctly and produce output that can be used from Visual Studio and our managed projects.
Download and setup
Download the newest Open Source version of Qt from
Click through the Open Source information page and select the "Qt Online installer" option.
The installer will present a registration page, but you can safely skip this.
Select the correct Qt release (5.12 as of october 2019) with the following options:
- Include both 64- and 32-bit versions for MSVC 2017
- Do not include the MinGW build system.
- Include Sources
- Include Qt Debug information files
Under Developer and Designer Tools include:
- Qt Cretor CDB Debugger support
- Debuggging tools for Windows
Setting up the Maria Qt project
Start Qt Creator and open the Maria.pro from MariaGDK/Native folder. You should now see all the native libraries that are used by Maria 2D and 3D.
We want our locally compiled libraries to take precedence over the libraries we get from git. This is solved by setting our build directories to the following pattern:
MariaGDK\Native\build\VS_<version>_<Platform>_<Configuration>
To do this, click the "Projects" icon on the left hand side and change the Build directory option for each configuration (Debug/Release) and each Qt version (Desktop Qt 5.12 MSVC2017 64bit/32bit) as follows:
| Qt Version | Config | Build directory |
|---|---|---|
| 64-bit | Debug | <git path>\MariaGDK\Native\build\VS2017_x64_Debug |
| 32-bit | Debug | <git path>\MariaGDK\Native\build\VS2017_Win32_Debug |
| 64-bit | Release | <git path>\MariaGDK\Native\build\VS2017_x64_Release |
| 32-bit | Release | <git path>\MariaGDK\Native\build\VS2017_Win32_Release |
Make sure that "Shadow Build" is enabled