[occt.git] / dox / dev_guides / building / msvc.md

Building with MS Visual C++ {#dev_guides__building__msvc}
===========================

This file describes steps to build OCCT libraries from complete source
archive on Windows with MS Visual C++. 

If you are building OCCT from bare sources (as in Git repository), or do some 
changes affecting CDL files, you need to use WOK to re-generate header files
and build scripts / projects. See file \ref wok "WOK" for instructions.

Before building OCCT, you need to install required third-party libraries; see
OCCT_Build3rdParty_Windows.pdf for instructions.

1. Edit file custom.bat to define environment: 

   - VCVER - version of Visual Studio (vc8, vc9, vc10 or vc11), 
             and relevant VCVARS path
   - ARCH - architecture (32 or 64), affects only PATH variable for execution
   - HAVE_* - flags to enable or disable use of optional third-party products
   - CSF_OPT_* - paths to search for includes and binaries of all used 
                 third-party products

2. Launch msvc.bat to start Visual Studio with all necessary environment 
   variables defined.

   Note: the MSVC project files are located in folders adm\\msvc\\vc[9-11].
   Binaries are produced in win32 or win64 folders.

3. Build with Visual Studio

To start DRAW, launch draw.bat.
Commit	Line	Data
72b7576f	1	Building with MS Visual C++ {#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 file \ref wok "WOK" for instructions.
	10
	11	Before building OCCT, you need to install required third-party libraries; see
	12	OCCT_Build3rdParty_Windows.pdf for instructions.
	13
	14	1. Edit file custom.bat to define environment:
	15
	16	- VCVER - version of Visual Studio (vc8, vc9, vc10 or vc11),
	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-11].
	27	Binaries are produced in win32 or win64 folders.
	28
	29	3. Build with Visual Studio
	30
	31	To start DRAW, launch draw.bat.