Le mode sans interface permet d'automatiser les révisions de code à partir d'une ligne de commande ou
d'un script Ant sans entrée utilisateur ni interface graphique du produit.
Rôle
La ligne de commande lance un plan de travail "sans interface" (sans interface utilisateur
pour l'environnement de développement) et exécute les configurations de lancement de la révision de code dans un espace de travail spécifié.
Ci-dessous une syntaxe de ligne de commande de base permettant
d'exécuter une révision de code en mode sans interface :
<Répertoire Eclipse>/jre/bin/java <paramètres
obligatoires> <paramètres facultatifs>
Paramètres obligatoires
Il existe trois catégories de paramètres obligatoires :
- Product VM
- Eclipse
- Ligne de commande
Product VM
- -Xj9
- Lance l'application pour le mode de ligne de commande, ainsi que d'autres paramètres répertoriés dans
Help > About Eclipse Platform > Configuration Details.
- -cp <classpath>/startup.jar org.eclipse.core.launcher.Main
- Lance Eclipse en mode sans interface avec le chemin d'accès aux classes indiqué. Utilisez les guillemets si le chemin d'accès contient des espaces.
- Pour Windows, utilisez les doubles barres
obliques inversées (\\) à la place de la barre oblique inversée normale. Par exemple :
"C:\\Program Files\\IBM\\Rational\\".
- Eclipse
- -plugincustomization <pluginCustomizationPath>
- Remplacez le chemin de personnalisation du plug-in par le chemin d'accès au fichier pluginCustomization.ini de votre plug-in.
- -application com.ibm.r2a.command.line.mode.CommandLineModeApplication
- Indique l'application utilisée pour exécuter la révision de code.
- -data <espace_travail>
- Indique l'emplacement de l'espace de travail dans lequel se trouvent les configurations de lancement. Utilisez les guillemets si le chemin d'accès contient des espaces. Pour Windows, utilisez les doubles barres
obliques inversées (\\) à la place de la barre oblique inversée normale. Par exemple :
"C:\\Program Files\\IBM\\Rational\\".
- -os linux
- Indique Linux comme système d'exploitation. Le paramètre provient de la section des commandes
.
- -ws gtk
- Indique le paramètre de configuration de l'interface utilisateur requis par certains composants Eclipse. Le paramètre
provient de la section des commandes
.
- Ligne de commande
- -reportDirectory chemin_répertoire
- Indique le répertoire dans lequel ont été générés les fichiers de rapport. Utilisez les guillemets si le chemin d'accès contient des espaces. Pour Windows, utilisez les doubles barres
obliques inversées (\\) à la place de la barre oblique inversée normale. Par exemple :
"C:\\Program Files\\IBM\\Rational\\".
Paramètres facultatifs
- -persistKind html|xml
- Indique l'endroit où générer un rapport HTML ou XML seul. Par défaut, les deux rapports sont générés.
- -verbose
- Génère une simple sortie des états à des fins de débogage uniquement.
- -excludeClient
- Indique un ou plusieurs clients, par nom, à exclure de la révision de code.
- -onlyClient
- Indique de n'exécuter qu'un seul client par nom. Par défaut, tous les clients sont exécutés.
- -reportDirectory
- Indique le répertoire du rapport dans lequel les rapports générés sont placés suite à la révision de code. Le répertoire de rapport par défaut se trouve dans les métadonnées du plug-in de ligne de commande.
- -timeStampMode
- Indique le répertoire dans lequel les rapports générés sont placés après la révision de code et applique un
horodatage au rapport.
Exemple
Cet exemple de script Ant exécute de façon silencieuse toutes les configurations de
lancement qui se trouvent dans
D:\workspace et génère les résultats dans un répertoire
nommé
batch_report placé dans l'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>