Révisions du code à partir d'une ligne de commande

Vous pouvez exécuter des révisions de code dans un plan de travail sans interface (sans interface utilisateur pour l'environnement de développement) à partir d'une interface de ligne de commande. Les règles de révision de code dont fait l'objet le code source sont les dernières utilisées dans l'interface utilisateur. Si une révision de code n'a jamais été exécutée, les paramètres par défaut de la page Java preferences – Code Review (révision de code rapide) sont exécutés. Par défaut, une fois la révision de code exécutée, deux rapports sont générés : un rapport HTML et un rapport JSML (JScrib Markup Language). Ces deux rapports se trouvent dans le dossier de métadonnées de l'espace de travail, dans le dossier com.ibm.r2a.command.line.mode. Vous pouvez préciser le type de rapport généré et l'emplacement dans lequel les rapports vont apparaître après la révision de code.

Remarque : Vous pouvez exécuter des révisions de code en mode sans interface uniquement sur l'espace de travail. Si vous souhaitez analyser un sous-ensemble de l'espace de travail (un ou plusieurs projets spécifiques, par exemple), créez un espace de travail comportant ces projets et exécutez la révision de code sur cet espace de travail.
Avant d'exécuter des révisions de code en mode sans interface : Il est inutile de lancer l'environnement de développement.

Vous ne pouvez pas exécuter simultanément plusieurs révision de code en mode sans interface sur le même espace de travail, ni utiliser le mode sans interface lorsqu'une interface utilisateur graphique Eclipse a verrouillé l'espace de travail.

Remarque : En raison des limitations du système d'exploitation Windows, la longueur de la chaîne utilisée pour exécuter le mode ligne de commande (C:\path\java.exe …) doit être aussi courte que possible. Sinon, le système risque de couper et de perdre les paramètres placés à la fin de la chaîne. Il est conseillé aux utilisateurs de Windows d'utiliser les meilleures pratiques suivantes pour obtenir des résultats optimaux :
  • La variable PATH doit contenir autant de chemins d'accès que possible (le chemin d'accès Java et celui des fichiers JAR, par exemple).
  • Le chemin d'accès à l'espace de travail doit être aussi court que possible (C:\workspace, par exemple).
  • Le chemin d'accès à l'emplacement dans lequel sont générés les rapports doit également être aussi court que possible (C:\report, par exemple).
Pour exécuter des révisions de code dans un plan de travail sans interface, vous devez lancer l'application en mode ligne de commande grâce à 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> ainsi que la configuration de votre produit. Vous pouvez trouver la configuration de votre produit sous Help > About > Configuration Details > System properties. La variable <options machine virtuelle> se trouve sous la propriété eclipse.vmargs. Les principales options Eclipse se trouvent sous la propriété eclipse.commands, à laquelle vous pouvez ajouter le chemin d'accès à l'espace de travail grâce au jeton Eclipse -data. La variable <options mode ligne de commande> fait référence aux options en mode ligne de commande.
Remarque : Vous pouvez ajouter des paramètres aux commandes en suivant la procédure ci-dessous, selon la configuration de votre système d'exploitation. Les paramètres se trouvent dans les détails de configuration du système, sous "Propriétés du système".
Pour exécuter une révision de code dans un plan de travail sans interface, procédez comme suit :
  1. Ouvrez une fenêtre de ligne de commande ou shell.
    • Pour 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 <pluginCustomizationPath> -data <rép_espace de travail> -reportDirectory <votre_répertoire_de_rapport> -onlyClient CodeReview
    • Pour 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 <pluginCustomizationPath> -data <rép_espace de travail> -reportDirectory <votre_répertoire_rapport> -onlyClient CodeReview
    Remplacez <rép_eclipse> par le chemin d'accès au répertoire Eclipse. Ce répertoire Eclipse doit se trouver dans le répertoire racine du projet. Remplacez <rép_espace de travail> par le chemin d'accès au répertoire de l'espace de travail. Remplacez <CheminpluginCustomization> par le chemin d'accès de votre fichier pluginCustomization.ini. Ajoutez des options supplémentaires à la fin de la ligne de commande. Pour obtenir des informations relatives aux paramètres facultatifs, voir la référence connexe pour le mode sans interface de la révision de code. 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 la machine virtuelle requis par les produits RASD.
    • -data <rép_espace de travail> -plugincustomization <CheminpluginCustomization> correspond aux arguments Eclipse requis.
    • Les autres arguments sont relatifs à l'application pour le mode ligne de commande.
    Utilisez les guillemets si le chemin d'accès contient des espaces. Si vous utilisez Windows, utilisez les doubles barres obliques inversées (\\) à la place de la barre oblique inversée normale. 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 sans interface
Référence associée
Référence du mode sans interface de révision de code
Révision de code rapide
Conditions d'utilisation | Retours d'informations
(C) Copyright IBM Corporation 2004, 2005. All Rights Reserved.