Tipos de Configuração de Lançamento
Identificador:
org.eclipse.debug.core.launchConfigurationTypes
Descrição:
Este ponto de extensão faculta um mecanismo configurável para lançar aplicações.
Cada tipo de configuração de lançamento possui um nome, suporta um ou mais nós (execução e/ou depuração) e especifica um responsável delegado pela implementação do lançamento de uma aplicação.
A partir da versão 3.2, os tipos podem também definir um delegado de migração
que pode ser utilizado para definir correlações de recursos entre projectos e
as configurações de lançamento que as iniciam.
Marcação da Configuração:
<!ELEMENT extension (launchConfigurationType*)>
<!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 launchConfigurationType (fileExtension+)>
<!ATTLIST launchConfigurationType
id CDATA #REQUIRED
delegate CDATA #REQUIRED
modes CDATA #REQUIRED
name CDATA #REQUIRED
public (true | false)
category CDATA #IMPLIED
sourcePathComputerId CDATA #IMPLIED
sourceLocatorId CDATA #IMPLIED
migrationDelegate CDATA #IMPLIED>
- id - especifica um identificador exclusivo para este tipo de configuração de lançamento.
- delegate - especifica o nome totalmente qualificado da classe Java que implementa
ILaunchConfigurationDelegate
.
As instâncias-objecto de configuração de lançamento deste tipo irão delegar a execução do lançamento a instâncias-objecto desta classe.
- modes - especifica uma lista separada por vírgulas dos modos que este tipo de configuração de lançamento suporta - "run" e/ou "debug".
- name - especifica um nome, legível pelos utilizadores, para este tipo de configuração de lançamento.
- public - especifica se os utilizadores podem aceder a este tipo de configuração de lançamento. Caso não seja especificado, é utilizado
true
.
- category - um atributo opcional que especifica a categoria deste tipo de configuração de lançamento. O valor, por predefinição, não está especificado (
null
). As categorias são definidas pelo cliente. Este atributo foi adicionado na edição 2.1.
- sourcePathComputerId - O identificador exclusivo de uma extensão sourcePathComputer que é utilizada para calcular um caminho de busca de origem predefinido para as configurações de lançamento deste tipo. Este atributo foi adicionado na edição 3.0.
- sourceLocatorId - O identificador exclusivo de uma extensão de sourceLocator, que é utilizada para criar o localizador origem de sessões iniciadas utilizando configurações de lançamento deste tipo. Este atributo foi adicionado na edição 3.0.
- migrationDelegate - Delegado opcional utilizado para migrar
configurações de lançamento deste tipo para que se tornem compatíveis com as
ferramentas actuais, a partir da versão 3.2
<!ELEMENT fileExtension EMPTY>
<!ATTLIST fileExtension
extension CDATA #REQUIRED
default (true | false) >
- extension - especifica uma extensão de ficheiro para a qual este tipo de configuração de lançamento pode ser utilizado.
- default - especifica se este tipo de configuração de lançamento deve ser o tipo de configuração de lançamento predefinido para a extensão de ficheiro especificada. Caso não seja especificado, é utilizado
false
.
Exemplos:
De seguida apresenta-se um exemplo de um ponto de extensão de tipo de configuração de lançamento.
<extension point=
"org.eclipse.debug.core.launchConfigurationTypes"
>
<launchConfigurationType
id=
"com.example.ExampleIdentifier"
delegate=
"com.example.ExampleLaunchConfigurationDelegate"
modes=
"run,debug"
name=
"Example Application"
>
<fileExtension extension=
"txt"
default=
"true"
/>
<fileExtension extension=
"gif"
default=
"false"
/>
</launchConfigurationType>
</extension>
No exemplo anterior, o tipo de configuração de lançamento especificado suporta modos de execução e depuração.
A configuração de lançamento é aplicável a ficheiros .txt e .gif e é a configuração de lançamento predefinida de ficheiros .txt.
Informações de API:
O valor do atributo delegate tem de ser um nome totalmente qualificado de uma classe Java que implemente a interface org.eclipse.debug.core.model.ILaunchConfigurationDelegate.
Copyright (c) 2000, 2005 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ão disponíveis em http://www.eclipse.org/legal/epl-v10.html