Compile instructions (Windows - QtCreator, MSVC 2017) -- WIP

Updated 6 days ago

This page is instructions for how to use the MSVC compiler inside the QtCreator IDE.

Getting the MSVC 2017 compiler

Microsoft makes their build tools available separately, outside of the Visual Studio IDE. As of MS Visual Studio 2017, however, the same installer is used for the IDE as well as the stand-alone build tools. The first step is therefore to download Visual Studio community. This will download the installer.

When you run the installer for the first time, choose the "Install" option below Visual Studio community. This will take you to a page looking something like this:

VS_Install_01.PNG

Select the "Individual components" tab and scroll down to the "Compilers, build tools, and runtimes" heading. Select the latest VC++ 2017 tools and the Visual C++ tools for CMake.

MSVS_compiler_build_tools.PNG

Scroll down to the bottom of the page and select the latest Windows 10 SDK.

VS_Win10_SDK.PNG

Note: Install the Windows 10 SDK, even if you are on a different version of Windows. The Windows 10 SDK can target older versions of Windows, but not vice versa.

You should now have the following components selected in the pane on the right hand side of the window:

VS_Installation_Details.PNG

Click the "Install" button in the lower right of the window.

Getting the CDB debugger

The Windows 10 SDK offered with the Visual Studio installer does not include debugging tools for Windows. To get the CDB debugger for Windows, you need to install it separately. Go to Control Panel => Programs => Programs and features and search for Windows Software Development Kit in the list of programs. Right click on it and select Change. Select Change in the window that pops up and click Next. You should see this screen:

Windows_SDK.PNG

Select the "Debugging Tools for Windows" option and click Change.

Getting QtCreator and the Qt libraries

If you don't have Qt already installed, you need to get the Qt Online Installer for Windows and install it. Else you can skip to the next section.

You must install the following components:

  • The latest Qt 5.12 libraries for MSVC 2017. (Ensure that you install the 32-bit libraries on a 32-bit Windows OS. On a 64-bit OS, you can install only the 64-bit libraries, or, if you want to build and test 32-bit builds, both the 32-bit and 64-bit libraries.)
  • The Qt 5.12 WebEngine component.

Setting up QtCreator

If you have QtCreator already installed, you need to ensure that you have the right components installed to work with MSVC 2017 and CDB. To verify that you have the correct components installed, start the Qt Maintenance Tool, found in your Qt installation folder (usually C:\Qt). Choose to add or remove components.

Getting the Qt 5.12 libraries for MSVC

Verify that you have all the components listed here selected. Then go on to the next section

Getting CDB support for QtCreator

Select "CDB support for QtCreator" in the Tools section. Click Next.

Re-run the Maintenance Tool and select the option to "Update components" to ensure that your QtCreator version matches the CDB support extension version.

Getting the dependencies

Download dependencies.7z and extract the contents into the base directory. (This will create a new dependencies folder in that base directory.)

Setting up the project