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 :
- L'espace de travail doit contenir au moins un projet avec des fichiers source
Java.
- Si vous souhaitez spécifier les règles à appliquer, vous devez configurer
la révision de code dans l'interface utilisateur (plan de travail 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 . 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".