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 .