Redirect a link from the old google code site to the github wiki.
[dealii.wiki.git] / Windows.md
1 # Using deal.II on native Windows
2
3 For an overview of different ways to use deal.II on Windows have a look at the corresponding [FAQ entry](https://github.com/dealii/dealii/wiki/Frequently-Asked-Questions#can-i-use-dealii-on-a-windows-platform).
4
5 **Warning: please be aware that the following is experimental and you will likely encounter bugs in compilers and deal.II itself. Only continue if you are willing to experiment.** 
6
7 ## Visual Studio
8
9 Since deal.II 8.4.0 we have experimental support for the newer Visual Studio C++ compilers (2013 and 2015), but this is still work in progress. Please see the following threads for more details:
10 - https://github.com/dealii/dealii/issues/1921
11
12 Installation instructions:
13
14 1. Download and install Visual Studio: https://www.visualstudio.com/en-us/products/vs-2015-product-editions.aspx and make sure you select the C++ compiler
15 2. Install cmake from https://cmake.org/download/ (pick the windows installer)
16 3. Extract deal.II to a folder, for example c:\dealii (or clone the git development version)
17 4. Configure using cmake by opening cmd:
18
19     ```
20 cd c:\dealii
21 mkdir build
22 cd c:\dealii\build
23 cmake -D CMAKE_INSTALL_PREFIX=c:\dealii\install ..
24     ```
25
26 6. Compile and install the library by opening ``deal.II.sln`` in c:\dealii\build, pick the install target and compile.
27 7. in cmd go to one of the examples in c:\dealii\examples\step-xy:
28
29     ```
30 cmake -D DEAL_II_DIR=c:\dealii\install .
31     ```
32
33 8. Open the newly created solution (step-xy.sln) in that directory and compile/run/debug.
34
35 ## Running build tests on Windows:
36
37 Install git and mingw (for perl etc). Then create a .bat file:
38 ```
39 git pull origin master
40 rmdir /Q /S buildtest15
41 mkdir buildtest15
42 cd buildtest15
43 ctest -C Debug -DMAKEOPTS="/m:1" -DCTEST_CMAKE_GENERATOR="Visual Studio 14 2015" -S ../tests/run_buildtest.cmake -V
44 cd ..
45 ```
46
47 ## Cygwin / MingGW
48
49 Cygwin and forks such as MinGW and MinGW-64 are unsupported due to multiple unresolved miscompilation issues.
50
51 ## Other Windows compilers
52
53 We haven't had much success with any other compiler on Windows (Intel, Borland, ...).

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.