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 Build-Scripts zur Verfügung.
Die Generierungsfunktionen für Build-Scripts 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[,version]' vorliegen, wie im Verzeichnisdateiformat angegeben. |
| 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 die Einträge im Format 'type@id[,version]' vorliegen, wie im Verzeichnisdateiformat angegeben. |
| buildDirectory : |
Das Verzeichnis, in dem sich die zu buildenden Features und Plug-ins befinden. Plug-ins und Features müssen sich in den Ordnern plugins bzw. features 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 getrennte 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. Der Standardwert lautet "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 wurde. |
| 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. |
| filteredDependencyCheck : |
Optional; schränkt die Gruppe der Plug-ins und Features, die beim Build zu berücksichtigen sind, auf diejenigen ein, die von den Features erreichbar sind. |
| filterP2Base : |
Optional; schränkt die Gruppe der Plug-ins und Features, die von 'baseLocation' zu berücksichtigen sind, auf diejenigen ein, die als von p2 installiert gelten. |
| generateFeatureVersionSuffix: | Optional; legt fest, ob ein Versionssuffix für das Feature generiert wird. Weitere Informationen finden Sie im Abschnitt Qualifikationsmerkmale für die Version. |
| generatedVersionLength : |
Optional; die Länge des
Versionssuffix für das generierte Feature. Der Standardwert ist
28. Weitere Informationen finden Sie im Abschnitt Qualifikationsmerkmale für die Version. |
| significantVersionDigits : |
Optional; die Anzahl
signifikanter Ziffern, die bei der Generierung von Versionssuffixen für
Features verwendet wird.
Weitere Informationen finden Sie im Abschnitt Qualifikationsmerkmale für die Version. |
| forceContextQualifier: |
Optional; benutzt den angegebenen Wert, um das Qualifikationsmerkmal durch Plug-ins und Features zu ersetzen. Weitere Informationen finden Sie im Abschnitt Qualifikationsmerkmale für die Version. |
| featureId: |
Die ID, die dem generierten Feature zugeordnet wird. |
| buildDirectory: |
Das Verzeichnis, in dem sich
die einzuschließenden Features und Plug-ins befinden (in den
Unterverzeichnissen /features bzw. /plugins). 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 Abruf 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. (Unterstützt Attribute, siehe nachstehend) |
| featureList: |
Optional; eine durch Kommata getrennte Liste der Feature-IDs, die in dem generierten Feature enthalten sein sollen. (Unterstützt Attribute, siehe nachstehend) |
| fragmentList: |
Optional; eine durch Kommata getrennte Liste der Fragment-IDs, die in dem generierten Feature enthalten sein sollen. (Unterstützt Attribute, siehe nachstehend) |
| buildPropertiesFile : |
Optional, die Position einer Eigenschaftendatei, deren Inhalt als die build.properties des generierten Features zu verwenden ist. |
| includeLaunchers : |
Optional, ungeachtet, ob die equinox-Startprogramme aufgenommen werden oder nicht, ist der Standardwert "true". |
Die Argumente pluginList, featureList und fragmentList der Task eclipse.generateFeature bieten alle Unterstützung für Attribute. Diese Argumente weisen alle folgende Form auf:
List = <element-id>[;<attribute>=<value>]* [,<element-id>[;<attribute>=<value>]*]*
Jedes Attribut=Wertepaar wird in die generierte XML-Datei, die dem jeweiligen Element entspricht, eingesetzt. Beispiel:
featureList = org.eclipse.feature;optional=true
pluginList = org.eclipse.plugin.A;unpack=true
fragmentList=org.eclipse.fragment.a;os=win32,org.eclipse.fragment.b;os=linux;ws=gtk;arch=x86
<feature ...>
...
<includes id="org.eclipse.feature" version="0.0.0" optional="true" />
...
<plugin id="org.eclipse.plugin.A" version="0.0.0" unpack="true" />
<plugin id="org.eclipse.fragment.a" version="0.0.0" os="win32" fragment="true" />
<plugin id="org.eclipse.fragment.b" version="0.0.0" os="linux" ws="gtk" arch="x86" fragment="true" />
...
</feature>
<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 -jar plugins/org.eclipse.equinox.launcher_<version>.jar -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.