Exécution avec la fonction de trace

La plateforme fournit un mécanisme de suivi de l'activité d'exécution du plug-in sans débogage complet. Vous pouvez ainsi utiliser des indicateurs de trace afin d'afficher des informations de trace à la sortie standard (ou vue Console). Ces indicateurs, définis dans des fichiers ".options", ont la syntaxe suivante :

   <plug-in Id>/debug = true/false  (commutateur principal)
   <plug-in Id>/<indicateur de trace> = <valeur>

La première entrée représente le commutateur principal de trace du plug-in. Si vous appelez la méthode isDebugging dans votre classe de plug-in et que la variable de trace a pour valeur true, cette méthode retournera true. Vous pouvez définir d'autres indicateurs dont la valeur est obtenue à l'aide de

   Platform.getDebugOption(nomOption);

La plupart des plug-in de plateforme définissent des indicateurs de trace, en particulier l'API principale de la plateforme. Si vous débutez dans le développement de plug-in, le groupe d'indicateurs de trace le plus intéressant concerne le chargement des classes, car ceux-ci permettent de détecter les problèmes de chargement des plug-in.

Lanceur du plan de travail d'exécution - traçage

Exemple : Ajout du support de trace à votre plug-in

Si vous ajoutez le support de trace au plug-in en cours de développement, vos plug-in apparaîtront dans la liste des plug-in qui prennent en charge cette fonction.

Pour permettre à d'autres développeurs de contrôler les indicateurs de trace de votre plug-in, vous devez rendre publiques ces options.  Pour cela, il suffit de placer un fichier .options dans le plug-in.  Le fichier dresse la liste de tous les indicateurs pris en charge ainsi que leurs valeurs par défaut.

Nous allons à présent définir un modèle de fichier .options comportant quelques indicateurs de trace pour le nouveau plug-in.

Sélectionnez le projet com.example.xyz créé précédemment, puis créez un fichier .options. Dans l'éditeur de texte par défaut, ajoutez les lignes suivantes :

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

Lorsque ce fichier est sauvegardé, sélectionnez Exécuter > Exécuter pour ouvrir la boîte de dialogue de lancement. Le plug-in doit apparaître dans la liste. Lorsque vous le sélectionnez, il doit afficher les indicateurs que vous venez de définir ainsi que leurs valeurs par défaut.

Lanceur du plan de travail d'exécution - exemple de traçage

Le fichier .options ne définit que les indicateurs de disponibilité, ce qui permet à d'autres développeurs de plug-in de définir les valeurs des propriétés de trace.  Vous devrez vérifier ces valeurs dans le code de votre plug-in à l'aide de la fonction Platform.getDebugOption().