When you have a new version of a widget deployed client
plug-in, use this procedure to update the update site and the deployment
widget's XML attachment in the widgets catalog.
About this task
Feature updates are provisioned to the user automatically
provided that you have properly updated and signed the contents of
your feature update site, properly updated the widget's extension.xml file
by incrementing the version= setting in the requirements
section of the extension.xml, and updated the
version number in the feature's Eclipse update site site.xml file
to match the widget's extension.xml file's feature version= setting.
The
updated widget and plug-in will be provisioned when the user's local
widgets catalog is updated (either manually or on their defined replication
schedule).
Note: Your client plug-in update procedure depends
on whether you installed the client using an add-on installer or using
the widget deployment method presented here. You should not swap methods
when updating from one version to another.
Note: For related
information, see the topic Deploying client plug-ins with widgets
and the widget catalog.
Procedure
- Obtain the updated feature's Eclipse updateSite and copy
it to your local computer.
- Update you existing update site with the new feature. If
using a Notes-based update site, update (reimport) the updated feature's
Eclipse updateSite into your Notes-based update site (updatesite.nsf)
by opening your updatesite.nsf, clicking Import
Local Update Site and specifying the updated feature's
Eclipse updateSite/site.xml.
- Open the widgets catalog. For example, click the Browse
the Widget Catalog option in the My Widgets sidebar panel
toolbar to open the catalog specified in the Widgets preference panel.
- Double-click the deployment widget name in the widgets
catalog to open the widget document, and then click Edit.
- In the Attachments section of the widget document, right-click
the extension.xml file and save the file locally.
Open the file in an XML editor.
Note: Edit the extension.xml content
to match the correct version= setting in the installfeature section
of the updated feature.
- Save and exit the extension.xml file.
- In the widget document, click the Remove button
to remove the attachment. Then click the Attach button
to attach the new file created in step 6.
- Save and close the widget document.