To create an upgrade, first, increment the number of the version attribute of the <identifier> element in plugin.xml. Next, create a
<migrate> element in upgrade.xml with a to-version attribute containing the new number. Finally, 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"?>
<plugin-upgrade
xmlns="http://www.&company;.com/UpgradeXMLSchema_v1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<migrate to-version="3">
<migrate-command name="Run SQLPlus script">
<migrate-properties>
<migrate-property name="sqlFiles" old="sqlFile"/>
</migrate-properties>
</migrate-command>
</migrate>
<migrate to-version="4">
<migrate-command name="Run SQLPlus script" />
</migrate>
<migrate to-version="5">
<migrate-command name="Run SQLPlus script" />
</migrate>
</plugin-upgrade>
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.
