Ant-Scripts werden normalerweise mit der Plug-in-Entwicklungsumgebung (Plug-in Development Environment - PDE) generiert.
Sie können jedoch auch manuell oder durch andere Scripts generiert werden.
PDE stellt Ant-Tasks für die Generierung unterschiedlicher Erstellungsscripts zur Verfügung.
Die Generierungsfunktionen für Erstellungsscripts
befinden sich in den folgenden Tasks. Argumente werden für jede Task ebenfalls angegeben.
elements: |
Der Eintrag, der abgerufen werden soll. Es wird erwartet, dass die Einträge im Format "type@id" wie im Verzeichnisdateiformat angegeben vorliegen; |
buildDirectory: |
Das Verzeichnis, in dem die Abrufscripts generiert und in das die Features und Plug-ins ausgecheckt werden. |
directory: |
Der Pfad zu einer Verzeichnisdatei. |
children: |
Gibt optional an, ob die Scriptgenerierung für enthaltene Plug-ins und Fragmente aufgerufen werden soll. Der Standardwert ist "true". |
cvspassfile: |
Optional; der Name einer CVS-Kennwortdatei. |
fetchTag: |
Ersetzt optional das in der Verzeichnisdatei festgelegte Tag durch den angegebenen Wert. |
configInfo: |
Optional; eine durch Et-Zeichen gegliederte Konfigurationsliste, die die Zielkonfiguration festlegt. Der Standardwert ist plattformunabhängig. |
recursiveGeneration: |
Optional; gibt an, ob Abrufscripts für verschachtelte Features generiert werden sollten oder nicht. Die Standardeinstellung ist auf "true" eingestellt. |
elements: |
Der Eintrag, der erstellt werden soll. Es wird erwartet, dass der Eintrag im Format 'type@id' wie im Verzeichnisdateiformat angegeben vorliegt. |
buildDirectory : |
Das Verzeichnis, in dem sich die zu erstellenden Features und Plug-ins befinden. |
children: |
Gibt optional an, ob die Scriptgenerierung für enthaltene Plug-ins und Fragmente aufgerufen werden soll. Der Standardwert ist "true". |
recursiveGeneration: |
Optional; gibt an, ob die Scriptgenerierung für enthaltende Features aufgerufen werden soll. Der Standardwert ist "true". |
devEntries : |
Optional; eine durch Kommata gegliederte Liste der Verzeichnisse, die an den Kompilierungsklassenpfad übergeben werden soll. |
buildingOSGi : |
Optional; gibt an, ob das Ziel 3.x. oder 2.1 ist. Der Standardwert ist 'true'. |
baseLocation: |
Optional; gibt einen Ordner an, in dem eine Eclipse-Zielinstallation mit den Unterverzeichnissen features/ und plugins/ enthalten ist. |
configInfo: |
Optional; eine durch Et-Zeichen gegliederte Konfigurationsliste, die die Zielkonfiguration festlegt. Der Standardwert ist plattformunabhängig. |
pluginPath: |
Optional; eine durch Plattformdateitrennzeichen getrennte Liste der Positionen, an denen sich zusätzliche Plug-ins befinden. |
archivesFormat: |
Optional; eine durch Et-Zeichen gegliederte Liste mit Konfigurationen und das erwartete Ausgabeformat für jede Konfiguration. Das Format wird durch einen Trennstrich (-) von der Konfiguration getrennt. Die unterstützten Werte sind: 'folder', 'tar', 'zip', 'antZip'; Dies bedeutet jeweils, dass nicht archiviert werden soll, dass 'tar' zur Erstellung des Archivs verwendet werden soll, dass die Version der Info-ZIP verwendet werden soll, die auf der Plattform zur Verfügung steht und dass 'antZip' verwendet werden soll. Der Standardwert ist 'antZip'. |
product : |
Optional; ein durch '/' getrennter Pfad für die Position eines RCP-Produktes, das erstellt wird. Das erste Segment des Pfades muss sich auf die Plug-in- ID eines Plug-ins beziehen das die .product-Datei enthält. |
signJars : |
Optional; gibt an, ob die generierten Scripts JAR-Dateien für Features und Plug-ins signieren müssen. Die Standardeinstellung ist "false". Die Parameter des Signiertasks werden durch folgende Ant-Eigenschaften gesteuert: sign.alias, sign.keystore und sign.storepass, die entsprechend an die Alias-, Schlüsselspeicher- und Storepass-Parameter von der Ant-Task signJar übermittelt wird. Die Standardeinstellung ist "false". |
generateJnlp: |
Optional; gibt an, ob eine JNLP-Datei für alle erstellten Features generiert werden soll. |
outputUpdateJars: |
Optional; generiert Plug-ins und Features im Update-Site-Format wenn dieses Attribut gesetzt ist. Die Standardeinstellung ist "false". Beachten Sie, dass die Datei 'site.xml' weder generiert noch aktualisiert wird. |
forceContextQualifier: |
Optional; benutzt den angegebenen Wert, um das Qualifikationsmerkmal durch Plug-ins und Features zu ersetzen. (Siehe auch Qualifikationsmerkmale für die Version) |
generateFeatureVersionSuffix: | Optional; legt fest, ob ein Versionssuffix für das Feature generiert wird. |
groupConfiguration: |
Optional; legt fest, ob alle erstellten Konfigurationen in einem einzigen Archiv zusammengefasst werden. |
generateVersionsLists: |
Optional; legt fest, ob Eigenschaftendateien generiert werden, in denen die Versionen der Features und Plug-ins aufgelistet werden, die erstellt wurden.
|
featureId: |
Die ID, die dem generierten Feature zugeordnet wird.
|
buildDirectory: |
Das Verzeichnis, in dem sich die Features und Plug-ins (in den Unterverzeichnissen 'features' und 'plugins') befinden. Das generierte Feature wird in das Unterverzeichnis 'features' gestellt.
|
baseLocation: |
Optional; gibt den Ordner an, in dem sich die installierten Features und Plug-ins befinden. |
productFile: |
Optional; die Produktdatei, auf der das generierte Feature basieren soll. |
verify: |
Gibt an, ob die Auflösungsfunktion verwendet werden soll, um zu überprüfen, ob die bereitgestellten Plug-ins und Features verfügbar sind. Außerdem wird ermittelt, ob das Feature die plattformspezifischen Fragmente und Plug-ins korrekt handhaben kann, die in den JAR-Dateien vorliegen. Wenn alle Elemente, die in diesem Feature enthalten sein sollen, lokal verfügbar sind, sollte für 'verify' der Wert 'true' eingestellt werden.
Wenn die Elemente aus einem Repository abgerufen werden müssen, stellen Sie für 'verify' den Wert 'false' ein, verwenden das sich ergebende Feature zum Abrufen der erforderlichen Plug-ins und Features und generieren das Container-Feature unter Verwendung des Werts 'true' für 'verify' neu.
|
pluginPath: |
Optional; eine durch Plattformdateitrennzeichen getrennte Liste der Positionen, an denen sich zusätzliche Plug-ins befinden. |
configInfo: |
Optional; eine durch Et-Zeichen getrennte Konfigurationsliste, die die Zielkonfiguration festlegt. Der Standardwert ist plattformunabhängig. |
pluginList: |
Optional; eine durch Kommata getrennte Liste der Plug-in-IDs, die in dem generierten Feature enthalten sein sollen.
|
featureList: |
Optional; eine durch Kommata getrennte Liste der Feature-IDs, die in dem generierten Feature enthalten sein sollen.
|
fragmentList: |
Optional; eine durch Kommata getrennte Liste der Fragment-IDs, die in dem generierten Feature enthalten sein sollen.
|
<eclipse.fetch elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
directory="directory.txt"
configInfo="win32,win32,x86 & linux, motif, x86"
/>
<eclipse.buildScript elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
archivesFormat="macosx, carbon, ppc - tar"/>
Die zuvor beschriebenen Tasks funktionieren nur, wenn Eclipse aktiv ist. Im speziellen Szenario der Ausführung von Ant-Scripts unter Verwendung von Eclipse-Tasks, müssen die Scripts mit der Ant-Ausführungsanwendung von Eclipse ausgeführt werden. Die Befehlszeile für diesen speziellen Fall lautet:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Bitte beachten Sie, dass die Parameter, die nach der Anwendung angegeben sind, an Ant übergeben werden.