aboutsummaryrefslogtreecommitdiff
path: root/dist
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2010-04-21 13:07:43 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2010-04-21 13:07:43 +0200
commit5a5a9927f7c0746cec19bf3f1f789de6d4d1410a (patch)
tree5967f96b64325499078b7ec78c7bb6a00522f395 /dist
parent88b95420a720b67b908ea358023d9d5b72909c62 (diff)
Add setup instructions for Visual Studio 2010
Diffstat (limited to 'dist')
-rw-r--r--dist/README-WINDOWS171
1 files changed, 138 insertions, 33 deletions
diff --git a/dist/README-WINDOWS b/dist/README-WINDOWS
index 35eda26..e497f25 100644
--- a/dist/README-WINDOWS
+++ b/dist/README-WINDOWS
@@ -5,9 +5,8 @@ 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).
+Windows environment with Visual Studio .NET 2003 (7.1), Visual Studio
+2005 (8.0), Visual Studio 2008 (9.0), and Visual Studio 2010 (10.0).
Prerequisites
@@ -24,7 +23,7 @@ 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.
+Studio IDE and the System Environment.
1. Setting up Xerces-C++
@@ -32,17 +31,75 @@ C++ IDE and the System Environment.
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.
+ place, you will need to adjust the paths below accordingly.
- a) In the Visual C++ IDE, select "Tools"/"Options"/"Projects"/"VC++
- Directories".
+ a) For Visual Studio .NET 2003 (7.1):
- 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".
+ In the Visual Studio IDE, select "Tools"/"Options"/"Projects"/"VC++
+ Directories".
- 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".
+ 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".
+
+ After that, in the "Show directories for" field, select "Executable files"
+ and create a new entry with the value "C:\projects\xerces-c-x.y.z\bin".
+
+ For Visual Studio 2005 (8.0) and Visual Studio 2008 (9.0):
+
+ In the Visual Studio IDE, select "Tools"/"Options"/"Projects and
+ Solution"/"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".
+
+ After that, in the "Show directories for" field, select "Executable files"
+ and create a new entry with the value "C:\projects\xerces-c-x.y.z\bin".
+
+ If you are building the 64-bit version of your application, repeat the
+ above steps for the 64-bit version of Xerces-C++ while selecting x64
+ in the "Platform" drop-down list in the VC++ Directories dialog (Visual
+ Studio keeps a separate set of paths for each platform).
+
+ For Visual Studio 2010 (10.0):
+
+ 1. Open an existing or create a new C++ project (you can open one of
+ the example solutions)
+
+ 2. Open the Property Manager view by selecting "View"->"Property
+ Manager" (or "View"->"Other Windows"->"Property Manager") menu
+ action
+
+ 3. Expand the property hierarchy for the project and find the
+ Microsoft.Cpp.Win32.user property sheet
+
+ 4. Right click on Microsoft.Cpp.Win32.user and select the "Properties"
+ menu action
+
+ 5. Select the VC++ Directories tab
+
+ 6. Add the "C:\projects\xerces-c-x.y.z\include" path to the "Include
+ Directories" field (the paths are separated by a semicolon)
+
+ 7. Add the "C:\projects\xerces-c-x.y.z\lib" path to the "Library
+ Directories" field
+
+ 8. Add the "C:\projects\xerces-c-x.y.z\bin" path to the "Executable
+ Directories" field
+
+ 9. Click Ok to close the dialog and then click the Save button at the
+ top of the Property Manager view to save Microsoft.Cpp.Win32.user
+
+ If you are building the 64-bit version of your application, repeat
+ the above steps for the 64-bit version of Xerces-C++ but using the
+ Microsoft.Cpp.x64.user property sheet (Visual Studio keeps a separate
+ set of paths for each platform).
b) In the Control Panel, choose "System" and select the "Advanced" tab.
@@ -53,39 +110,89 @@ C++ IDE and the System Environment.
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.
+ 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.
+ For Visual Studio .NET 2003 (7.1):
- a) In the Visual C++ IDE, select "Tools"/"Options"/"Projects"/"VC++
- Directories".
+ In the Visual Studio 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".
+ 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).
+ 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).
+ For Visual Studio 2005 (8.0) and Visual Studio 2008 (9.0):
+
+ In the Visual Studio IDE, select "Tools"/"Options"/"Projects and
+ Solution"/"VC++ Directories".
-3. Restart the Visual C++ IDE. This is necessary for the new value of the
- "Path" environment variable to take effect.
+ 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).
+
+ If you are building the 64-bit version of your application, repeat the
+ above steps using the same paths while selecting x64 in the "Platform"
+ drop-down list in the VC++ Directories dialog (Visual Studio keeps a
+ separate set of paths for each platform).
+
+ For Visual Studio 2010 (10.0):
+
+ 1. Open an existing or create a new C++ project (you can open one of
+ the example solutions)
+
+ 2. Open the Property Manager view by selecting "View"->"Property
+ Manager" (or "View"->"Other Windows"->"Property Manager") menu
+ action
+
+ 3. Expand the property hierarchy for the project and find the
+ Microsoft.Cpp.Win32.user property sheet
+
+ 4. Right click on Microsoft.Cpp.Win32.user and select the "Properties"
+ menu action
+
+ 5. Select the VC++ Directories tab
+
+ 6. Add the "C:\projects\xsd-x.y.z\libxsd" path to the "Include
+ Directories" field (the paths are separated by a semicolon)
+
+ 7. Add the "C:\projects\xsd-x.y.z\bin" path to the "Executable
+ Directories" field
+
+ 8. Click Ok to close the dialog and then click the Save button at the
+ top of the Property Manager view to save Microsoft.Cpp.Win32.user
+
+ If you are building the 64-bit version of your application, repeat the
+ above steps using the same paths but using the Microsoft.Cpp.x64.user
+ property sheet (Visual Studio keeps a separate set of paths for each
+ platform).
+
+
+3. Restart the Visual Studio IDE.
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.
+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/embedded - example of schema embedding
examples/cxx/tree/custom - examples of type customization
-examples/cxx/tree/custom/calendar - depends on the Boost date_time librar
+examples/cxx/tree/custom/calendar - depends on the Boost date_time library
examples/cxx/tree/compression - depends on the zlib library
examples/cxx/tree/binary/boost - depends on the Boost serialization library
examples/cxx/tree/binary/cdr - depends on the ACE library
@@ -94,13 +201,11 @@ 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
-----------------------
+Using XSD 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:
+For various ways to integrate the XSD compiler with the 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
-
-