2. Deployment of a customization
Prev | Chapter 3. Deployment | Next

## 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`/.xxe5/` on Linux.

   - ``$HOME`/Library/Application Support/XMLmind/XMLEditor5/` on the Mac.

   - ``%APPDATA%`\XMLmind\XMLEditor5\` on Windows XP, Vista, 7 and 8.

     Example: `C:\Documents and Settings\john\Application Data\XMLmind\XMLEditor5\` on Windows XP. `C:\Users\john\AppData\Roaming\XMLmind\XMLEditor5\` on Windows Vista, 7 and 8.

     If you cannot see the "`Application Data`" directory using Microsoft Windows File Manager, turn on Tools>Folder Options>View>File and Folders>Show hidden files and folders.

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[4] `xxe-gui:app/Professional.xxe_gui`, which is a resource contained in `xxe.jar`

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

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

Prev | Up | Next
1. Validation of `.xxe_gui` files | Home | 3. Specifying a base GUI specification other than `xxe-gui:app/Professional.xxe_gui`