Upgrading Plug-ins

To create an upgrade:

  1. Increment the number of the version attribute of the <identifier> element in plugin.xml.

  2. Create a <migrate> element in upgrade.xml with a to-version attribute containing the new number.

  3. Place the property and step-type elements that match the updated plugin.xml file within this element, as shown in the following example.

<?xml version="1.0" encoding="UTF-8"?>
  <migrate to-version="3">
    <migrate-command name="Run SQLPlus script">
        <migrate-property name="sqlFiles" old="sqlFile"/>
  <migrate to-version="4">
    <migrate-command name="Run SQLPlus script" />
  <migrate to-version="5">
    <migrate-command name="Run SQLPlus script" />

Of course, you can also make a script-only upgrade, that is, an upgrade that contains changes to the step's associated scripts and files but does not change plugin.xml. This mechanism can be useful for plug-in development and for minor bug-fixes/updates.