Ativador (Obsoleto)
Identificador:
org.eclipse.debug.core.launchers
Descrição:
Este ponto de extensão foi substituído pelo ponto de extensão launchConfigurationTypes. As extensões desse tipo estarão obsoletas a partir do release 2.0 e serão ignoradas. Esse ponto de extensão foi utilizado para contribuir com ativadores.
Um ativador era responsável pela inicialização de uma sessão de depuração ou pela execução de um programa e pelo registro do resultado com o gerenciador de ativação.
Marcação de Configuração:
<!ELEMENT extension (launcher*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador completo 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 launcher EMPTY>
<!ATTLIST launcher
id CDATA #REQUIRED
class CDATA #REQUIRED
modes CDATA #REQUIRED
label CDATA #REQUIRED
wizard CDATA #IMPLIED
public (true | false)
description CDATA #IMPLIED
perspective CDATA #IMPLIED
icon CDATA #IMPLIED>
- id - um identificador exclusivo que pode ser utilizado para fazer referência a esse Ativador.
- class - o nome completo da classe que implementa org.eclipse.debug.core.model.ILauncherDelegate.
- modes - uma lista separada por vírgula dos modos suportados por esse ativador. Os dois modos suportados são "executar" e "depurar" - conforme definido em org.eclipse.debug.core.ILaunchManager.
Um ativador pode executar a ativação em um ou em ambos os modos.
- label - uma etiqueta para ser utilizada pelo ativador.Esse atributo é utilizado pela UI de depuração.
- wizard - nome completo da classe que implementa org.eclipse.debug.ui.ILaunchWizard.Esse atributo é utilizado pela UI de depuração. Um ativador pode contribuir com um assistente que permite aos usuários configurar e lançar atributos específicos.
- public - indica se um ativador está publicamente visível na UI de depuração. Se for "true", o ativador estará disponível na UI de depuração - o ativador aparecerá como uma opção para um ativador padrão. As ativações criadas por esse ativador aparecerão no histórico de ativação e o ativador estará disponível nas ações executar/depurar da barra de ferramentas do menu drop down.
- description - uma descrição do ativador. Atualmente, só será utilizado se o atributo wizard for especificado.
- perspective - o identificador da perspectiva que será comutado em uma ativação bem-sucedida. O valor padrão será o identificador da perspectiva de depuração. Esse atributo é utilizado pela UI de depuração.
- icon - um caminho relativo de um ícone que representará o ativador na UI, se especificado.
Exemplos:
A seguir, um exemplo de um ponto de extensão de um ativador:
<extension
point =
"org.eclipse.debug.core.launchers"
>
<launcher
id =
"com.example.ExampleLauncher"
class =
"com.example.launchers.ExampleLauncher"
modes =
"run, debug"
label =
"Example Launcher"
wizard =
"com.example.launchers.ui.ExampleLaunchWizard"
public =
"true"
description =
"Launches example programs"
perspective=
"com.example.JavaPerspective"
>
</launcher>
</extension>
No exemplo acima, o Ativador especificado suporta os modos de execução e depuração.
Após uma ativação bem-sucedida, a UI de depuração será alterada para a perspectiva Java. Quando a UI de depuração apresentar ao usuário uma lista de ativadores a serem escolhidos, "Example Ativador" aparecerá como uma das opções com "Launches example programs" como descrição e o assistente especificado por com.example.launchers.ui.ExampleLaunchWizard será utilizado para configurar detalhes específicos da ativação.
Informações sobre API:
O valor do atributo class deve ser um nome completo de uma classe Java que implementa a interface org.eclipse.debug.core.ILauncherDelegate.
O valor do atributo
wizard deve ser o nome completo de uma classe Java que
implementa org.eclipse.debug.ui.ILaunchWizard.
Copyright (c) 2000, 2003 IBM Corporation e outros.
Todos os direitos reservados.
Este programa e os materiais que o acompanham são disponibilizados sob os termos da Common Public License v1.0 que acompanha esta distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/cpl-v10.html