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 sinalizadores de rastreio é aquele relacionado ao carregamento de classe, porque pode permitir o rastreio de problemas de carregamento de 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.
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.
Para permitir que outros desenvolvedores controlem os sinalizadores de rastreio do plug-in, você precisa tornar essas opções conhecidas. Isso é normalmente feito colocando um arquivo .options no plug-in. O arquivo lista todos os sinalizadores 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.
Criar o arquivo .options apenas define os sinalizadores de disponibilidade, permitindo que outros desenvolvedores de plug-in definam os valores das propriedades de rastreio. Você ainda precisará verificar os valores de suas propriedades de rastreio no código de plug-in utilizando Platform.getDebugOption().