Source and binary distributions installation instructions are available for the following platforms:

- Windows
- UNIX/Linux/Mac OS X
- Cygwin

| Windows |

| This section contains installation instructions for the Windows platform.

| Source distribution |

| The Xerces-C++ source is available in the source distribution: xerces-c-3.1.0.zip. Install the Xerces-C++ source distribution by using `unzip` on the xerces-c-3.1.0.zip archive in the Windows environment. You can use WinZip, or any other UnZip utility:

    unzip xerces-c-3.1.0.zip

This creates the 'xerces-c-3.1.0' sub-directory containing the Xerces-C++ source distribution.

If you need to build the Xerces-C++ source after installation, please follow the Build Instructions.

| Binary distribution |

| Install the Xerces-C++ binary distribution by using `unzip` on the xerces-c-3.1.0-{arch}-windows-{compiler}.zip archive in the Windows environment. Here {arch} denotes the CPU architecture and {compiler} denotes the C++ compiler of your choice. You can use WinZip, or any other UnZip utility. For example:

    unzip xerces-c-3.1.0-x86-windows-vc-8.0.zip

This creates a 'xerces-c-3.1.0-x86-windows-vc-8.0' sub-directory containing the Xerces-C++ binary distribution.

You need to add the 'xerces-c-3.1.0-{arch}-windows-{compiler}\bin' directory to your path. To do this go to the start menu, click the settings menu and select control panel. When the control panel opens, double click on System and select the 'Environment' tab. Locate the PATH variable under system variables and add <full-path-to-xerces-c-3.1.0-{arch}-windows-{compiler}>\bin to the PATH variable.

Additionally, if you don't have the corresponding version of Microsoft Visual C++ installed, you may need to download and install the C/C++ runtime libraries from the Microsoft website. For example, for Visual Studio 2008 (9.0) the package is called "Microsoft Visual C++ 2008 Redistributable Package".

The binary distribution contains the pre-built parser libraries and sample executables. Please refer to the Samples for how to run the samples.

| UNIX |

| This section contains installation instructions for the UNIX, Linux, and Mac OS X platforms.

| Source distribution |

| The Xerces-C++ source is available in the source distribution: xerces-c-3.1.0.tar.gz. Install the Xerces-C++ source distribution xerces-c-3.1.0.tar.gz by extracting the files from the compressed archive:

    gzip -d xerces-c-3.1.0.tar.gz
    tar -xf xerces-c-3.1.0.tar

This creates the 'xerces-c-3.1.0' sub-directory containing the Xerces-C++ source distribution.

If you need to build the Xerces-C++ source after installation, please follow the Build Instructions.

| Binary distribution |

| Install the binary distribution xerces-c-3.1.0-{arch}-{os}-{compiler}.tar.gz by extracting the files from the compressed archive. Here {arch} denotes the CPU architecture, {os} denotes the operating system, and {compiler} denotes the C++ compiler of your choice. For example:

    gzip -d xerces-c-3.1.0-x86-linux-gcc-3.4.tar.gz
    tar -xf xerces-c-3.1.0-x86-linux-gcc-3.4.tar

This will create an 'xerces-c-3.1.0-x86-linux-gcc-3.4' sub-directory containing the Xerces-C++ binary distribution.

You will need to add the xerces-c-3.1.0-{arch}-{os}-{compiler}/bin directory to your PATH environment variable:

For Bourne Shell, K Shell or Bash, type:

    export PATH="$PATH:<full-path-to-xerces-c-3.1.0-{arch}-{os}-{compiler}>/bin"

For C Shell, type:

    setenv PATH "$PATH:<full-path-to-xerces-c-3.1.0-{arch}-{os}-{compiler}>/bin"

If you wish to make this setting permanent, you need to change your profile by changing your setup files which can be either .profile or .kshrc.

In addition, you will also need to set the library search path. (LIBPATH on AIX, LD_LIBRARY_PATH on Solaris and Linux, SHLIB_PATH on HP-UX, and DYLD_LIBRARY_PATH on Mac OS X).

In the following shell commands, the <xerces-path> denotes the full path to the xerces-c-3.1.0-{arch}-{os}-{compiler} directory. For Bourne Shell, K Shell or Bash, type:

    export LIBPATH=<xerces-path>/lib:$LIBPATH (AIX)
    export LD_LIBRARY_PATH=<xerces-path>/lib:$LD_LIBRARY_PATH (Solaris, Linux)
    export SHLIB_PATH=<xerces-path>/lib:$SHLIB_PATH (HP-UX)
    export DYLD_LIBRARY_PATH=<xerces-path>/lib:$DYLD_LIBRARY_PATH (Mac OS X)

For C Shell, type:

    setenv LIBPATH "<xerces-path>/lib:$LIBPATH" (AIX)
    setenv LD_LIBRARY_PATH "<xerces-path>/lib:$LD_LIBRARY_PATH" (Solaris, Linux)
    setenv SHLIB_PATH "<xerces-path>/lib:$SHLIB_PATH" (HP-UX)
    setenv DYLD_LIBRARY_PATH "<xerces-path>/lib:$DYLD_LIBRARY_PATH" (Mac OS X)

The binary distribution contains the pre-built parser libraries and sample executables. Please refer to the Samples for how to run the samples.

| Cygwin |

| This section contains installation instructions for the Cygwin platform.

| Source distribution |

| The Xerces-C++ source is available in the source distribution: xerces-c-3.1.0.tar.gz. Install the Xerces-C++ source distribution xerces-c-3.1.0.tar.gz by extracting the files from the compressed archive:

    tar -xfz xerces-c-3.1.0.tar.gz

This creates the 'xerces-c-3.1.0' sub-directory containing the Xerces-C++ source distribution.

If you need to build the Xerces-C++ source after installation, please follow the Build Instructions.

| Binary distribution |

| Precompiled Xerces-C++ libraries for Cygwin are provide as part of the Cygwin package repository. To install the binary distribution run Cygwin setup.exe. When you reach the Packages step of the Cygwin Setup wizard, expand the Devel category, then click in the New column next to "xerces-c-devel" until it reads "3.1.0-X".

Copyright © 1999-2008 The Apache Software Foundation. All Rights Reserved.