Using the extension builder

The ICE toolbar extension is built using the ICE extension builder, to run the builder:

>> cd ice/trunk/templates/ice

>> python utils/extensionBuilder.py $version $type

For help:

>> python utils/extensionBuilder.py --help

Options

version

Version number of the extension, this is displayed in the OOo extension manager and is used by OOo for updating.

The number to use will depend on the level of changes made. For example, if the current version is 1.0.0 a bug fix would make it 1.0.1, a new feature 1.1.0 and a major change 2.0.0.

type

The type of release either, 'dev' (default) or stable.

'dev':

• Toolbar name displayed in the OOo extension manager is “ICE Style Toolbar (dev)”.

• The toolbar is built in ice/trunk/templates/ice/ooo (main development area)

• Files modified:

  ooo/ice-toolbar/description.xml

  ooo/ice.update.xml

  ooo/ice-toolbar.oxt

'stable':

• Toolbar name displayed in the OOo extension manager is “ICE Style Toolbar”.

• The toolbar is built in ice/downloads/latest/templates/ (main area for download stable versions)

• Files modified:

  ooo/ice-toolbar/description.xml

  ice/downloads/latest/templates/ice.update.xml

  ice/downloads/latest/templates/ice-toolbar.oxt

Make changes

1. Update the required files:

   >> svn up ice/trunk/templates/ice

   >> svn up ice/downloads/latest/templates

2. Remove the ICE toolbar extension using the OOo extension manager and restart OOo

3. Install the ICE toolbar extension from ice/trunk/templates/ice/ooo/ice-toolbar.oxt (Important: This ensures the extension has the latest changes from the macro text files i.e. toolbar.txt)

4. Make the changes to the installed extension:

   • If the toolbar macros require changes then go to:

     1. Tools > Macros > Oganize Macros > OOo Basic

     2. Select My Macros > IceLibrary > (select module)

     3. Select the macro & make the changes

     4. Test the changes

        Important: Copy the any changes into appropriate text file i.e. changes to 'toolbar' module need to be copied into ice/trunk/templates/ice/macros/toolbar.txt

   • If a dialog requires changes then:

     1. Tools > Macros > Ogranize Dialogs

     2. Make the changes

     3. Test the changes

     4. Tools > Macros > Oganize Dialogs & open the dialog

     5. Click export then navigate to ice/trunk/templates/ice/ooo/ice-toolbar/IceLibrary and override the existing dialog

5. Rebuild the extension:

   >> cd ice/trunk/templates/ice

   Developers version, run:

   >> python utils/extensionBuilder.py $version dev

   Stable version, run:

   >> python utils/extensionBuilder.py $version stable

   Important: Before building or committing a stable version be sure you have the dev version (with the same changes) committed first and that it has been tested by a second person.

6. Remove the previous toolbar using the extension manager and restart OOo

7. Install the updated extension and re-test

Release changes

Provided testing has been completed ok SVN commit required files modified in:

ice/trunk/templates/ice
ice/downloads/latest/templates (NB: Only required if the stable version was built)