Asistentes de contenido del plug-in
Identificador:
org.eclipse.pde.ui.pluginContent
Descripción:
Este punto de extensión
proporciona asistentes colaboradores que crean contenido adicional de los proyectos de
plug-ins del PDE. Una vez se ha creado el manifiesto de plug-in y los archivos de
claves, estos asistentes pueden utilizarse para añadir más archivos y extensiones a la
estructura inicial. Una implementación típica de este asistente añadiría contenido basado
en una plantilla con parámetros personalizada según las elecciones del usuario en el
asistente.
El objetivo es llegar a un plug-in que pueda realizar acciones útiles tras la creación
(por ejemplo, aportar una vista, un editor etc.).
Código de configuración:
<!ELEMENT extension (wizard*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point: identificador totalmente calificado del punto de extensión destino
- id: identificador opcional de la instancia de extensión
- name: nombre opcional de la instancia de extensión
<!ELEMENT wizard (description?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
category CDATA #IMPLIED
ui-content (true | false) "true"
java (true | false) "true"
rcp (true | false) "false"
pureOSGi (true | false) "false"
requiresActivator (true | false) "false">
- id: nombre exclusivo que se empleará para identificar este asistente.
- name: nombre traducible que se utilizará en la representación de UI de este
asistente.
- icon: vía de acceso relativa de un icono utilizado para representar
visualmente el asistente.
- class: nombre totalmente calificado de una clase que implementa
org.eclipse.pde.ui.IPluginContentWizard.
- category: código opcional que puede utilizarse para asociar asistentes de
contenido con distintos proyectos destino.
- ui-content: distintivo que indica si el asistente aportará código con el
contenido de interfaz de usuario. Este distintivo repercutirá sobre qué clase de plug-in
se elegirá (los plug-ins de UI amplían la clase
AbstractUIPlugin
,
mientras que los plug-ins no de UI amplían la clase base Plugin
). Dado
que muchas contribuciones a Eclipse tienen contenido de UI, este atributo es
true
por omisión.
- java: distintivo que indica que el asistente aportará contenido Java. Dado que
la mayoría de plug-ins Eclipse tienen código Java, el atributo es
true
por
omisión. Establézcalo en false
si el plug-in no va a tener código Java (por
ejemplo, sólo archivos de documentación).
- rcp - Desde 3.1. Un indicador booleano que indica si el asistente contribuye a una
aplicación de cliente rico autónoma totalmente funcional. Si se establece en
true
, el
asistente aparecerá en el asistente Proyecto de plug-in nuevo sólo cuando el usuario elija la
opción Aplicación de cliente rico.
- pureOSGi: desde 3.2. Un indicador booleano que indica si el asistente contribuye con un paquete compuesto puro
de OSGi. Si se establece en
true
, el asistente solo aparecerá en el asistente Proyecto de plug-in nuevo
cuando el usuario elija crear un paquete compuesto OSGi puro.
- requiresActivator: desde 3.2. Un indicador booleano que indica si el asistente contribuye con una clase de activador.
Si se establece en
true
, el asistente aparecerá en el asistente Proyecto de plug-in nuevo cuando el
usuario elija generar un activador para controlar el ciclo de vida del plug-in.
<!ELEMENT description (#PCDATA)>
Breve descripción de este asistente.
Ejemplos:
Este es un ejemplo de este punto de extensión:
<extension point=
"org.eclipse.pde.ui.pluginContent"
>
<wizard
name=
"Example Plug-in Content Generator"
icon=
"icons/content_wizard.gif"
class=
"com.example.xyz.ContentGeneratorWizard"
id=
"com.example.xyz.ExampleContentGenerator"
>
<description>
Añade una vista y una página de preferencias.
</description>
</wizard>
</extension>
Información sobre la API:
Los asistentes que
se conectan a este punto de extensión deben implementar la interfaz
org.eclipse.pde.ui.IPluginContentWizard y se espera que amplíen
org.eclipse.jface.wizard.Wizard
.
Implementación suministrada:
El PDE proporciona
APIs para aportar asistentes de contenido basándose en plantillas personalizables. La
propia UI del PDF aporta una serie de asistentes concretos basados en estas plantillas.
Copyright (c) 2004 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están
disponibles bajo los términos de la licencia pública común (Eclipse Public
License) v1.0 que acompaña a esta distribución, y está disponible en
http://www.eclipse.org/legal/epl-v10.html