# Global Install Handlers

###### Identifier:

org.eclipse.update.core.installHandlers

###### 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

###### Examples:

The following is an example of new global install handler registration:

       <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.

Copyright (c) 2004 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html.