Lägga till filer i roten av ett bygge

Rotfiler är filer som måste förpackas med en Eclipse-installation men som inte är funktioner eller insticksprogram. Vanliga exempel är eclipse programfiler och ini-filer såväl som licensfiler.
Rotfiler bidras till ett bygge genom funktioner som innehåller rätt rotegenskaper.

Rotfilsegenskaper

rot
Ange en kommaavgränsad lista med filer eller mappar som ska tas med i alla konfigurationer som byggs.
Relativa sökvägar är relativa till den innehållande funktionen. Använd "file:" för att ange en fil och "absolute:" för att använda en absolut sökväg.
Exempel:
  • root=rootfiles: En relativ sökväg till en mapp, innehållet i mappen tas med
  • root=file:license.html,licenses: En relativ sökväg till en "license.html"-fil och en relativ sökväg till en "licenses"-mapp
  • root=absolute:/eclipse/rootfiles: En absolut sökväg till en mapp, innehållet i mappen tas med
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: En absolut sökväg för att ta med "about.html", såväl som en relativ sökväg för att ta med alla *.so*-filer under mappen lib.

Varje kommaavgränsad post blir en ant-filuppsättning. Om posten hänvisar till en mapp, är den mappen parametern "dir" för filuppsättningen och ett "**" används som parametern "includes". Om posten är en fil blir filens innehållande katalog parametern "dir" och filen anges i parametern "includes".

För alla relativa filer används egenskapen ${baseDir} i katalogen. Denna ${baseDir}-egenskap blir funktionens rotkatalog där den genererade build.xml-filen placeras.

root.<config>
Ange en lista med filer eller mappar som ska tas med för den givna konfigurationen. Konfigurationer som anges här ska motsvara konfigurationerna i egenskapen configs för bygget. Relativa sökvägar är relativa till den innehållande funktionen. Samma "file:"- och "absolute:"-prefix som används i egenskapen "root" gäller även här.
Exempel:
  • root.win32.win32.x86=rootfiles: En relativ sökväg till en mapp, innehållet i mappen tas med i win32.win32.x86-konfigurationen
  • root.linux.gtk.x86=absolute:file:about.html: En absolute sökväg till en fil att ta med i linux.gtk.x86-konfigurationen.
root.folder.<undermapp>

root.<config>.folder.<undermapp>
Liknar egenskaperna "root" och "root.<config>" med skillnaden att i stället för att kopieras till roten i eclipseinstallationen, kopieras filer och mappar till den angivna undermappen.
Relativa sökvägar är relativa till den innehållande funktionen. Samma "file:"- och "absolute:"-prefix som används i egenskapen "root" gäller även här.
Exempel:
  • root.folder.docs/html=html_files: Innehåller i funktionens "html_files"-mapp kopieras till mappen docs/html i eclipseinstallationen.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: En absolut sökväg, innehållet i mappen /build/jres/linux kopieras till mappen jre i eclipseinstallationen.
Dessa egenskaper används av PDE/UI när en JRE anges för export i en .product-fil. PDE/Build hanterar för tillfället inte inkludering av en JRE med .product-filen, och dessa egenskaper måste anges i en funktion för att ta med en JRE i ett konsollöst produktbygge.
root.permissions.<rights>

root.<config>.permissions.<rights>
Ange en lista med filer att köra uppgiften ant chmod mot. Värdet för denna egenskap skickas till ant chmod som parametern "includes". Det betyder att ant-jokerteckenmönster kan användas.
Exempel:
  • root.permissions.755=eclipse: Ange att filen 'eclipse' har körningsfilsbehörigheter.
  • root.linux.gtk.x86.permissions.755=lib/**: Ange att alla filer under katalogen lib ska kunna köras

Avsnittet <rights> i egenskapen skickas till ant chmod som parametern "perm". Om det slutliga arkivformatet för konfigurationen är antTar, skickas även formatet <rights> till en ant tar-filuppsättning som parametern "filemode". På liknande sätt för antZip- och zip-filuppsättningar. Medan ant chmod hanterar behörigheter som "og-rwx" (gör att användare som inte äger filen inte kan röra vid den), hanterar tar- och zip-filuppsättningar bara tresiffriga oktala strängar.
root.link

root.<config>.link
Lista i par (avgränsade med komma) de filer och mappar som behöver länkas symboliskt. Den första posten i paret är målet och den andra posten är länknamnet.
Exempel:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: I macosx.carbon.ppc-konfigurationen skapar du en mjuklänk i roten med namnet "eclipse" som pekar till filen "Eclipse.app/Contents/MacOS/eclipse".

Detta resulterar i en ant exec-uppgift som kör ett "ln -sf"-kommando. Givet ett värde om "targetA, nameA, targetB, nameB, targetC, nameC", körs en uppsättning "ln"-kommandon i mappen där eclipserotfilerna har samlats in:
		ln -sf targetA nameA
ln -sf targetB nameB
ln -sf targetC nameC

Ta med rotfiler i ett produktbygge

När du använder en .product-fil baserad på funktioner kan rotfilerna läggas till i produkten genom att man anger ovanstående rotfilsegenskaper i någon av de inkluderade funktionerna.

Det går att ta med en funktion enbart för syftet att bidra med rotfiler. Om denna "rotfil"-funktion inte anger en "bin.includes"-egenskap i sin build.properties-fil, tas den inte med i det slutliga byggresultaten, med dess bidragna rotfiler gör det.

När en .product-fil baseras på insticksprogram i stället för funktioner, kan rotfiler ändå läggas till i bygget. I ett produktbygge genererar PDE/Build automatiskt en behållarfunktion som inkluderar alla insticksprogram som anges i .product-filen (se uppgiften eclipse.generateFeature). Du kan lägga till rotfiler i detta produktbygge på två sätt: