From ac6afbe7133d7627697b32f7ce4169f553832609 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Mon, 21 Jul 2014 08:36:38 +0200 Subject: Update README --- dist/README-WINDOWS | 137 ++++++++++++++++++++++------------------------------ 1 file changed, 59 insertions(+), 78 deletions(-) (limited to 'dist') diff --git a/dist/README-WINDOWS b/dist/README-WINDOWS index ad5ffda..0657c9f 100644 --- a/dist/README-WINDOWS +++ b/dist/README-WINDOWS @@ -5,8 +5,9 @@ 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 Visual Studio .NET 2003 (7.1), Visual Studio -2005 (8.0), Visual Studio 2008 (9.0), and Visual Studio 2010 (10.0). +Windows environment with Visual Studio 2005 (8.0), Visual Studio 2008 +(9.0), and Visual Studio 2010 (10.0), Visual Studio 2012 (11.0), and +Visual Studio 2013 (12.0). Prerequisites @@ -14,9 +15,15 @@ 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 +You can also download precompiled Xerces-C++ libraries for Windows from: + http://xerces.apache.org/xerces-c/download.cgi +Note that the above download page may not contain Xerces-C++ libraries +for the latest Visual Studio releases. The Windows Installer package +(.msi) for XSD contains Xerces-C++ libraries for all of the above- +mentioned Visual Studio versions. + Environment ----------- @@ -34,22 +41,8 @@ Studio IDE and the System Environment. place, you will need to adjust the paths below accordingly. - a) For Visual Studio .NET 2003 (7.1): - - 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\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". + a) For Visual Studio 2005 (8.0) and Visual Studio 2008 (9.0): - 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". @@ -62,44 +55,44 @@ Studio IDE and the System Environment. 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 + 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). + Studio keeps a separate set of paths for each platform). - For Visual Studio 2010 (10.0): + For Visual Studio 2010-2013 (10.0-12.0): 1. Open an existing or create a new C++ project (you can open one of - the example solutions) + the example solutions that come with XSD). - 2. Open the Property Manager view by selecting "View"->"Property - Manager" (or "View"->"Other Windows"->"Property Manager") menu - action + 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 + 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 + menu action. - 5. Select the VC++ Directories tab + 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) + 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 + 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 + 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 + 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 + 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). + set of paths for each platform). b) In the Control Panel, choose "System" and select the "Advanced" tab. @@ -111,24 +104,11 @@ Studio 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 + 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): - - 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". - - 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". @@ -140,42 +120,42 @@ Studio IDE and the System Environment. 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 + 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). + 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) + the example solutions that come with XSD). - 2. Open the Property Manager view by selecting "View"->"Property + 2. Open the Property Manager view by selecting "View"->"Property Manager" (or "View"->"Other Windows"->"Property Manager") menu - action + action. - 3. Expand the property hierarchy for the project and find the - Microsoft.Cpp.Win32.user property sheet + 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 + menu action. - 5. Select the VC++ Directories tab + 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) + 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 and make sure it is the first path in the - the list of directories + 7. Add the "C:\projects\xsd-x.y.z\bin" path to the "Executable + Directories" field and make sure it is the first path in the + the list of directories. - 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 + 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). + 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. @@ -185,7 +165,8 @@ 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 (C++/Tree mapping examples) or +examples\cxx\parser (C++/Parser examples) 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 @@ -204,7 +185,7 @@ examples/cxx/tree/xpath - depends on the XQilla library (XPath 2) Using XSD in Your Projects -------------------------- -For various ways to integrate the XSD compiler with the Visual Studio IDE +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: -- cgit v1.1