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.
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:
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.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.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:
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:
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 |
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:
${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/*