Diese Task führt einen vollständigen Vergleich eines API-Profils relativ zu einer Referenzkonfiguration (baseline) aus.
Der Name der Ant-Task ist apitooling.compare. Für ihre Verwendung muss sich die JAR-Datei apitooling-ant.jar im Ant-Klassenpfad
befinden.
<apitooling.compare baseline="..." profile="..." report="..." excludelist="..." includelist="..." components="..." visibility="..." debug="..." />
| Attribut | Beschreibung | Erforderlich |
| baseline | Dieses Attribut gibt die Position der Referenzkonfiguration an.
Es kann eine Datei mit der Dateierweiterung '.zip', '.jar', '.tgz' bzw. '.tar.gz' oder ein Verzeichnis angegeben werden, das dem Eclipse-Installationsordner entspricht. Dies ist das Verzeichnis, in dem sich die ausführbare Eclipse-Datei befindet. Die Position wird mit einem absoluten Pfad angegeben. |
Ja |
| profile | Dieses Attribut gibt die Position des aktuellen Produkts oder Profils an, das mit der Referenzkonfiguration verglichen werden soll.
Es kann eine Datei mit der Dateierweiterung '.zip', '.jar', '.tgz' bzw. '.tar.gz' oder ein Verzeichnis angegeben werden, das dem Eclipse-Installationsordner entspricht. Dies ist das Verzeichnis, in dem sich die ausführbare Eclipse-Datei befindet. Die Position wird mit einem absoluten Pfad angegeben. |
Ja |
| report | Gibt die Ausgabeposition an, an der der Bericht generiert wird.
Nach Abschluss der Task ist der Bericht mit dem Namen "compare.xml" in diesem Verzeichnis verfügbar. Die Position wird mit einem absoluten Pfad angegeben. |
Ja |
| excludelist | Gibt die Position der Ausschlussliste an.
Die Position der Ausschlussliste gibt eine Textdatei an, in der Produktpakete aufgelistet sind, die aus der Analyse ausgeschlossen werden sollen. Standardmäßig werden alle Produktpakete im Profil analysiert. Durch die Einschluss- und Ausschlusslistenattribute können Produktpakete selektiv ein- und ausgeschlossen werden. Die Einschlussliste gibt die Ausgangsgruppe der zu analysierenden Produktpakete an. (Wenn sie nicht angegeben wird, werden alle Produktpakete eingeschlossen.) Anschließend wird die Ausschlussliste auf diese Gruppe angewendet. Jede Zeile der Datei gibt einen der folgenden Informationstypen an:
Die Position wird mit einem absoluten Pfad angegeben. Das folgende Beispiel zeigt eine Ausschlussliste: # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user org.eclipse.platform.doc.isv org.eclipse.platform.doc.user # NON-ECLIPSE BUNDLES com.ibm.icu com.jcraft.jsch javax.servlet javax.servlet.jsp # Exclude all pde bundles R:org\.eclipse\.pde\..* ...Die Ausschlussliste kann reguläre Ausdrücke enthalten, wenn die Zeile mit "R:" beginnt. |
Nein |
| includelist | Gibt die Position der Einschlussliste an.
Die Position der Einschlussliste gibt eine Textdatei an, in der Produktpakete aufgelistet sind, die in die Analyse eingeschlossen werden sollen. Standardmäßig werden alle Produktpakete im Profil analysiert. Durch die Einschluss- und Ausschlusslistenattribute können Produktpakete selektiv ein- und ausgeschlossen werden. Die Einschlussliste gibt die Ausgangsgruppe der zu analysierenden Produktpakete an. (Wenn sie nicht angegeben wird, werden alle Produktpakete eingeschlossen.) Anschließend wird die Ausschlussliste auf diese Gruppe angewendet. Jede Zeile der Datei gibt einen der folgenden Informationstypen an:
Die Position wird mit einem absoluten Pfad angegeben. Das folgende Beispiel zeigt eine Einschlussliste: # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user org.eclipse.platform.doc.isv org.eclipse.platform.doc.user # NON-ECLIPSE BUNDLES com.ibm.icu com.jcraft.jsch javax.servlet javax.servlet.jsp # Exclude all pde bundles R:org\.eclipse\.pde\..* ... |
Nein |
| debug | Gibt den Wert für die Debugfunktion an.
Folgende Werte sind möglich: true und false.
Der Standardwert ist false.
|
Nein |
| components | Gibt die Position der Komponentenliste an.
Die Komponentenliste enthält alle Namen von Komponenten, die verglichen werden müssen. Wenn keine Komponentenliste angegeben wird, werden alle Komponenten aus der gegebenen Referenzkonfiguration verglichen. Die Position wird mit einem absoluten Pfad angegeben. Das Format der Komponentenlistendatei sieht wie folgt aus: # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user org.eclipse.platform.doc.isv org.eclipse.platform.doc.user # Include all pde bundles R:org\.eclipse\.pde\..* ...Die Komponentenliste kann reguläre Ausdrücke enthalten, wenn die Zeile mit "R:" beginnt. |
Nein |
| visibility | Gibt den Wert für Sichtbarkeit an.
Folgende Werte sind möglich: API, ALL
Der Standardwert ist API.
|
Nein |
<apitooling.compare baseline="D:\eclipse\3.4.1\eclipse" profile="D:\eclipse-SDK-I20081118-0800-linux-gtk.tar.gz" report="D:\reports\xml" excludelist="D:\exclude_list_external.txt" debug="true" />
Hierdurch wird die Task ausgeführt, durch die Dateien compare.xml im Ordner
D:\reports\xml erstellt werden.
Die Task verwendet die Ausschlussliste, um die Anzahl der zu meldenden Probleme bzw. Fehler zu senken.
Da die Debugfunktion aktiviert ist, wird in der Ant-Konsole die Tracefunktion für die Fehlerbehebung angezeigt.

Ant-Task für API-Freeze
Ant-Task für Dateigenerierung
Ant-Task für API-Verwendung
Ant-Task für Analyseberichtskonvertierung
Ant-Task für API-Freeze-Berichtskonvertierung
Ant-Task für API-Verwendungsberichtskonvertierung
Ant-Task für Konvertierung von Berichten zu eingestellter API-Unterstützung