Révisions de code exécutées en mode non graphique

Il est possible d'exécuter des révisions de code sur des fichiers source Java à partir d'une ligne de commande (c'est-à-dire sans passer par l'interface graphique de l'environnement de développement). Ce procédé est utile si vous souhaitez exécuter des révisions de code sans surveillance, à intervalles réguliers, ou si vous souhaitez les inclure dans un script Ant.

Une interface de ligne de commande permet de spécifier l'espace de travail à utiliser ainsi que les éventuels paramètres en option. La ligne de commande lance un environnement Eclipse non graphique (sans l'interface utilisateur habituelle) se limitant aux seules fonctions essentielles à l'exécution des révisions de code. Par défaut, elle exécute ensuite une révision de code sur le code source se trouvant dans l'espace de travail en utilisant soit les règles de la révision de code rapide, soit celles qui ont été spécifiées dans l'interface du plan de travail la dernière fois qu'une révision de code a été exécutée.

Avant d'exécuter des révisions de code en mode non graphique, vous devez disposer d'un espace de travail contenant un projet avec des fichiers source Java. Il n'est pas nécessaire que l'environnement de développement soit lancé.
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.

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.

Exemple

La ligne de commande suivante exécute, sous Windows, une révision de code à partir de l'espace de travail D:\workspace. Un rapport HTML est généré et placé dans D:\workspace\report.
D:\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 D:\eclipse\startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -plugincustomization <CheminPersonnalisationPlugins> -data <répertoire_espace_de_travail -reportDirectory D:\workspace\report -onlyClient CodeReview
Remarque : Suivant la configuration de votre système d'exploitation, il est possible que vous deviez ajouter des paramètres supplémentaires aux commandes de ces exemples. Les paramètres peuvent être consultés dans les détails de la configuration, sous la rubrique "Propriétés système". Pour cela, sélectionnez Aide > A propos de > Détails de la configuration > Propriétés système.
Tâches associées
Exécution de révisions de code à partir d'une ligne de commande
Exécution de révisions de code à partir d'un script Ant
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.