20785713575bfedae20d5ddc1d6152bb8ee500c7
[asdcplib.git] / win32 / README.txt
1 I. INTRODUCTION\r
2 ===============\r
3 \r
4 Hello, and welcome to the Windows build instructions for asdcplib.\r
5 \r
6 \r
7 II. DEPENDENCIES\r
8 ================\r
9 \r
10 First, you'll need Microsoft's Visual Studio 2005 or later. A heavyweight edition isn't needed;\r
11 the Express edition works fine.\r
12 \r
13 Next, you'll need an OpenSSL distribution. The absolute, bare minimum needed is 0.9.7. However,\r
14 if this will be used in conjunction with CineCert's other software, the later 0.9.8b\r
15 is needed. That said, the latest revision of OpenSSL as of this writing (0.9.8i) works great.\r
16 Extract and build in the directory of your choice.\r
17 \r
18 For (optional) XML parsing support, you'll need to use Xerces-C++ 2.7 or 2.8 (3.0 isn't yet\r
19 supported) or Expat 2.0.1 (used in previous versions of asdcplib). If you'll be using this\r
20 software in conjuction with CineCert's other software, the use of Xerces-C++ is required. If\r
21 you need/desire XML parsing, extract the source package and build in a directory of your choice.\r
22 \r
23 \r
24 III. BUILDING\r
25 =============\r
26 \r
27 Open a command prompt in which the VS build tools are available on the command line (e.g., the\r
28 "Visual Studio command prompt"). The nmake invocation follows this form:\r
29 C:\>nmake WITH_OPENSSL=<OpenSSL directory> [[WITH_XERCES=<Xerces directory>]|\r
30         [WITH_XML_PARSER=<Expat directory>]] /f Makefile.mak\r
31 \r
32 On our Windows development machine, the invocation with XML parsing by Xerces-C++ is as such:\r
33 C:\Program Files\asdcplib-1.3.20\win32>nmake WITH_OPENSSL="c:\Program Files\openssl-0.9.8i"\r
34         WITH_XERCES="C:\Program Files\xerces-c_2_8_0-x86-windows-vc_8_0" /f Makefile.mak\r
35 \r
36 With XML parsing by Expat:\r
37 C:\Program Files\asdcplib-1.3.20\win32>nmake WITH_OPENSSL="c:\Program Files\openssl-0.9.8i"\r
38         WITH_XML_PARSER="C:\Program Files\Expat 2.0.1" /f Makefile.mak\r
39 \r
40 Without XML parsing:\r
41 C:\Program Files\asdcplib-1.3.20\win32>nmake WITH_OPENSSL="c:\Program Files\openssl-0.9.8i"\r
42         /f Makefile.mak\r
43 \r
44 \r
45 IV. CONCLUSION\r
46 ==============\r
47 \r
48 For answers to questions, please send a message to asdcplib@cinecert.com.\r