0024722: Move functionality of WOK command wgendoc to OCCT tool gendoc
[occt.git] / dox / dev_guides / building / msvc.md
1 Building with MS Visual C++ {#occt_dev_guides__building_msvc}
2 ===========================
3
4 This file describes steps to build OCCT libraries from complete source
5 archive on Windows with MS Visual C++. 
6
7 If you are building OCCT from bare sources (as in Git repository), or do some 
8 changes affecting CDL files, you need to use WOK to re-generate header files
9 and build scripts / projects. See \ref occt_dev_guides__building_wok for instructions.
10
11 Before building OCCT, you need to install required third-party libraries; see
12 paragraph 1 of \ref occt_dev_guides__building for instructions.
13
14 1. Edit file custom.bat to define environment: 
15
16    - VCVER - version of Visual Studio (vc8, vc9, vc10, vc11 or vc12), 
17              and relevant VCVARS path
18    - ARCH - architecture (32 or 64), affects only PATH variable for execution
19    - HAVE_* - flags to enable or disable use of optional third-party products
20    - CSF_OPT_* - paths to search for includes and binaries of all used 
21                  third-party products
22
23 2. Launch msvc.bat to start Visual Studio with all necessary environment 
24    variables defined.
25
26    Note: the MSVC project files are located in folders adm\\msvc\\vc[9-12].
27    Binaries are produced in win32 or win64 folders.
28
29 3. Build with Visual Studio
30
31 To start DRAW, launch draw.bat.