Ophalen uit repository's
De infrastructuur van PDE Build biedt mogelijkheden voor het ophalen van broncode en
vooraf gegenereerde plugins uit een repository als onderdeel van het buildproces (zie de taak eclipse.fetch
en de eigenschappen voor besturing van het ophaalproces).
Er zijn twee mogelijkheden: PDE Build de broncode automatisch laten ophalen of de broncode handmatig ophalen.
Eerste stap voor automatisering, het toewijzingsbestand
Gegeven het ID van de feature of plugin die moet worden gebouwd, is de build-infrastructuur
in staat om alle opgenomen features en plugins op te halen uit een repository.
PDE gebruikt toewijzingsbestanden om vast te stellen waaruit zaken moeten worden opgehaald. Een toewijzingsbestand is een Java-eigenschappenbestand dat feature- en plugin-ID's aan een locatie en code toewijst in een repository. De indeling van toewijzingsbestanden is uitbreidbaar. Alleen het key-gedeelte is vastomlijnd in PDE Build:
<elementType>@<elementID>[,<elementVersion>] = <repo-specifieke content>
waarbij elementType een bundel, feature,
plugin of fragment is en elementId en elementVersion
de specifieke aanduiding vormen van het element.
Toewijzingsbestandsinvoer voor CVS
De indeling van een toewijzingsbestand om content uit CVS op te halen is als volgt:
waarbij args een door komma's gescheiden lijst van key/value-paren is, zoals hieronder wordt beschreven:
- tag, de CVS-tag om uit te checken;
- cvsRoot, een CVS-verbindingsreeks;
- path, een optionele CVS-module en pad waaruit de map met het element wordt opgehaald. Standaard wordt de elementnaam gebruikt als modulenaam;
- prebuilt, een optionele booleaanse waarde die aangeeft of het gedownloade element vooraf gegenereerd is. De standaardwaarde is false;
- cvsPassFile, een optioneel pad naar een CVS-doorgeefbestand;
- password, een optioneel wachtwoord voor de verbinding met CVS;
Voorbeeld:
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
| Toewijzingsitems oude stijl |
In Eclipse 3.2 en eerdere versies was de indeling van toewijzingsbestanden voor CVS:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Als optionele argumenten niet worden opgegeven, is het nog steeds vereist om de volgende argumenten te scheiden met komma's. Deze indeling wordt beschouwd als gedeprecieerd en de indeling sleutel/waarde wordt geprefereerd.
|
Toewijzingsbestandsinvoer voor Ant GET
De indeling van een toewijzingsbestand om content op te halen van een URL die wordt ondersteund door Ant GET is als volgt:
<key> = GET, <url> [,args]
waarbij url het URL-adres is waarvandaan de gegevens worden opgehaald en args een optionele door gescheiden lijst van key/value-paren, zoals hieronder wordt beschreven:
- unpack, stel deze waarde in op true als het gedownloade element moet worden uitgepakt (gedecomprimeerd);
- verbose, stel deze waarde in op true als er uitgebreide voortgangsinformatie moet worden afgebeeld tijdens het downloaden. De standaardwaarde is false;
- ignoreerrors, stel deze waarde in op true als fouten tijdens het transport moeten worden vastgelegd in een logboek. De standaardwaarde is false;
- usetimestamp, voorwaardelijk een bestand downloaden op basis van de tijdsaanduiding van de lokale kopie (alleen voor http-URL's) indien ingesteld op true. De standaardwaarde is false;
- username, de gebruikersnaam voor "BASIC" http-verificatie;
- password, het wachtwoord om de downloadbewerking uit te voeren.
Voorbeeld:
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
Er is een nieuwe extensie toegevoegd aan PDE/Build waarmee gebruikers artefacten op kunnen halen uit p2-repository's. U kunt nu een item toevoegen een uw toewijzingsbestand voor invoer van de build en PDE/Build haalt het artefact op en neemt deze op in de build. In de invoer voor het toewijzingsbestand moeten het ID en de versie van de installeerbare eenheid (IU) zijn opgenomen, alsmede de URI van de repository waar de IU kan worden gevonden. Er wordt aangenomen dat de metagegevens en artefactrepository's zijn samengevoegd.
De indeling van een toewijzingsbestand om content op te halen via p2 is als volgt:
<elementType>@<elementID> = p2IU, id=<id>, version=<versie>, repository=<repository>
- id, het ID van de installeerbare eenheid;
- version, de versie van de installeerbare eenheid (optioneel). Indien niet opgegeven, wordt de hoogste beschikbare versie opgehaald.
- repository, de locatie (URI) van de repository waar de IU wordt gevonden.
Features ophalen met p2
In de Helios-release kunnen features met p2 worden opgehaald door de installeerbare eenheid op te geven die het JAR-bestand van de feature vertegenwoordigt. Zie de pagina metagegevens van feature voor meer informatie over de structuur van p2-metagegevens voor features.
Voorbeelden:
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
Toewijzingsbestandsinvoer voor andere repository's
PDE Build biedt een extensiepunt waar scriptgenerators voor ophaalbewerkingen voor verschillende
repository's kunnen worden ingeplugd. Als uw Eclipse-installatie
een bundel omvat met een scriptgenerator-extensie voor een ander type repository, kunt u
die repository gebruiken door deze op te geven in uw toewijzingsbestandinvoer volgens de indeling
die is aangegeven door de provider van de extensie.
Instellingen definiëren voor het ophalen van de bron uit CVS
Voor het definiëren van instellingen voor het ophalen van de bron uit CVS gaat u als volgt te werk:
- Zorg dat er een cvs.exe aanwezig is in het zoekpad van uw systeem.
(Download CVS van ).
- Maak een map met de naam "maps" in de builddirectory.
- Maak een bestand met de extensie .map in de map "maps".
- Vul dit toewijzingsbestand met alle elementen die uit een repository moeten worden opgehaald.
- Bewerk het bestand build.properties in de configuratiemap en schakel de regel skipFetch=true uit. Als deze eigenschap is ingeschakeld, slaat PDE Build de gehele ophaalfase namelijk over. Als u wilt dat de code die in de toewijzingsbestanden is opgegeven, wordt genegeerd, kunt u de eigenschap fetchTag op een specifieke waarde instellen. Dit is handig wanneer u elke nacht een build van HEAD maakt in plaats van de gelabelde versies.
De toewijzingsbestanden ophalen uit CVS
Toewijzingsbestanden worden doorgaans opgeslagen in een repository. PDE Build biedt een standaardinfrastructuur om deze toewijzingsbestanden op te halen uit een CVS-repository.
Om deze functie in te schakelen, wijzigt u de volgende eigenschappen in het bestand build.properties van de configuratie in de configuratiedirectory:
- skipMaps: schakel deze eigenschap uit. Als deze eigenschap is ingeschakeld, haalt PDE Build de toewijzingsbestanden niet op.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. De CVS-repository waaruit de toewijzingsbestanden worden opgehaald.
- mapsRoot =
/path/to/maps. Het pad in de CVS-repository naar de directory
met de toewijzingsbestanden.
- mapsCheckoutTag =
HEAD. De CVS-code die wordt gebruikt om de toewijzingsbestanden uit te checken.
Het ophalen van de toewijzingsbestanden uit CVS vindt plaats tijden de pre-buildfase van de build. Scripts voor het ophalen van alle features en plugins die zijn opgenomen in de feature die u bouwt, worden gegenereerd en uitgevoerd tijdens de ophaalfase van de build.
Automatisch ophalen uit andere repository's
Als u de toewijzingsbestanden automatisch uit de repository ophaalt, moet u het bestand customTarget.xml uit org.eclipse.pde.build/templates/headless-build naar uw configuratiedirectory kopiëren. Het doel getMapFiles wordt gebruikt om de toewijzingsbestanden op te halen. Dit moet worden gewijzigd als u uit de repository wilt ophalen.
Broncode handmatig ophalen
U kunt aangepaste ophaaldoelen schrijven om uw plugins en features op te halen. Deze kunnen worden aangeroepen vanuit de doelen preSetup of postSetup in het bestand customTargets.xml.
Features en plugins moeten worden opgehaald naar respectievelijk
${buildDirectory}/features
en
${buildDirectory}/plugins.