Stammverzeichnisdateien sind Dateien, die mit einer Eclipse-Installation paketiert werden müssen, allerdings keine Features oder Plug-ins sind. Allgemeine Beispiele sind ausführbare Eclipse-Dateien und ini-Dateien sowie Lizenzdateien.
Stammverzeichnisdateien werden zu einem Build durch Features beigesteuert, die die entsprechenden Eigenschaften des Stammverzeichnisses enthalten.
Stammverzeichnis |
Gibt eine durch Kommas getrennte Liste von Dateien oder Ordner an, die in alle zu erstellenden Konfigurationen aufzunehmen sind. Relative Pfade sind relativ zu dem Feature, das diese enthält. Verwenden Sie "file:", um eine Datei anzugeben, und "absolut:", um einen absoluten Pfad zu verwenden. Beispiele:
Jeder durch Komma getrennte Eintrag wird zu einer ant-Dateireihe. Falls sich der Eintrag auf einen Ordner bezieht, ist der Ordner der "dir"-Parameter der Dateireihe, und "**" wird verwendet, um den Parameter "includes" anzugeben. Handelt es sich bei dem Eintrag um eine Datei, wird das enthaltende Verzeichnis der Datei zum "dir"-Parameter und die Datei wird im Parameter "includes" angegeben. für alle relativen Dateien wird die Eigenschaft ${baseDir} im Verzeichnis verwendet. Diese Eigenschaft ${baseDir} ist das Stammverzeichnis des Features, in dem sich die generierte Datei build.xml befindet. |
root.<config> |
Gibt eine Liste von Dateien oder Ordner an, die in eine bestimmte Konfiguration aufzunehmen ist. Hier angegebene Konfigurationen müssen den Konfigurationen in der Eigenschaft configs für den Build entsprechen.
Relative Pfade sind relativ zu dem Feature, das diese enthält. Dieselben Präfixe "file:" und "absolute:", die in der Eigenschaft "root" verwendet werden, gelten auch hier. Beispiele:
|
root.folder.<subfolder> root.<config>.folder.<subfolder> |
Mit den Eigenschaften "root" und "root.<config>" vergleichbar, außer dass statt des Kopierens in das Stammverzeichnis der Eclipse-Installation, Dateien und Ordner in den angegebenen Unterordner kopiert werden.
Relative Pfade sind relativ zu dem Feature, das diese enthält. Dieselben Präfixe "file:" und "absolute:", die in der Eigenschaft "root" verwendet werden, gelten auch hier. Beispiele:
|
root.permissions.<rights> root.<config>.permissions.<rights> |
Gibt eine Liste von Dateien an, für die die ant-chmod-Task ausgeführt wird. Der Wert dieser Eigenschaft wird an die ant-chmod-Task als der Parameter "includes" weitergegeben. Daher können ant-Platzhaltermuster verwendet werden. Beispiele:
Der Teil <rights> der Eigenschaft wird tatsächlich an die ant-chmod-Task als Parameter "perm" weitergegeben. Wenn das endgültige Archivformat für die Konfiguration antTar ist, wird auch das Format <rights> an eine ant-tar-Dateireihe als Parameter "filemode" weitergegeben. Entsprechendes gilt für antZip und zipfileset. Während die ant-chmod-Task Genehmigungen wie "og-rwx" (Nicht-Eigentümer haben keinen Zugriff auf die Datei) unterstützt, unterstützen die tar- und zip-Dateireihen nur dreistellige oktale Zeichenfolgen. |
root.link root.<config>.link |
Erstellt paarweise Listen (durch Komma getrennt) der Dateien und Ordner, die symbolisch verknüpft werden müssen. Der erste Eintrag des Paars ist das Ziel und der zweite Eintrag ist der Linkname. Beispiel:
Dies führt zu einer ant-exec-Task, die den Befehl "ln -sf" ausführt. Bei einem bestimmten Wert von "targetA, nameA, targetB, nameB, targetC, nameC", wird eine Reihe von "ln"-Befehlen in dem Ordner ausgeführt, in dem sich die Stammverzeichnisdateien befinden: ln -sf targetA nameA ln -sf targetB nameB ln -sf targetC nameC |
Bei der Verwendung einer .product-Datei auf Grundlage von Features können die Stammverzeichnisdateien dem Produkt einfach hinzugefügt werden, indem die vorstehenden Eigenschaften der Stammverzeichnisdatei in einem der eingeschlossenen Features angegeben werden.
Es ist möglich, ein Feature einzuschließen, damit des Stammverzeichnisdateien beisteuert. Wenn in diesem Feature für Stammverzeichnisdateien keine Eigenschaft "bin.includes" in der Datei "build.properties" angegeben ist, wird es nicht in die endgültigen Buildergebnisse aufgenommen, wohl aber die von ihm beigesteuerten Stammverzeichnisdateien.
Wenn eine .product-Datei auf Plug-ins statt auf Features beruht, können dennoch Stammverzeichnisdateien zum Build hinzugefügt werden. In einem Produktbuild generiert PDE/Build automatisch ein Container-Feature, das alle in der .product-Datei angegebenen Plug-ins enthält. (Weitere Informationen finden Sie im Abschnitt zur Task eclipse.generateFeature). Es gibt zwei Möglichkeiten, Stammverzeichnisdateien zu diesem Produktbuild hinzuzufügen:
${buildDirectory}/features/org.foo.rootfile.feature/rootfiles/*
/build.properties : root = rootfiles
${buildDirectory}/build.properties: featureList = org.foo.rootfile.feature
${buildDirectory}/build.properties: generatedBuildProperties = ${buildDirectory}/root.properties
${buildDirectory/root.properties: root = absolute:${buildDirectory}/rootfiles
${buildDirectory}/rootfiles/*