Hacking:Tools:QtCreator:Windows10: Difference between revisions

From Seamly
Content added Content deleted
(improve About section)
(Improve images)
Line 21: Line 21:


During installation you may accept the defaults for components to install, or you may select what you need but '''do not change any options for MinGW.''' . In this case I deselected all Qt versions except 5.8. Under the '''Tools''' section '''QtCreator''' is unselectable -- it will always be installed.
During installation you may accept the defaults for components to install, or you may select what you need but '''do not change any options for MinGW.''' . In this case I deselected all Qt versions except 5.8. Under the '''Tools''' section '''QtCreator''' is unselectable -- it will always be installed.
[[File:QtComponents.png|none|thumb|Installation components]]


== Confirm C++ compiler and qmake directories ==
== Confirm C++ compiler ==


Open Qt Creator and select '''Tools''' from the top bar menu. Select '''Options''' from the picklist. Select '''Build & Run''' from the left side menu.
Open Qt Creator and select '''Tools''' from the top bar menu. Select '''Options''' from the picklist. Select '''Build & Run''' from the left side menu.


Select the '''Compilers''' tab. Note the directory for the C++ compiler.<br />Select the '''Qt Version''' tab. Note the directory for qmake.
Select the '''Compilers''' tab.
[[File:QtProjectBuildSettings.png|none|thumb|800x800px|Confirm compiler was detected]]
The '''Auto-detected''' section should list the C++ compiler as '''MinGW 5.8.0 32bit2'''. Note the directory for the C++ compiler.<br />


== Confirm qmake ==
[[File:QtToolsOptionsBuild&Run.png|700x700px]]
Select the '''Qt Version''' tab.
== Confirm kit ==

Select the '''Kits''' tab. <br />The Auto-detected kit should be '''Desktop Qt 5.8 MinGW 32bit (default).'''
The '''Auto-detected''' section should list '''Qt 5.8.0 MinGW 32bit'''. Note the directory for qmake.
[[File:QtProjectBuildSettingsQMake.png|none|thumb|800x800px|Confirm qmake was detected]]
== Confirm compiler kit ==
Select the '''Kits''' tab. <br />The Auto-detected kit should be '''Desktop Qt 5.8 MinGW 32bit (default)'''. Note the directory for the compiler kit.
[[File:QtProjectBuildSettingsKit.png|none|thumb|800x800px|Confirm compiler kit was detected]]


== Configure the Valentina project ==
== Configure the Valentina project ==


Select the '''General''' tab.
Select the '''General''' tab.

In the Directory field, select the directory containing your local clone of Valentina, or if you have multiple Qt projects select the parent directory of your projects.<br />Check the '''Open Compile Output pane when building''' option, leave all other options at default settings.<br />Click '''Apply''' and '''OK''' to close the '''Tools/Options''' window.<br />
In the '''Directory''' field, select the directory containing your local clone of Valentina, or if you have multiple Qt projects select the parent directory of your projects.<br />Check the '''Open Compile Output pane when building''' option, leave all other options at default settings.<br />Click '''Apply''' and '''OK''' to close the '''Tools/Options''' window.
[[File:QtProjectBuildSettingsGeneral.png|alt=|none|thumb|800x800px|Select Valentina directory, check Open Compile Output pane when building]]
<br />

Click the green '''Welcome''' icon in the left side menu.
[[File:QtProjectWelcomeIcon.png|none|thumb|Select Welcome icon]]


Click '''Open Project''' button.<br />Select the '''Valentina''' file from your local clone of Valentina.<br />The '''Configure Project''' window opens. Click the '''Configure Project''' button.<br />Click on the '''Projects''' wrench icon in the left side menu.<br />
The '''Projects''' Window will appear, click the '''Open Project''' button, browse to your local clone of Valentina and select the '''Valentina''' file.<br />The '''Configure Project''' window opens, click the '''Configure Project''' button.<br />Click on the '''Projects''' wrench icon in the left side menu, then select the '''Build''' hammer icon to open the '''Build Settings''' options.
[[File:QtProjectBuildSettingsHammerIcon.png|none|thumb|420x420px|Select Projects, Build]]


