1 Building with Visual C++, prerequises
\r
2 =====================================
\r
4 This document describes how to compile, build and install curl and libcurl
\r
5 from sources using the Visual C++ build tool. To build with VC++, you will
\r
6 of course have to first install VC++. The minimum required version of
\r
7 VC is 6 (part of Visual Studio 6). However using a more recent version is
\r
8 strongly recommended.
\r
10 VC++ is also part of the Windows Platform SDK. You do not have to install
\r
11 the full Visual Studio or Visual C++ if all you want is to build curl.
\r
13 The latest Platform SDK can be downloaded freely from:
\r
15 http://msdn.microsoft.com/en-us/windows/bb980924
\r
17 If you are building with VC6 then you will also need the February 2003
\r
18 Edition of the Platform SDK which can be downloaded from:
\r
20 http://www.microsoft.com/en-us/download/details.aspx?id=12261
\r
22 If you wish to support zlib, openssl, ssh2, you will have to download
\r
23 them separately and copy them to the deps directory as shown below:
\r
34 It is also possible to create the deps directory in some other random
\r
35 places and tell the Makefile its location using the WITH_DEVEL option.
\r
37 Building with Visual C++
\r
38 ========================
\r
40 Open a Visual Studio Command prompt or the SDK CMD shell.
\r
42 Using the CMD Shell:
\r
43 choose the right environment via the setenv command (see setenv /?)
\r
44 for the full list of options. setenv /xp /x86 /release for example.
\r
46 Using the Visual Studio command prompt Shell:
\r
47 Everything is already pre-configured by calling one of the command
\r
50 Once you are in the console, go to the winbuild directory in the Curl
\r
52 cd curl-src\winbuild
\r
54 Then you can call nmake /f Makefile.vc with the desired options (see below).
\r
55 The builds will be in the top src directory, builds\ directory, in
\r
56 a directory named using the options given to the nmake call.
\r
58 nmake /f Makefile.vc mode=<static or dll> <options>
\r
60 where <options> is one or many of:
\r
61 VC=<6,7,8,9,10,11,12> - VC versions
\r
62 WITH_DEVEL=<path> - Paths for the development files (SSL, zlib, etc.)
\r
63 Defaults to sibbling directory deps: ../deps
\r
64 Libraries can be fetched at http://windows.php.net/downloads/php-sdk/deps/
\r
65 Uncompress them into the deps folder.
\r
66 WITH_SSL=<dll or static> - Enable OpenSSL support, DLL or static
\r
67 WITH_ZLIB=<dll or static> - Enable zlib support, DLL or static
\r
68 WITH_SSH2=<dll or static> - Enable libSSH2 support, DLL or static
\r
69 ENABLE_SSPI=<yes or no> - Enable SSPI support, defaults to yes
\r
70 ENABLE_IPV6=<yes or no> - Enable IPv6, defaults to yes
\r
71 ENABLE_IDN=<yes or no> - Enable use of Windows IDN APIs, defaults to yes
\r
72 Requires Windows Vista or later, or installation from:
\r
73 http://www.microsoft.com/downloads/details.aspx?FamilyID=AD6158D7-DDBA-416A-9109-07607425A815
\r
74 ENABLE_WINSSL=<yes or no> - Enable native Windows SSL support, defaults to yes
\r
75 GEN_PDB=<yes or no> - Generate Program Database (debug symbols for release build)
\r
76 DEBUG=<yes or no> - Debug builds
\r
77 MACHINE=<x86 or x64> - Target architecture (default is x86)
\r