Hämta från lager
I infrastrukturen i PDE-bygget ingår steg för att hämta källkoden och förbyggda insticksprogram från ett lager som en del av byggprocessen. (Se uppgiften eclipse.fetch
och -egenskaperna för att kontrollera hämtningen.)
Det finns två möjligheter: låt PDE-bygget hämta källkoden automatiskt eller hämta källkoden manuellt.
Första steget till automatisering, avbildningsfilen
När du anger IDt för en funktion eller ett insticksprogram som ska byggas kan infrastrukturen hämta alla ingående funktioner och insticksprogram från ett lager.
PDE utgår från avbildningsfiler när objekt hämtas. En avbildningsfil är en Java-egenskapsfil som avbildar IDn för funktioner och insticksprogram till en plats och ett märkord i ett lager. Avbildningsfilernas format är öppet men key-delen är fastställd av PDE-bygget:
<elementType>@<elementID>[,<elementVersion>] = <lagerspecifikt innehåll>
där elementType utgörs av en av bundle, feature,
plugin eller fragment och elementId och elementVersion anger specifikationerna för elementet.
Avbildningsfilspost för CVS
Formatet för en avbildningsfilspost som ska hämta innehåll från CVS är följande:
där args är en kommaavgränsad lista med nyckel-/värdepar som beskrivs nedan:
- tag, CVS-märkordet som ska kontrolleras;
- cvsRoot, en CVS-anslutningssträng;
- path, en valfri CVS-modul och sökväg där mappen som innehåller elementet hämtas. Elementets namn används som standard som modulnamn;
- prebuilt, ett valfritt booleskt värde som anger om det element som läses in är byggt i förväg. Standard är "false".
- cvsPassFile, en valfri sökväg till en CVS-lösenordsfil;
- password, ett valfritt lösenord för anslutning till CVS;
Exempel:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true
| Gamla avbildningsposter |
I Eclipse 3.2 och tidigare var avbildningsfilformatet för CVS följande:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Om inga valfria argument anges krävs kommatecken för att avgränsa efterföljande argument. Formatet ska betraktas som avvecklat och formatet key/value rekommenderas.
|
Avbildningsfilspost för Ant GET
Formatet för en avbildningsfilspost som ska hämta innehåll från en webbadress som hanteras av Ant GET är följande:
<key> = GET, <url> [,args]
där url är den webbadress som data ska hämtar från och args är en valfri kommaavgränsad lista med nyckel-/värdepar som beskrivs nedan:
- unpack, värdet "true" anger att det inlästa elementet ska packas upp
- verbose, värdet "true" anger att detaljerad förloppsinformation visas vid inläsning. Standardvärdet är false.
- ignoreerrors, värdet "true" anger att fel ska loggas under överföring. Standardvärdet är false.
- usetimestamp, läs villkorligt in en fil baserat på tidsstämpeln för den lokala kopian (endast för http-webbadresser) när värdet är "true". Standardvärdet är false.
- username, användarnamnet för "BASIC" http-autentisering
- password, det lösenord som utför inläsningen
Exempel:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true
En ny utökning i PDE/Build gör att användare kan hämta artefakter från p2-lager. Det går nu att lägga till en post i avbildningsfilen för byggindata och PDE/Build hämtar artefakten och inkluderar den i bygget. Avbildningsfilen måste innehålla ID och version för den installerbara enheten (IU) och URI-adressen till lagret där enheten finns. Metadata och artefaktlagrer förväntas vara samplacerade.
Formatet för en avbildningsfilspost för hämtning av innehåll via p2 är följande:
<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
- id, ID för den installerbara enheten
- version, den installerbara enhetens version (valfritt). Om du inte anger något hämtas den högsta tillgängliga versionen.
- repository, den plats (URI-adress) i lagret där enheten finns
Hämta funktioner med p2
I Helios-utgåvan kan funktioner hämtas med p2 genom att ange de installerbara enheter som representerar funktionernas JAR. Se sidan funktionsmetadata för mer information om strukturen för funktionernas p2-metadata.
Exempel:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo
Avbildningsfilspost för andra lager
PDE-bygget tillhandahåller en utökningspunkt där genereringsfunktioner för hämtningsskript för olika behållare kan anslutas. När Eclipse-installationen innehåller ett samlingspaket som tillhandahåller en skriptgenereringsutökning för en annan typ av lager kan du använda det lagret genom att ange det i avbildningsfilsposterna och tillämpa dem för det format som har angetts av utökningspunktleverantören.
Konfiguration för CVS-källkodshämtning
När du konfigurerar hämtning av källkod från CVS gör du följande:
- Kontrollera att cvs.exe finns i systemsökvägen.
(Hämta CVS från här).
- Skapa en mapp med namnet maps i byggkatalogen.
- Skapa en fil med tillägget .map i mappen maps.
- Fyll i den här avbildningsfilen med alla element som måste hämtas från ett lager.
- Redigera filen build.properties från konfigurationsmappen och kommentera bort raden skipFetch=true. Om den egenskapen anges hoppar PDE-bygget över hela hämtningsfasen. Om du vill att märkordet som angetts i avbildningsfilerna ska ignoreras kan du ange ett värde för egenskapen fetchTag. Det är användbart när du skapar ett nattbygge från HEAD i stället för från versionerna med märkord.
Hämta avbildningsfilerna från CVS
Avbildningsfiler lagras vanligen i ett lager. PDE-bygget har en standardinfrastruktur för hämtning av de avbildningsfilerna från ett CVS-lager.
Du kan aktivera den här funktionen genom att ändra följande egenskaper i build.properties för konfigurationen från konfigurationskatalogen:
- skipMaps: Kommentera bort den här egenskapen. Om den här egenskapen anges hämtar PDE-bygget inte avbildningsfilerna.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. Det CVS-lager som avbildningsfilerna hämtas från.
- mapsRoot =
/path/to/maps. Sökvägen i CVS-lagret till den katalog som innehåller avbildningsfilerna.
- mapsCheckoutTag =
HEAD. Det CVS-märkord som ska användas till att checka ut avbildningsfilerna.
Hämtning av avbildningsfilerna från CVS görs under förbyggsfasen av bygget. Skript för att hämta alla funktioner och insticksprogram som ingår i den funktion du bygger genereras och körs under hämtningsfasen av bygget.
Automatisk hämtning från andra lager
Om du hämtar avbildningsfilerna automatiskt från lagret måste du kopiera filen customTarget.xml från
org.eclipse.pde.build/templates/headless-build till konfigurationskatalogen. getMapFiles för målet används till att hämta avbildningsfilerna. Den bör ändras så att hämtningen görs från lagret.
Hämta källkod manuellt
Du kan skapa anpassade hämtningsmål för att hämta insticksprogram och funktioner som kan anropas från
preSetup- eller postSetup-målen i filen customTargets.xml.
Funktioner och insticksprogram ska hämtas till ${buildDirectory}/features
respektive ${buildDirectory}/plugins.