Il est possible d'exécuter des révisions de code
dans un plan de travail dit "non graphique" (headless), 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.
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).
Remarque : 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.
Pour créer et exécuter un script Ant :
- Sélectionnez .
- Entrez build.xml comme nom du script Ant et
cliquez sur Terminer.
- Faites un double clic sur le script Ant build.xml pour ouvrir
l'éditeur Ant.
- Entrez le contenu suivant dans l'éditeur :
<?xml version="1.0" encoding="UTF-8">
<project name="MyTestProject" default="CodeReviewHeadless" >
<target name="CodeReviewHeadless">
<property name="eclipse_dir" value="D:\\eclipse"/>
<property name="workspace_dir" value="D:\\workspace"/>
<property name="options" value=" -plugincustomization <pluginCustomizationPath> -onlyClient CodeReview -reportDirectory ${workspace_dir}\\batch_report -timeStampMode"/>
<exec executable="${eclipse_dir}/jre/bin/java" dir="${eclipse_dir}" vmlauncher="false">
<arg line=="-Xj9 -Dorg.eclipse.swt.browser.internal.flash -Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl -cp ${eclipse_dir}/startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -data ${workspace_dir} ${options}" />
</exec>
</target>
</project>
- Remplacez les valeurs des propriétés eclipse_dir et workspace_dir par
les valeurs réelles, à savoir le répertoire d'installation d'Eclipse sur votre machine et
celui votre espace de travail. Ajoutez les éventuelles options
supplémentaires à la valeur de la propriété options. 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\\".
- Fermez l'éditeur Ant.
- Pour exécuter le script Ant, cliquez avec le bouton droit sur le fichier build.xml, puis
sélectionnez et cliquez sur Exécuter. Une nouvelle instance de l'environnement Eclipse est alors lancée en mode non graphique (headless).
Cette instance exécute les configurations de lancement de révisions de code situées dans
l'espace de travail désigné. Vous pouvez aussi exécuter le script Ant depuis une ligne de commande
en utilisant la commande runAnt.
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.