summaryrefslogtreecommitdiff
path: root/dist/README-WINDOWS
blob: fbc938cc166ab8234f799aa35bb68262f304084b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
This package contains precompiled binaries of CodeSynthesis XSD, a
W3C XML Schema to C++ Data Binding compiler, built for Microsoft
Windows. For more information about XSD visit

http://www.codesynthesis.com/products/xsd/

This README file describes how to start using XSD in the Microsoft
Windows environment with Microsoft Visual C++ 7.1 (.NET 2003),
Microsoft Visual C++ 8 (Visual Studio 2005), and Microsoft Visual
C++ 9 (Visual Studio 2008).


Prerequisites
-------------

The XSD runtime library and the generated code depend on the Xerces-C++
XML parser which you can obtain from http://xerces.apache.org/xerces-c/.
You can also download precompiled Xerces-C++ libraries for Windows from
http://xerces.apache.org/xerces-c/download.cgi


Environment
-----------

Before you can start building examples or your applications that use XSD
you need to set include, library and executable search paths in the Visual
C++ IDE and the System Environment.

1. Setting up Xerces-C++

  First you need to set up Xerces-C++ include and library search paths.
  If you already have Xerces-C++ set up in your development environment,
  you can skip to the next step. Here we assume that your Xerces-C++ path
  is C:\projects\xerces-c-x.y.z. If you have Xerces-C++ in a different
  place you will need to adjust the paths below accordingly.


  a) In the Visual C++ IDE, select "Tools"/"Options"/"Projects"/"VC++
     Directories".

     Then, in the "Show directories for" field, select "Include files" and
     create a new entry with the value "C:\projects\xerces-c-x.y.z\include".

     After that, in the "Show directories for" field, select "Library files"
     and create a new entry with the value "C:\projects\xerces-c-x.y.z\lib".


  b) In the Control Panel, choose "System" and select the "Advanced" tab.
     Click on the "Environment Variables" button. In the "System Variables"
     list, select "Path" and add (via "Edit" button) the
     ";C:\projects\xerces-c-x.y.z\bin" path at the end.


2. Setting up XSD

  Now you need to set up XSD executable and include search paths. Here
  we assume that your XSD path is C:\projects\xsd-x.y.z. If you have XSD
  in a different place you will need to adjust the paths below accordingly.


  a) In the Visual C++ IDE, select "Tools"/"Options"/"Projects"/"VC++
     Directories".

     Then, in the "Show directories for" field, select "Include files" and
     create a new entry with the value "C:\projects\xsd-x.y.z\libxsd".

     After that, in the "Show directories for" field, select "Executable
     files" and create a new entry with the value "C:\projects\xsd-x.y.z\bin".
     Make sure it is the first line in the list of directories (use the
     "Up" button to move the new entry up, if necessary).


3. Restart the Visual C++ IDE. This is necessary for the new value of the
   "Path" environment variable to take effect.


Building Examples
-----------------

Now you are ready to build examples. Simply open the solution file
found in the examples/cxx/tree and examples/cxx/parser directories.

Some of the examples depend on additional third-party libraries or
show a specific feature of XSD and are not included in the solutions
above. They come with their individual solution files:

examples/cxx/tree/custom           - examples of type customization
examples/cxx/tree/custom/calendar  - depends on the Boost date_time library
examples/cxx/tree/binary/boost     - depends on the Boost serialization library
examples/cxx/tree/binary/cdr       - depends on the ACE library
examples/cxx/tree/binary/xdr       - requires a third-party XDR library
examples/cxx/tree/xpath            - depends on the XQilla library (XPath 2)
examples/cxx/tree/dbxml            - depends on the Berkeley DB XML library


Using in Your Projects
----------------------

For various ways to integrate the XSD compiler with the Microsoft Visual
Studio IDE as well as other Visual Studio-specific topics, refer to the
Using XSD with Microsoft Visual Studio Wiki page:

http://wiki.codesynthesis.com/Using_XSD_with_Microsoft_Visual_Studio