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 de rastreio.options, o PDE fornece uma página de preferência "Rastreio de tempo de execução" que permite que definir os flags de rastreamento e os filtros de nome relacionados ao carregamento.

O rastreio do carregamento da classe de tempo de execução é tratado especialmente desde que seja geral e útil para a maioria dos desenvolvedores de plug-in. O PDE também fornece uma caixa de diálogo genérica para controlar outros flags de rastreamento.  A página de preferência Rastreio avançado mostra todos os plug-ins que suportam o rastreio.  Quando um plug-in estiver selecionado, as opções de rastreio suportadas são mostradas na folha de propriedade. É possível alterar os valores dessas opções de rastreio para plug-ins da área de trabalho e externos.

Se você incluir suporte de rastreio ao plug-in no desenvolvimento, esses valores de rastreio serão mostrados nessa página.

O PDE fornece uma variante de launcher "Workbench de Tempo de Execução" chamado "Workbench de Tempo de Execução com Rastreamento." Esse launcher criará o arquivo consolidado .options com base nas definições de rastreio a partir de Preferências e o passará para a ocorrência da plataforma de tempo de execução. Todas as saídas de rastreio serão mostradas na exibição Console.

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 esse arquivo for salvo, abra a página Preferências->Rastreio Avançado . 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.

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().