Assistentes de Conteúdo de Plug-ins
Identificador:
org.eclipse.pde.ui.pluginContent
Descrição:
Este ponto de extensão faculta assistentes em contributos que criam mais conteúdo dos projectos de plug-in do PDE. Depois de se criarem os ficheiros de manifestos de plug-in e ficheiros essenciais, podem utilizar-se estes assistentes para adicionar mais ficheiros e extensões à estrutura inicial. Uma implementação típica deste assistente adicionaria conteúdo, baseado num modelo parametrizado, e personalizado com base nas escolhas do utilizador, efectuadas no assistente.
O objectivo consiste em chegar a um plug-in que realize algo útil depois da criação (p.ex., contribuir com uma vista, um editor, etc.). .
Marcação de Configuração:
<!ELEMENT extension (wizard*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador totalmente qualificado do ponto de extensão de destino
- id - um identificador opcional da instância de extensão
- name - um nome opcional da instância de extensão
<!ELEMENT assistente (descrição?)>
<!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 - nome único que será usado para identificar este assistente.
- nome - nome traduzível que será usado na representação UI deste assistente.
- ícone - caminho relativo de um ícone que será usado para representar visualmente o assistente.
- classe - nome totalmente qualificado de uma classe que implementa org.eclipse.pde.ui.IPluginContentWizard.
- categoria - controlo opcional que pode ser usado para associar assistentes de conteúdo a diferentes projectos destino.
- conteúdo-ui - sinalizador que indica se o assistente irá contribuir com código que tenha conteúdo de interface de utilizador. Este sinalizador afectará qual a classe de plug-in que será escolhida (dado que plug-ins UI expandem a classe
AbstractUIPlugin
, ao passo que plug-ins alheios à UI expandem a classe base Plugin
). Visto que muitos contributos para o Eclipse tem conteúdo UJI, este atributo é true
por predefinição.
- java - sinalizador que indica que o assistente irá contribuir com conteúdo Java. Dado que a maioria dos plug-ins Eclipse tem código Java, o atributo é
true
por predefinição. Defina-o como false
se o plug-in não tiver código Java (por exemplo, ficheiros de documentação somente).
- rcp - Desde a versão 3.1. Sinalizador booleano que indica se o assistente contribui ou não com uma aplicação de cliente complexo, em funcionamento integral e autónoma. Se definido como
true
, o assistente aparecerá no assistente Novo Projecto de Plug-in somente quando o utilizador escolher a opção Aplicação Cliente Complexo.
- pureOSGi - Desde a versão 3.2. Sinalizador booleano que indica se o
assistente contribui ou não com um agrupamento OSGi puro.
Se definido como
true
, o assistente aparecerá no assistente Novo
Projecto de Plug-in somente quando o utilizador escolher a opção de criar um agrupamento OSGi puro.
- requiresActivator - Desde a versão 3.2. Sinalizador booleano que indica se o
assistente contribui ou não com uma classe activadora.
Se definido como
true
, o assistente aparecerá no assistente Novo
Projecto de Plug-in somente quando o utilizador escolher a opção de gerar um
activador para controlar o ciclo de vida do plug-in.
<!ELEMENT description (#PCDATA)>
Breve descrição deste assistente.
Exemplos:
De seguida é apresentado um exemplo deste ponto de extensão:
<extension point=
"org.eclipse.pde.ui.pluginContent"
>
<wizard
name=
"Gerador de Conteúdo de Plug-ins Exemplo"
icon=
"icons/content_wizard.gif"
class=
"com.example.xyz.ContentGeneratorWizard"
id=
"com.example.xyz.ExampleContentGenerator"
>
<description>
Adiciona uma vista e uma página de preferências.
</description>
</wizard>
</extension>
Informação de API:
Os assistentes que se ligarem a este ponto de extensão devem implementar a interface org.eclipse.pde.ui.IPluginContentWizard, e espera-se que expandam org.eclipse.jface.wizard.Wizard
.
Implementação Facultada:
O PDE faculta APIs para contribuir com assistentes de conteúdo baseados em modelos personalizáveis. A UI do PDE já contribui com alguns assistentes concretos baseados nestes modelos.
Copyright (c) 2004 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham estão disponíveis sob os termos da Eclipse Public License v1.0 que acompanha esta distribuição e está disponível em http://www.eclipse.org/legal/epl-v10.html.