Select the '''Build''' hammer icon to open the '''Build Settings''' options.
Next to '''Edit Build Configuration''', select '''Debug''' from the picklist.
[[File:QtProjectBuildSettingsEditBuildDebug.png|none|thumb|300x300px|Select Debug from picklist]]
Next to '''Edit Build Configuration''', select '''Debug''' from the picklist.<br />Click on the '''Details''' button for the '''Make''' instruction under '''Build Steps'''.<br />Enter '''-j2''' in the '''Make Arguments''' field to enable use of multiple processors.<br />Go back to '''Edit Build Configuration''', select '''Release''', and enter '''-j2''' in '''Make Arguments'''.<br />
<br />Click on the '''Details''' button for the '''Make''' section under '''Build Steps'''.<br />Enter '''-j2''' in the '''Make Arguments''' field to enable use of 2 processors (change this to match your system - don't use all your processors!).<br />
[[File:QtProjectBuildSettingsDebug.png|none|thumb|800x800px|Debug Build settings]]


Go back to '''Edit Build Configuration''', select '''Release''', and enter '''-j2''' in '''Make Arguments''' field of '''Make'''/'''Details''' section.
[[File:Projectbuildsettings.png|frameless|500x500px]]
[[File:QtProjectBuildSettingsEditBuildRelease.png|none|thumb|Select Release from picklist]]


Select the '''Run''' green triangle icon to open the '''Run Settings''' options.<br />Next to '''Run Configuration''' select '''valentina''' from the picklist.<br />
Select the '''Run''' green triangle icon to open the '''Run Settings''' options.
[[File:QtProjectBuildSettingsRunIcon.png|none|thumb|Select Run green triangle icon]]


Next to '''Run Configuration''' select '''valentina''' from the picklist.
[[File:QtProjectRunSettings.png|frameless|500x500px]]
[[File:QtProjectRunSettingsValentina.png|none|thumb|Select valentina from picklist]]


== Save configuration and build Valentina ==
== Save configuration and build Valentina ==


Select '''File''' from the main top bar menu and select '''Save All'''.
Select '''File''' from the main top bar menu and select '''Save All'''.
From the '''Build''' menu option, select '''Run qmake''' followed by '''Build Valentina'''.<br />Subsequent builds require '''Clean Project Valentina''', '''Run qmake''', '''Rebuild Project Valentina'''.<br />


From the '''Build''' menu, select '''Run qmake''' followed by '''Build Valentina'''.<br />Subsequent builds require '''Clean Project Valentina''', '''Run qmake''', '''Rebuild Project Valentina'''.
Now smile and relax, you're done!!!!!!!!!
[[File:QtBuildMenu.png|none|thumb|Build menu]]
<br />Now smile and relax, you're done!

Revision as of 04:58, 13 January 2017

About this page

This page contains steps to:

  • Install Qt 5.8 on 64-bit 4-processor desktop with Windows 10. Note that Qt 5.8 contains Qt Creator 4.2.0.
  • Confirm Qt installation of MinGW
  • Configure Valentina project with compiler build options for Release and Debug

Qt Framework and Qt Creator are built to work with 32-bit MinGW (Minimalist GNU C/C++ compiler for Windows).

Note: There are projects which have built Qt using the 64-bit MinGW compiler, but these don't seem to be kept up to date. And they may produce unexpected results for Valentina.

Install Qt 5.8

Create a Qt account at https://account.qt.io/, then login.

Go to https://www.qt.io/download-open-source/ and click on the Download button. The correct file to download for your operating system will be downloaded, in this case the file qt-unified-windows-x86-2.0.4-online was downloaded..

Open your Downloads folder, right click on the file, and select Run as administrator. Follow the install instructions.

During installation you may accept the defaults for components to install, or you may select what you need but do not change any options for MinGW. . In this case I deselected all Qt versions except 5.8. Under the Tools section QtCreator is unselectable -- it will always be installed.

Installation components

Confirm C++ compiler

Open Qt Creator and select Tools from the top bar menu. Select Options from the picklist. Select Build & Run from the left side menu.

Select the Compilers tab.

Confirm compiler was detected

The Auto-detected section should list the C++ compiler as MinGW 5.8.0 32bit2. Note the directory for the C++ compiler.

Confirm qmake

Select the Qt Version tab.

The Auto-detected section should list Qt 5.8.0 MinGW 32bit. Note the directory for qmake.

Confirm qmake was detected

Confirm compiler kit

Select the Kits tab.
The Auto-detected kit should be Desktop Qt 5.8 MinGW 32bit (default). Note the directory for the compiler kit.

Confirm compiler kit was detected

Configure the Valentina project

Select the General tab.

In the Directory field, select the directory containing your local clone of Valentina, or if you have multiple Qt projects select the parent directory of your projects.
Check the Open Compile Output pane when building option, leave all other options at default settings.
Click Apply and OK to close the Tools/Options window.

Select Valentina directory, check Open Compile Output pane when building


Click the green Welcome icon in the left side menu.

Select Welcome icon

The Projects Window will appear, click the Open Project button, browse to your local clone of Valentina and select the Valentina file.
The Configure Project window opens, click the Configure Project button.
Click on the Projects wrench icon in the left side menu, then select the Build hammer icon to open the Build Settings options.

Select Projects, Build

Next to Edit Build Configuration, select Debug from the picklist.

Select Debug from picklist


Click on the Details button for the Make section under Build Steps.
Enter -j2 in the Make Arguments field to enable use of 2 processors (change this to match your system - don't use all your processors!).

Debug Build settings

Go back to Edit Build Configuration, select Release, and enter -j2 in Make Arguments field of Make/Details section.

Select Release from picklist

Select the Run green triangle icon to open the Run Settings options.

Select Run green triangle icon

Next to Run Configuration select valentina from the picklist.

Select valentina from picklist

Save configuration and build Valentina

Select File from the main top bar menu and select Save All.

From the Build menu, select Run qmake followed by Build Valentina.
Subsequent builds require Clean Project Valentina, Run qmake, Rebuild Project Valentina.

Build menu


Now smile and relax, you're done!