1# Installation on Windows
2
3This documentation describes how to set up a workspace for trying to compile sdformat on Windows.
4
5## Supported compilers
6
7At this moment, compilation has been tested on Windows 7 and 8.1 and is supported
8when using Visual Studio 2013. Patches for other versions are welcome.
9
10## Installation
11
12Totally experimental, using pre-compiled binaries in a local workspace.  To
13make things easier, use a MinGW shell for your editing work, and only use the
14Windows `cmd` for configuring and building.
15
161. Make a directory to work in, e.g.:
17
18        mkdir sdformat-ws
19        cd sdformat-ws
20
211. Unzip it in sdformat-ws.
22
231. Clone sdformat
24
25        hg clone https://bitbucket.org/osrf/sdformat
26
271. Load your compiler setup, e.g. (note that we are asking for the 64-bit toolchain here):
28
29        "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\vcvarsall.bat" x86_amd64
30
311. Configure and build sdformat:
32
33        cd sdformat
34        mkdir build
35        cd build
36        ..\configure
37        nmake
38        nmake install
39
40    You should now have an installation of sdformat in sdformat-ws/sdformat/build/install/Release.
41
42    Once this all works (which it does with tender love and care): you should now have an installation of sdformat in sdformat-ws/sdformat/build/install/Release.
43