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. 

Pour prendre en charge la fonction de trace sans que vous ayez à éditer les fichiers .options, PDE propose un onglet "Trace de l'exécution" dans la boîte de dialogue de lancement. Tous les paramètres de trace sont sauvegardés dans la configuration de lancement. Vous pouvez donc créer plusieurs configurations avec différentes options de trace et passer de l'une à l'autre.

Programme de lancement du plan de travail d'exécution - Trace

Si vos ajoutez le support de trace au plug-in en cours de développement, vos plug-in apparaîtront dans la liste des plug-in prenant en charge les traces (dans le groupe Plug-in du plan de travail) et vos propriétés de trace apparaîtront dans la page des propriétés.

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

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. PDE détectera automatiquement ce fichier et le fera figurer dans la liste "Plug-in de l'espace de travail" de la page des préférences de la fonction de trace avancée.

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 sous "Plug-in de l'espace de travail". Lorsque vous le sélectionnez, il doit afficher les indicateurs que vous venez de définir ainsi que leurs valeurs par défaut.

Programme de lancement du plan de travail d'exécution - Exemple de trace

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

 
Copyright IBM Corporation and others 2000, 2003