Exécution de révisions de code à partir d'une ligne de commande

Il est possible d'exécuter des révisions de code à partir d'une ligne de commande, c'est-à-dire dans un plan de travail dit "non graphique" (headless), sans passer par l'interface graphique de l'environnement de développement. Les règles appliquées pour la révision de code exécutée sur le code source sont celles qui ont été utilisées en dernier dans l'interface utilisateur. Si aucune de révision de code n'a jamais été exécutée dans le plan de travail, les règles appliquées sont celles qui sont définies par défaut sur la page de préférences Java - Révision de code (il s'agit alors de la révision de code rapide). Par défaut, une fois la révisions de code exécutée, deux rapports sont générés : un rapport HTML et un rapport JSML (JScrib Markup Language). Ils sont placés dans le dossier com.ibm.r2a.command.line.mode, lui-même situé sous le dossier metadata de l'espace de travail. Vous avez toutefois la possibilité de spécifier quel type de rapport doit être généré et à quel endroit il doit être placé.

Remarque : Les révisions de code exécutées en mode non graphique ne peuvent porter que sur le plan de travail entier (et non sur un ensemble particulier de projets). Si vous souhaitez analyser un sous-ensemble de l'espace de travail, par exemple un ou plusieurs projets spécifiques, créez un autre espace de travail en y incluant uniquement ces projets et exécutez la révision de code dessus.
Tenez compte des points suivants avant d'exécuter des révisions de code en mode non graphique : Il n'est pas nécessaire que l'environnement de développement soit lancé.

Vous ne pouvez pas lancer simultanément plusieurs révisions de code en mode non graphique sur le même espace de travail ; il n'est pas non plus possible d'utiliser le mode non graphique alors qu'un plan de travail graphique Eclipse verrouille l'espace de travail.

Remarque : En raison des limites du système d'exploitation Windows, la chaîne utilisée pour exécuter le mode ligne de commande (C:\chemin\java.exe …) doit être aussi courte que possible. Faute de quoi, les paramètres figurant à la fin de cette chaîne risquent d'être tronqués et ignorés par le système. Pour obtenir des résultats optimaux, les utilisateurs Windows doivent s'efforcer de mettre en pratique les recommandations suivantes :
  • La variable PATH doit inclure autant de chemins que possible. Par exemple, celui de l'environnement d'exécution Java et le chemin d'accès aux fichiers JAR.
  • Le chemin d'accès à l'espace de travail doit être aussi court que possible. Par exemple, C:\workspace.
  • Le chemin du répertoire où seront placés les rapports générés doit être aussi court que possible. Par exemple, C:\report.
Pour exécuter des révisions de code dans un plan de travail non graphique, vous devez lancer l'application du mode ligne de commande en utilisant la commande <rép_eclipse>/jre/bin/java <options machine virtuelle> -cp <rép_eclipse>/startup.jar org.eclipse.core.launcher.Main <options mode ligne de commande> <options eclipse>, conjointement avec votre configuration de produit. Cette dernière peut être consultée via la sélection Aide > A propos de > Détails de la configuration > Propriétés système. Les <options machine virtuelle> sont situées sous la propriété eclipse.vmargs. Les principales options Eclipse sont situées sous la propriété eclipse.commands, à laquelle vous pouvez ajouter le chemin du plan de travail en utilisant la marque Eclipse -data. Dans l'exemple ci-dessus, la variable <options mode ligne de commande représente les options du mode ligne de commande.
Remarque : Suivant la configuration de votre système d'exploitation, il est possible que vous deviez ajouter des paramètres supplémentaires aux commandes présentées dans les étapes qui suivent. Les paramètres peuvent être consultés dans les détails de la configuration, sous la rubrique "Propriétés système".
Pour exécuter une révision de code dans un plan de travail non graphique :
  1. Ouvrez une fenêtre ou un shell de ligne de commande.
    • Sous Windows, entrez la commande suivante : <rép_eclipse>/jre/bin/java -Xj9 -Dorg.eclipse.swt.browser.internal.flash -Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl -cp <rép_eclipse>/startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -plugincustomization <cheminPersonnalisationPlug-ins> -data <rép_espace_travail> -reportDirectory <répertoire_rapports> -onlyClient CodeReview
    • Sous Linux, entrez la commande suivante : <rép_eclipse>/jre/bin/java -Xj9 -Dorg.eclipse.swt.browser.internal.flash -Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl -cp <rép_eclipse>/startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -os linux -ws gtk -plugincustomization <cheminPersonnalisationPlug-ins> -data <rép_espace_travail -reportDirectory <répertoire_rapports -onlyClient CodeReview
    Remplacez <rép_eclipse> par le chemin du répertoire Eclipse. Il doit s'agir du répertoire Eclipse situé dans le répertoire racine des projets. Remplacez <rép_espace_travail> par le chemin du répertoire de l'espace de travail. Remplacez <cheminPersonnalisationPlug-ins par le chemin de votre fichier pluginCustomization.ini. Ajoutez les éventuelles options supplémentaires à la fin de la ligne de commande. Pour plus d'informations sur les paramètres optionnels, consultez la rubrique de référence relative à l'exécution des révisions de code en mode non graphique. Dans ces commandes :
    • -Xj9 –Dorg.eclipse.swt.browser.internal.flash - Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl correspond aux arguments de machine virtuelle (VM) requis par les produits RASD.
    • -data <rép_espace_travail> -plugincustomization <cheminPersonnalisationPlug-ins correspond aux arguments requis par Eclipse.
    • Les autres arguments concernent l'application du mode ligne de commande (CommandLineModeApplication).
    Si le chemin contient des espaces, encadrez-le de guillemets. Sous Windows, utilisez des barres obliques doubles (\\) au lieu de barres obliques simples. Par exemple : "C:\\Program Files\\IBM\\Rational\\".
  2. Appuyez sur Entrée.
Les résultats de la révision de code sont générés dans un répertoire report situé dans l'espace de travail.
Concepts associés
Révisions de code exécutées en mode non graphique
Référence associée
Référence - Mode non graphique de la révision de code
Révision de code rapide
Conditions d'utilisation | Retours d'informations
(C) Copyright IBM Corporation 2004, 2005. All Rights Reserved.