Référence du mode sans interface de révision de code

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 Help > Configuration Details > System properties > Eclipse.
-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 Help > Configuration Details > System properties > Eclipse.
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>
Conditions d'utilisation | Retours d'informations
(C) Copyright IBM Corporation 2004, 2005. All Rights Reserved.