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`/.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.

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