Dateien zum Stammverzeichnis eines Builds hinzufügen

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.

Eigenschaften 'Stammverzeichnisdatei'

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:
  • root=rootfiles: Ein relativer Pfad zu einem Ordner, der Inhalt des Ordners ist enthalten.
  • root=file:license.html,licenses: Ein relativer Pfad zu einer "license.html"-Datei und ein relativer Pfad zu einem "licenses"-Ordner.
  • root=absolute:/eclipse/rootfiles: Ein absoluter Pfad zu einem Ordner, der Inhalt des Ordners ist enthalten.
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: Ein absoluter Pfad zur Aufnahme von "about.html" sowie ein relativer Pfad zur Aufnahme der *.so*-Dateien in den Bibliotheksordner.

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.win32.win32.x86=rootfiles: Ein relativer Pfad zu einem Ordner, der Inhalt des Ordners ist in der Konfiguration win32.win32.x86 enthalten.
  • root.linux.gtk.x86=absolute:file:about.html: Ein absoluter Pfad zu einer Datei für die Aufnahme in die Konfiguration linux.gtk.x86.
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.folder.docs/html=html_files: Der Inhalt des Ordners "html_files" des Features wird in den Ordner docs/html folder der Eclipse-Installation kopiert.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: Ein absoluter Pfad, der Inhalt des Ordners /build/jres/linux wird in den JRE-Ordner der Eclipse-Installation kopiert.
Diese Eigenschaften werden von PDE/UI verwendet, wenn eine JRE in einer Produktdatei für den Export angegeben ist. PDE/Build unterstützt derzeit nicht die Aufnahme einer JRE, die eine .-Produktdatei verwendet, und diese Eigenschaften müssen in einem Feature angegeben werden, damit eine JRE in einen Produktbuild ohne GUI aufgenommen wird.
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:
  • root.permissions.755=eclipse: Legt fest, dass die 'eclipse'-Datei ausführbare Genehmigungen aufweist.
  • root.linux.gtk.x86.permissions.755=lib/**: Legt fest, dass alle Dateien im Bibliotheksverzeichnis ausführbar sind.

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:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: In der Konfiguration macosx.carbon.ppc wird ein Softlink in dem Stammverzeichnis mit dem Namen "eclipse" erstellt, der auf die Datei "Eclipse.app/Contents/MacOS/eclipse" verweist.

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

Aufnehmen von Stammverzeichnisdateien in einen Produktbuild

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: