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 zu finden.
- -ws gtk
- Gibt die für einige Eclipse-Komponenten erforderlichen Benutzerschnittstellen-Konfigurationsparameter
an. Dieser Parameter ist im Befehlsabschnitt unter 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>