2. Deployment of a customization

The GUI customization created during this tutorial tutorial7.xxe_gui is used here as an example:

  1. Rename tutorial7.xxe_gui to customize.xxe_gui.

    Using this name if mandatory if you want XXE to dynamically discover your GUI customization during its start-up.

  2. Copy directory XXE_install_dir/doc/gui/tutorial/ and all its content (which now includes customize.xxe_gui) to directory XXE_user_preferences_dir/addon/.

    XXE user preferences directory is:

    • $HOME/.xxe4/ on Linux.

    • $HOME/Library/Application Support/XMLmind/XMLEditor4/ on the Mac.

    • %APPDATA%\XMLmind\XMLEditor4\ on Windows 2000, XP, Vista.

      Example: C:\Documents and Settings\john\Application Data\XMLmind\XMLEditor4\ on Windows 2000 and XP. C:\Users\john\AppData\Roaming\XMLmind\XMLEditor4\ on Windows Vista.

  3. Restart XXE as you usually do it.

    Here what happens when XXE is started:

    1. The editor collects all files called customize.xxe_gui found in either of its two addon/ directories.

    2. It merges their contents with its base GUI specification. The base GUI specification is by default[5] xxe-gui:app/Professional.xxe_gui, which is a resource contained in xxe_app.jar

    3. It creates its GUI according to this combined specification.



[5] See below how this default can be changed.