Qt wiki will be updated on October 12th 2023 starting at 11:30 AM (EEST) and the maintenance will last around 2-3 hours. During the maintenance the site will be unavailable.

Visual Studio Add-in: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
(Added a short introduction about Qt VS Tools.)
Line 4: Line 4:
'''French translators see also:''' http://qt-devnet.developpez.com/tutoriels/add-in-visual-studio/compiler/
'''French translators see also:''' http://qt-devnet.developpez.com/tutoriels/add-in-visual-studio/compiler/


= Qt Visual Studio Tools =
=Qt Visual Studio Tools=
The Qt Visual Studio Tools integrate the Qt development tools into Microsoft Visual Studio. This enables developers to use the standard Windows development environment without having to worry about Qt-related build steps or tools.


=== Get the sources ===
===Get the sources===


Use Git to check out the Qt Visual Studio Tools sources that are hosted at: http://code.qt.io/cgit/qt-labs/vstools.git
Use Git to check out the Qt Visual Studio Tools sources that are hosted at: http://code.qt.io/cgit/qt-labs/vstools.git


To create a repository clone, execute the following command:
To create a repository clone, execute one of the following commands:


<code lang="bash">git clone git://code.qt.io/qt-labs/vstools.git</code>
<code lang="bash">git clone git://code.qt.io/qt-labs/vstools.git</code>


=== Build a static Qt ===
git clone <nowiki>https://code.qt.io/qt-labs/vstools.git</nowiki>
 
===Build a static Qt===


Building the Qt Visual Studio Tools from sources requires a static build of Qt (version 5.6.0 or newer).Supported
Building the Qt Visual Studio Tools from sources requires a static build of Qt (version 5.6.0 or newer).Supported
Line 22: Line 25:
'''''Recommended (n)make options:''''' (n)make module-qtbase
'''''Recommended (n)make options:''''' (n)make module-qtbase


=== Build the Qt Visual Studio Tools ===
===Build the Qt Visual Studio Tools===


Change the directory into 'src' and run 'qmake && make' (or 'mingw32-make', 'nmake' ...) to build
Change the directory into 'src' and run 'qmake && make' (or 'mingw32-make', 'nmake' ...) to build
Line 28: Line 31:
in Visual Studio and build the solution.
in Visual Studio and build the solution.


=== Build the Qt Visual Studio Tools documentation ===
===Build the Qt Visual Studio Tools documentation===


Run 'qmake && make docs' (or 'mingw32-make docs', 'nmake docs' ...) from the root directory to
Run 'qmake && make docs' (or 'mingw32-make docs', 'nmake docs' ...) from the root directory to
Line 35: Line 38:
https://wiki.qt.io/Building_Qt_Documentation
https://wiki.qt.io/Building_Qt_Documentation


=== How to debug the Qt Visual Studio Tools ===
===How to debug the Qt Visual Studio Tools===


To debug the resulting VSIX, select the 'QtVsTools' node, right click and choose 'Properties|Debug'.
To debug the resulting VSIX, select the 'QtVsTools' node, right click and choose 'Properties|Debug'.
Line 42: Line 45:
build targets will only work reliable if you use the 'Exp' hive of Visual Studio.
build targets will only work reliable if you use the 'Exp' hive of Visual Studio.


=== How to locally test the Qt Visual Studio Tools update ===
===How to locally test the Qt Visual Studio Tools update===


Inside the src\config directory, edit the qt.io.xml file and modify the following tags:
Inside the src\config directory, edit the qt.io.xml file and modify the following tags:

Revision as of 08:36, 7 December 2021

En Ar Bg De El Es Fa Fi Fr Hi Hu It Ja Kn Ko Ms Nl Pl Pt Ru Sq Th Tr Uk Zh

French translators see also: http://qt-devnet.developpez.com/tutoriels/add-in-visual-studio/compiler/

Qt Visual Studio Tools

The Qt Visual Studio Tools integrate the Qt development tools into Microsoft Visual Studio. This enables developers to use the standard Windows development environment without having to worry about Qt-related build steps or tools.

Get the sources

Use Git to check out the Qt Visual Studio Tools sources that are hosted at: http://code.qt.io/cgit/qt-labs/vstools.git

To create a repository clone, execute one of the following commands:

git clone git://code.qt.io/qt-labs/vstools.git

git clone https://code.qt.io/qt-labs/vstools.git

Build a static Qt

Building the Qt Visual Studio Tools from sources requires a static build of Qt (version 5.6.0 or newer).Supported compilers are MSVC 2013 or newer, GCC 4.7 or newer, and Clang 3.1 or newer. See the Qt documentation for the prerequisites and steps to build Qt from sources. https://wiki.qt.io/Building_Qt_5_from_Git#Windows

Recommended configuration options: configure -prefix %CD%\qtbase -release -static -static-runtime -opensource -nomake examples -nomake tests
Recommended (n)make options: (n)make module-qtbase

Build the Qt Visual Studio Tools

Change the directory into 'src' and run 'qmake && make' (or 'mingw32-make', 'nmake' ...) to build the Qt Visual Studio Tools command line applications. Once finished, open the solution QtVsTools.sln in Visual Studio and build the solution.

Build the Qt Visual Studio Tools documentation

Run 'qmake && make docs' (or 'mingw32-make docs', 'nmake docs' ...) from the root directory to build the Qt Visual Studio Tools documentation. You need to have 'qdoc' and friends built already. See the Qt documentation for the prerequisites and steps to build Qt documentation from sources. https://wiki.qt.io/Building_Qt_Documentation

How to debug the Qt Visual Studio Tools

To debug the resulting VSIX, select the 'QtVsTools' node, right click and choose 'Properties|Debug'. Update 'Start Action|Start external program:' to point to your Visual Studio 'devenv.exe' application. Update 'Start Options|Command line arguments:' with '/rootSuffix Exp'. Note: The implemented post build targets will only work reliable if you use the 'Exp' hive of Visual Studio.

How to locally test the Qt Visual Studio Tools update

Inside the src\config directory, edit the qt.io.xml file and modify the following tags:

   <updated>2016-11-11T10:51:55Z</updated>   Use the current date and time, keep the 'T' and 'Z'
   <id>{ Product ID }</id>                   Set to the Product ID that can be found in the 'source.extension.vsixmanifest' file,
                                             for example: <id>QtVsTools.30112013-cd02-4fd0-89bd-e36f85abe16a</id>
   <Version>{ Version }</Version>            Set to the Version that can be found in the 'source.extension.vsixmanifest' file,
                                             for example: <Version>2.0.0</Version>

Copy the XML file and the VSIX package inside a new folder side by side and open the 'Tools | Options | Extensions and Updates' settings dialog in Visual Studio. Add a new entry in the Additional Extension Gallery, like this:

   Name: qt.io
   Url: file://path/to/your/atom.xml