Global Install Handlers

Description: Extension point for registering global install handlers. Global install handlers can be referenced by features (using the <feature> <install-handler> tags) without having to include a copy of the handler code as part of the downloadable feature.

Configuration Markup:

   <!ELEMENT extension (install-handler+)>

   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

• point - must be specified as org.eclipse.update.core.installHandlers
• id - must be specified. Identifies the new install handler
• name - optional displayable label for the new install handler

   <!ELEMENT install-handler EMPTY>

   <!ATTLIST install-handler
     class CDATA #REQUIRED
   >

• class - fully qualified name of the handler implementation class for the identified install handler

   <extension
        id="custom"
        point="org.eclipse.update.core.installHandlers"
        name="Custom install handler">
     <install-handler
        class="com.xyz.update.CustomInstallHandler">
     </install-handler>
   </extension>

API Information: Registered install handler classes must implement org.eclipse.update.core.IInstallHandler interface. Implementers should extend base class org.eclipse.update.core.BaseInstallHandler.

Supplied Implementation: The platform supplies a simple install handler that is registered as org.eclipse.update.core.DefaultInstallHandler. If used, it will copy any non-plug-in data entries provided with the feature into the feature installation directory.