1. Installing XMLmind XML Editor (XXE for short)

Requirements

  • Oracle® Java[1] runtime 1.6 or above.

  • At least 2Gb of memory and a 2GHz CPU.

  • 250Mb of free disk space; 500Mb for the self-contained distribution which includes a private Java runtime.

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

  • Windows XP/Vista/7/8/10, 32-bit or 64-bit, running Oracle Java 1.6+ with the Windows Look and Feel (LAF).

  • macOS 10.13 (High Sierra) and 10.12 (Sierra), running a very recent Oracle Java 1.8+ (more recent than version 1.8.0_40) with the Macintosh LAF.

  • Linux 2.6+ running Oracle Java 1.6+ with the Metal LAF.

It is possible to use XXE on other platforms —notably Mac OS X 10.11 (El Capitan) on the Mac— and/or using other Java runtimes —notably Apple® Java 1.6 on the Mac— and/or with other LAFs, but without support from XMLmind.

XXE should work fine on Macs having Retina® screens and on Personal Computers having UHD (“4K”) screens. On Windows, all DPI scale factors —100%, 125%, 150%, 200%, etc— are supported. However for this to work, please make sure to install latest Oracle® Java™ runtime and to use the system, default, Look and Feel.

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.

About Java on Windows

The setup.exe distribution includes a very recent, generally the most recent, Oracle® private Java™ runtime.

If you prefer to run XXE using a different version of Java, you'll have to first delete folder XXE_INSTALL_DIR\bin\jre\ in order to force XXE to use the version of Java installed on your computer.

Install on the Mac

  1. Download the .dmg file.

  2. Double-click the downloaded .dmg file to open it in the Finder.

  3. Copy the XMLmind.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.

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

  5. 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.

  6. Move the downloaded .dmg file to the Trash.

About Java on the Mac

The .dmg distribution includes a very recent, generally the most recent, Oracle® private Java™ runtime.

If you prefer to run XXE using a different version of Java, please proceed as follows:

  • If a newer version of Java is installed on your computer, there is nothing special to do. It's this newer version which will be automatically used to run XXE.

  • If a older version of Java is installed on your computer, you'll have to first delete folder XMLmind.app/Contents/Resources/xxe/bin/jre/ in order to force XXE to use this old version.

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_144"
    Java(TM) SE Runtime Environment (build 1.8.0_144-b01)
    Java HotSpot(TM) 64-Bit Server VM (build 25.144-b01, mixed mode)
  2. Unpack the XXE distribution inside any directory you want:

    $ cd
    $ unzip xxe-pro-7_6_0.zip
    $ ls xxe-pro-7_6_0
    addon/
    bin/
    demo/
    doc/
    ...
  3. XXE is intended to be used directly from the xxe-pro-7_6_0/ directory. That is, you can start XXE by simply executing:

    $ xxe-pro-7_6_0/bin/xxe &

    After that, you may want to add xxe-pro-7_6_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_112"
    Java(TM) SE Runtime Environment (build 1.8.0_112-b16)
    Java HotSpot(TM) 64-Bit Server VM (build 25.112-b16, 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-pro-7_6_0.zip
    C:\XMLmind> dir xxe-pro-7_6_0
    ... <DIR> addon
    ... <DIR> bin
    ... <DIR> demo
    ... <DIR> doc
    ...
  3. XXE is intended to be used directly from the xxe-pro-7_6_0/ directory. That is, you can start XXE by simply executing:

    C:\XMLmind> xxe-pro-7_6_0\bin\xxe.exe

    After that, you may want to add a shortcut to "C:\XMLmind\xxe-pro-7_6_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.