summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorEoD <EoD@xmw.de>2016-01-17 19:58:54 +0100
committerJose Fonseca <jfonseca@vmware.com>2016-01-17 22:15:07 +0000
commit06e20a68bd06ef3f72f9f58165d1d55042816a91 (patch)
tree54aad13fa627fd94ac2d4f65e48b34f9dc99a655 /docs
parent111f2f6db475b3e47b3af17b186e941a44d9a064 (diff)
docs: Expand the installation instruction for MSVC.
Diffstat (limited to 'docs')
-rw-r--r--docs/INSTALL.markdown30
1 files changed, 25 insertions, 5 deletions
diff --git a/docs/INSTALL.markdown b/docs/INSTALL.markdown
index 46f418e7..90cd1539 100644
--- a/docs/INSTALL.markdown
+++ b/docs/INSTALL.markdown
@@ -133,6 +133,8 @@ Additional requirements:
need to donwload and install the
[August 2007 release of DirectX SDK](http://www.microsoft.com/downloads/details.aspx?familyid=529F03BE-1339-48C4-BD5A-8506E5ACF571)
+### CMake GUI ###
+
To build with Visual Studio first invoke CMake GUI as:
cmake-gui -H. -Bbuild -DCMAKE_PREFIX_PATH=C:\Qt\QtX.Y.Z\X.Y\msvc2013
@@ -147,19 +149,37 @@ If the source/build/compiler/tools are spread across multiple drives, you might
need to [use absolute paths](https://github.com/apitrace/apitrace/issues/352).
After you've successfully configured, you can start the build by opening the
-generated `build\apitrace.sln` solution file, or invoking CMake as:
-
- cmake --build build --config MinSizeRel
+generated `build\apitrace.sln` solution file
The steps to build 64-bits version are similar, but choosing _Visual Studio xx
Win64_ instead of _Visual Studio xx_.
By default, binaries generated by recent builds of Visual Studio will not work
-on Windows XP. If you want to obtain binaries that on Windows XP then pass the
+on Windows XP. If you want to obtain binaries that work on Windows XP then pass the
`-T v110_xp` or `-T v120_xp` options to cmake when building with Visual Studio
2012 or 2013 respectively.
-To run qapitrace, either you ensure that `C:\Qt\QtX.Y.Z\X.Y\msvc2013\bin` is in the system path, or you can use [Qt's Windows deployment tool](http://doc.qt.io/qt-5/windows-deployment.html#the-windows-deployment-tool) to copy all necessary DLLs, like:
+### CMake CLI ###
+
+Another option is to use the commandline to configure the project. First of all find out which
+generators are available on your system:
+
+ cmake --help
+
+At the end of the output, choose a generator and start configuring the project:
+
+ cmake -H. -Bbuild -DCMAKE_PREFIX_PATH=C:\Qt\QtX.Y.Z\X.Y\msvc2013_64 -G "Visual Studio 12 2013 Win64"
+
+For 32-bit builds remove the `Win64` and the `_64` from the command.
+After you've successfully configured, you can start the build by invoking CMake as:
+
+ cmake --build build --config MinSizeRel
+
+### Deployment ###
+
+To run qapitrace, either ensure that `C:\Qt\QtX.Y.Z\X.Y\msvc2013\bin` is in the system path, or use
+[Qt's Windows deployment tool](http://doc.qt.io/qt-5/windows-deployment.html#the-windows-deployment-tool)
+to copy all necessary DLLs, like:
set Path=C:\Qt\QtX.Y.Z\X.Y\msvc2013\bin;%Path%
windeployqt build\qapitrace.exe