Visual Studio Add-in: Difference between revisions
(Add information on how to setup a private VSIX extension gallery) |
|||
| Line 41: | Line 41: | ||
Update 'Start Options|Command line arguments:' with '/rootSuffix Exp'. Note: The implemented post | 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. | 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 | |||
Revision as of 10:32, 20 December 2016
French translators see also: http://qt-devnet.developpez.com/tutoriels/add-in-visual-studio/compiler/
Qt Visual Studio 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 the following command:
git clone git://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