Codeprüfung im automatischen Modus - Referenz

Mit dem automatischen Modus können Sie Codeprüfungen über eine Befehlszeile oder ein Ant-Script ohne Benutzereingabe und ohne Produkt-GUI automatisieren.

Zweck

Über die Befehlszeile wird eine Workbench im automatischen Modus (d. h. ohne Benutzerschnittstelle für die Entwicklungsumgebung) gestartet, und es werden Startkonfigurationen für Codeprüfungen ausgeführt, die sich im angegebenen Arbeitsbereich befinden.

Im Folgenden sehen Sie die grundlegende Befehlszeilensyntax für die Ausführung einer Codeprüfung im automatischen Modus:

<Eclipse-verzeichnis/jre/bin/java <obligatorische_parameter> <optionale_parameter>

Obligatorische Parameter

Es gibt drei Kategorien obligatorischer Parameter:
  • Produkt-VM
  • Eclipse
  • Befehlszeile

Produkt-VM

-Xj9
Hiermit wird die Anwendung für den Befehlszeilenmodus zusammen mit anderen Parametern gestartet, die unter Hilfe > Info über Eclipse-Plattform > Konfigurationsdetails aufgelistet sind.
-cp <klassenpfad>/startup.jar org.eclipse.core.launcher.Main
Hiermit wird Eclipse mit dem angegebenen Klassenpfad im automatischen Modus gestartet. Verwenden Sie Anführungszeichen, wenn der Pfad Leerzeichen enthält.
Verwenden Sie bei Windows zwei umgekehrte Schrägstriche (\\), nicht den umgekehrten Schrägstich. Beispiel: "C:\\Programme\\IBM\\Rational\\".
Eclipse
-plugincustomization <pluginCustomizationPath>
Hiermit wird der Anpassungspfad für das Plug-in durch den Pfad der Datei pluginCustomization.ini für Ihr Plug-in ersetzt.
-application com.ibm.r2a.command.line.mode.CommandLineModeApplication
Gibt die Anwendung für die Ausführung der Codeprüfung an.
-data <arbeitsbereich
Gibt die Position des Arbeitsbereichs an, in dem sich die Startkonfigurationen befinden. Verwenden Sie Anführungszeichen, wenn der Pfad Leerzeichen enthält. Verwenden Sie bei Windows zwei umgekehrte Schrägstriche (\\), nicht den umgekehrten Schrägstich. Beispiel: "C:\\Programme\\IBM\\Rational\\".
-os linux
Gibt an, dass das Betriebssystem Linux ist. Dieser Parameter ist im Befehlsabschnitt unter Hilfe > Konfigurationsdetails > Systemeigenschaften > Eclipse zu finden.
-ws gtk
Gibt die für einige Eclipse-Komponenten erforderlichen Benutzerschnittstellen-Konfigurationsparameter an. Dieser Parameter ist im Befehlsabschnitt unter Hilfe > Konfigurationsdetails > Systemeigenschaften > Eclipse zu finden.
Befehlszeile
-reportDirectory verzeichnispfad
Gibt das Verzeichnis an, in dem die Berichtsdateien erstellt werden sollen. Verwenden Sie Anführungszeichen, wenn der Pfad Leerzeichen enthält. Verwenden Sie bei Windows zwei umgekehrte Schrägstriche (\\), nicht den umgekehrten Schrägstich. Beispiel: "C:\\Programme\\IBM\\Rational\\".

Optionale Parameter

-persistKind html|xml
Gibt an, ob entweder ein HTML- oder ein XML-Bericht erstellt wird. Standardmäßig werden beide Berichte erstellt.
-verbose
Hiermit wird eine einfache Ausgabe von Zuständen erstellt (nur für Debugzwecke).
-excludeClient
Gibt einen oder mehrere Clients (nach Name) an, die von der Codeprüfung ausgeschlossen werden sollen.
-onlyClient
Gibt an, dass nur ein Client (nach Name) ausgeführt werden soll; standardmäßig werden alle Clients ausgeführt.
-reportDirectory
Gibt das Berichtsverzeichnis an, in das die generierten Berichte nach der Codeprüfung gestellt werden; das Standardberichtsverzeichnis befindet sich in den Metadaten des Befehlszeilen-Plug-ins.
-timeStampMode
Gibt das Verzeichnis an, in das die generierten Berichte nach der Codeprüfung gestellt werden; gleichzeitig wird eine Zeitmarke auf den Bericht angewendet.

Beispiel

Bei diesem Ant-Beispielscript werden über die Befehlszeile alle Startkonfiguration ausgeführt, die sich unter D:\workspace befinden; außerdem werden die Ergebnisse im Verzeichnis batch_report des Arbeitsbereichs erstellt.
<?xml version="1.0" encoding="UTF-8">
<project name="MyTestProject" default="CodeReviewHeadless" >

	<target name="CodeReviewHeadless">

		<property name="eclipse_verz" value="D:\\eclipse"/>
		<property name="workspace_verz" value="D:\\workspace"/>
		<property name="options" value=" -plugincustomization <pluginCustomizationPath> -onlyClient CodeReview -reportDirectory ${workspace_verz}\\batch_report -timeStampMode"/>

		<exec executable="${eclipse_verz}/jre/bin/java" dir="${eclipse_verz}" 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_verz}/startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication -data ${workspace_verz} ${options}" />
		</exec>
	</target>

</project>
Rechtliche Hinweise | Feedback
(C) Copyright IBM Corporation 2004, 2005. All Rights Reserved.