From 5a5a9927f7c0746cec19bf3f1f789de6d4d1410a Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Wed, 21 Apr 2010 13:07:43 +0200 Subject: Add setup instructions for Visual Studio 2010 --- dist/README-WINDOWS | 171 ++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 138 insertions(+), 33 deletions(-) (limited to 'dist') 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 - - -- cgit v1.1