1. Installing XMLmind XML Editor (XXE for short)

Requirements

XXE should run fine on any platform supporting Java 1.6+. However it is officially supported only on:

It is possible to use XXE on other platforms —notably Mac OS X 10.6 (Snow Leopard), 10.7 (Lion) on the Mac— and/or with other LAFs, but without support from XMLmind.

Install on Windows

  1. Download the setup.exe file.

    This setup.exe files includes a very recent, generally the most recent, Oracle® private Java™ runtime. Therefore, you don't need to install Java on your computer. Moreover, if you have Java already installed on your computer, then your public Java runtime will be ignored by XXE.

  2. Double-click on the setup.exe file to launch the installer.

  3. Follow the instructions of the installer.

Install on the Mac

  1. Download the .dmg file.

    The Web browser is supposed to automatically copy the contents of the .dmg file — a folder called xxe-edition-version — to the download directory and then to move the downloaded .dmg file to the Trash.

  2. Copy the XMLeditor.app folder, an application bundle represented by icon , anywhere you want. For example, drag&drop this icon to the /Applications folder or to your desktop.

  3. Start XMLmind XML Editor by double-clicking on the icon (or use the Launchpad).

  4. The first time XMLmind XML Editor is started, your Mac will generally ask you to confirm that you actually want to open an application downloaded from the Internet. Click Open to confirm.

    Don't worry, XMLmind XML Editor has been digitally signed using a certificate issued by Apple itself. This confirmation is required for any digitally signed application not coming from the App Store.

About Java on the Mac

The .dmg distribution includes a very recent, generally the most recent, Oracle® private Java™ runtime. However, this private runtime is not necessarily the one which will be used to run XXE:

  • If you have an Apple® Java 1.6 runtime installed on your computer, this runtime —most reliable one and having the best font rendering— will be used to run XXE.

  • If you have an Oracle Java runtime at least as recent as the bundled one installed on your computer, this runtime will be used to run XXE.

  • Otherwise, it's the bundled runtime which will be used to run XXE.

Install on Linux or alternative install on the Mac

Tip

On the Mac, it is strongly recommended to download and install the .dmg file.

  1. Make sure that the Javabin/ directory is referenced in the $PATH and, at the same time, check that the Java™ runtime in the $PATH has the right version:

    ~$ java -version
    java version "1.8.0_05"
    Java(TM) SE Runtime Environment (build 1.8.0_05-b13)
    Java HotSpot(TM) 64-Bit Server VM (build 25.5-b02, mixed mode)
  2. Unpack the XXE distribution inside any directory you want:

    $ cd
    $ tar zxvf xxe-eval-6_0_0.tar.gz
    $ ls xxe-eval-6_0_0
    addon/
    bin/
    demo/
    doc/
    ...
  3. XXE is intended to be used directly from the xxe-eval-6_0_0/ directory. That is, you can start XXE by simply executing:

    $ xxe-eval-6_0_0/bin/xxe &

    After that, you may want to add xxe-eval-6_0_0/bin/ to your $PATH.

Manual install on Windows

Tip

On Windows, it is strongly recommended to download and install the auto-installable setup.exe file.

  1. Make sure that you have a Java™ 1.6+ runtime installed on your machine. To check this, open a command window and type "java -version" followed by Enter. You should get something looking like this:

    C:\>java -version
    java version "1.8.0_05"
    Java(TM) SE Runtime Environment (build 1.8.0_05-b13)
    Java HotSpot(TM) 64-Bit Server VM (build 25.5-b02, mixed mode)
  2. Use a tool like WinZip, 7-Zip or Info-Zip [2] to unzip the XXE distribution inside any directory you want:

    C:\> mkdir XMLmind
    C:\> cd XMLmind
    C:\XMLmind> unzip xxe-eval-6_0_0.zip
    C:\XMLmind> dir xxe-eval-6_0_0
    ... <DIR> addon
    ... <DIR> bin
    ... <DIR> demo
    ... <DIR> doc
    ...
  3. XXE is intended to be used directly from the xxe-eval-6_0_0/ directory. That is, you can start XXE by simply executing:

    C:\XMLmind> xxe-eval-6_0_0\bin\xxe.exe

    After that, you may want to add a shortcut to "C:\XMLmind\xxe-eval-6_0_0\bin\xxe.exe" on your desktop.

    Note that the bin/ directory contains not only xxe.exe, but also xxe-c.bat, which starts XXE with a console. On Windows, a console is needed to be able to see low-level error messages, for example, when developing custom configurations or extensions.



[1] Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

[2] Note that Windows XP has built-in support for .zip archives.