La plataforma proporciona un mecanismo para rastrear la actividad del conector durante la ejecución sin tener que depurarlo. Permite utilizar distintivos de rastreo que harán que se imprima información de rastreo en la salida estándar (o en la vista Consola). Estos distintivos se definen en archivos llamados ".options" y tienen esta sintaxis:
<plug-in Id>/debug = true/false (conmutador maestro)
<plug-in Id>/<tracing flag> = <value>
La primera entra representa el conmutador maestro para rastrear el conector. Si en la clase del conector se llama al método isDebugging, devolverá true si el valor de está variable de rastreo también es true. Usted puede definir otros distintivos de rastreo y sus valores pueden obtenerse utilizando
Platform.getDebugOption(optionName)";
La mayoría de los conectores de la plataforma definen distintivos de rastreo, en particular el principal de la plataforma. Para un desarrollador de conectores nuevos, el conjunto de distintivos de rastreo más interesante son aquellos relacionados con la carga de las clases, ya que pueden permitir rastrear los problemas de carga de conectores.
Con el fin de permitir el rastreo sin necesidad de editar los archivos .options de rastreo, el PDE proporciona una página de preferencias "Rastreo durante la ejecución" que permite establecer los distintivos de rastreo y los filtros de nombres relacionados con la carga.
El rastreo de la carga de clases durante la ejecución se trata de manera especial puesto que es general y práctico para la mayor parte de los desarrolladores de conectores. El PDE también proporciona un cuadro de diálogo genérico para controlar otros distintivos de rastreo. La página de preferencias muestra todos los conectores que admiten el rastreo. Cuando se selecciona un conector, las opciones de rastreo admitidas se muestran en la hoja de propiedades. Los valores de estas opciones de rastreo para conectores del área de trabajo y externos pueden cambiarse.
Si se añade soporte de rastreo al conector que se está desarrollando, estos valores de rastreo podrán verse en esta página.
El PDE proporciona una variante del lanzador "Entorno de trabajo de ejecución" llamada "Entorno de trabajo de ejecución con rastreo." Este lanzador creará el archivo .options consolidado basado en los valores de rastreo de las preferencias y se lo pasará a la instancia de la plataforma de ejecución. Toda la salida de rastreo se verá en la vista Consola.
Para permitir controlar los distintivos de rastreo del conector a otros desarrolladores, hay que hacer públicas esas opciones. Esto suele hacerse poniendo el archivo .options en el conector. El archivo lista todos los distintivos admitidos, así como sus valores por omisión. El PDE detectará inmediatamente este archivo y lo incluirá en la lista de "Conectores del área de trabajo" en la página de preferencias de rastreo avanzado.
Ahora pasaremos a definir un archivo .options que puede servir de plantilla con unos cuantos distintivos para nuestro conector nuevo.
Seleccione el proyecto com.example.xyz que hemos creado antes y cree un archivo .options nuevo. Cuando se abra el editor de texto por omisión, añada las entradas siguientes:
com.example.xyz/debug = true
com.example.xyz/debug/flag = true
com.example.xyz/debug/filter = *
Tras guardar el archivo, abra la página Preferencias->Rastreo avanzado. Ahora podremos ver nuestro conector se verá en "Conectores del área de trabajo". Al seleccionarlo debería mostrar los distintivos que acabamos de definir con sus valores por omisión.
Crear el archivo .options solo define la disponibilidad de los distintivos, lo que permite a otros desarrolladores de conectores definir los valores de las propiedades de rastreo. Seguiremos necesitando comprobar los valores de las propiedades de rastreo del código del conector utilizado Platform.getDebugOption().