Référence - Mode non graphique de la révision de code

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 Aide > A propos de > Détails de la configuration, 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 Aide > A propos de > Détails de la configuration, 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>
Conditions d'utilisation | Retours d'informations
(C) Copyright IBM Corporation 2004, 2005. All Rights Reserved.