Executando com Rastreamento

A plataforma fornece um mecanismo para rastrear a atividade do seu plug-in em tempo de execução sem depuração completa. Ele permite que você utilize flags de rastreamento que farão com que as informações de rastreio sejam impressas na saída padrão (ou exibição Console). Esses flags são definidos em arquivos com nome ".options" e têm a seguinte sintaxe:

   <plug-in Id>/debug = true/false  (opção mestre)
   <plug-in Id>/<tracing flag> = <value>

A primeira entrada representa a opção mestre para rastrear o plug-in. Se você chamar o método isDebugging na classe de plug-in, ele retornará verdadeiro se o valor dessa variável de rastreio for verdadeiro. Outros flags de rastreamento são definidos por você e seus valores podem ser obtidos utilizando

   Platform.getDebugOption(optionName);

A maioria dos plug-ins de plataforma define os flags de rastreamento, particularmente o núcleo da plataforma. Para um novo desenvolvedor de plug-in, o conjunto mais interessante de flags de rastreamento é aquele relacionado à classe que está sendo carregada, porque pode permitir o rastreio de problemas ao carregar o plug-in. 

Para suportar o rastreio sem a necessidade de editar os arquivos .options de rastreio, o PDE fornece uma guia "Rastreio do Tempo de Execução" no diálogo de lançamento. Todas as definições de rastreio são salvas na configuração de lançamento. Isso significa que você pode criar várias configurações com opções de rastreio diferentes e alternar entre elas.

Launcher do workbench do tempo de execução - rastreio

Se você incluir suporte de rastreio no plug-in em desenvolvimento, seus plug-ins aparecerão na lista de plug-ins que suportam rastreio (no grupo de Plug-ins da Área de Trabalho) e as propriedades de rastreio aparecerão na folha de propriedade.

Exemplo:  incluindo suporte de rastreio para o plug-in

Para permitir que outros desenvolvedores controlem os flags de rastreamento do plug-in, é necessário conhecer essas opções.  Isso normalmente é feito colocando um arquivo .options no plug-in.  O arquivo relaciona todos os flags suportados, bem como seus valores padrão. O PDE detectará imediatamente esse arquivo e o incluirá na lista de "Plug-ins da Área de Trabalho" na página de preferências de rastreio avançado.

Definiremos agora um arquivo de gabarito .options com poucos flags de rastreamento para nosso novo plug-in.

Selecione o projeto com.example.xyz criado anteriormente e crie um novo arquivo .options. Quando o editor de texto padrão abrir, inclua as seguintes entradas:

com.example.xyz/debug = true    com.example.xyz/debug/flag = true    com.example.xyz/debug/filter = *

Quando este arquivo for salvo, selecione Executar->Executar..., para abrir o diálogo de lançamento. Nosso plug-in deve ser mostrado agora em "Plug-ins da Área de Trabalho". Quando selecionado, deveria mostrar os flags definidos recentemente com seus valores padrão.

Launcher do Workbench do Tempo de Execução - exemplo de rastreio

Criar o arquivo .options somente define os flags disponíveis, permitindo que outros desenvolvedores de plug-in definam os valores das propriedades de rastreio.  Você ainda precisará verificar os valores das propriedades de rastreio no código do plug-in utilizando Platform.getDebugOption().

Copyright IBM Corporation e outros 2000, 2002