Le mode non graphique permet d'automatiser l'exécution de révisions de code à partir
d'une ligne de commande ou d'un script Ant, sans interaction avec l'utilisateur et sans passer
par l'interface graphique du produit.
Rôle
La ligne de commande lance un plan de travail dit "non graphique" (c'est-à-dire sans
l'interface utilisateur de l'environnement de développement) et exécute les configurations de lancement
de révision de code trouvées dans l'espace de travail spécifié.
Voici la syntaxe élémentaire à utiliser
pour exécuter une révision de code en mode non graphique :
<répertoire Eclipse>/jre/bin/java <paramètres
obligatoires> <paramètres optionnels
Paramètres obligatoires
Les paramètres obligatoires se répartissent
en trois catégories :
- VM (machine virtuelle) du produit
- Eclipse
- Ligne de commande
VM du produit
- -Xj9
- Lance l'application du mode ligne de commande, avec les autres paramètres
répertoriés
sous Aide > A propos de la plateforme Eclipse > Détails de la configuration.
- -cp <chemin de classes>/startup.jar org.eclipse.core.launcher.Main
- Lance Eclipse en mode non graphique (headless) avec le chemin de classes
spécifié. 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\\".
- Eclipse
- -plugincustomization <cheminPersonnalisationPlugin
- Remplace le chemin de personnalisation du plug-in par celui du fichier
pluginCustomization.ini de votre plug-in.
- -application com.ibm.r2a.command.line.mode.CommandLineModeApplication
- Spécifie l'application à utiliser pour exécuter la révision de code.
- -data <espace de travail>
- Spécifie l'emplacement de l'espace de travail dans lequel se situent les
configurations de lancement. 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\\".
- -os linux
- Spécifie Linux comme système d'exploitation. Ce paramètre provient de la
section eclipse.commands, dans les propriétés système. Pour y accéder,
sélectionnez , puis
recherchez la rubrique Propriétés système.
- -ws gtk
- Spécifie le paramètre de configuration d'interface utilisateur requis par
certains composants d'Eclipse. Ce paramètre provient de la
section eclipse.commands, dans les propriétés système. Pour y accéder,
sélectionnez , puis
recherchez la rubrique Propriétés système.
- Ligne de commande
- -reportDirectory chemin_répertoire
- Indique le répertoire où doivent être placés les fichiers de rapport produits. 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\\".
Paramètres optionnels
- -persistKind html|xml
- Indique s'il faut produire uniquement un rapport au format HTML ou uniquement un rapport
au format XML. Par défaut, les deux rapports sont produits.
- -verbose
- Produit une simple sortie d'états destinée uniquement au débogage.
- -excludeClient
- Spécifie le nom d'un ou de plusieurs clients à exclure de la révision de code.
- -onlyClient
- Indique d'exécuter un seul client (désigné par son nom). Par défaut, tous les clients
sont exécutés.
- -reportDirectory
- Indique le répertoire dans lequel doivent être placés les rapports générés une fois la
révision de code exécutée. Le répertoire par défaut se trouve dans le répertoire medatata
du plug-in de la ligne de commande.
- -timeStampMode
- Indique le répertoire dans lequel doivent être placés les rapports générés une fois la
révision de code exécutée et applique un horodatage aux rapports.
Exemple
L'exemple de script Ant suivant exécute en mode silencieux (non interactif)
toutes les configurations de lancement situées dans
D:\workspace et produit
les résultats dans un répertoire nommé
batch_report situé dans
cet espace de travail.
<?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>