Hente fra datalagre
Infrastrukturen i PDE Build har trinn for å hente kildekoden og forhåndsbygde plugin-moduler
fra et datalager som en del av byggeprosessen
(se oppgaven eclipse.fetch
og egenskaper for å kontrollere henting).
Det finnes to muligheter: La PDE Build hente kilden automatisk eller hente kildekoden manuelt.
Første trinn mot automatisering, tilordningsfilen
Hvis IDen for en funksjon eller plugin-modul som må bygges, er oppgitt,
kan byggeinfrastrukturen hente alle de inkluderte funksjonene og
plugin-modulene fra et datalager.
PDE bruker
tilordningsfiler for å vite hvor ting skal hentes fra. En tilordningsfil
er en java-egenskapsfil som tilordner funksjons- og plugin-IDer til en plassering og
en kode i et datalager. Formatet til tilordningsfilene er åpent, og alt unntatt
key-delen er fastsatt ved PDE Build:
<elementType>@<elementID>[,<elementVersion>] = <repo specific content>
der elementType er bundle, feature, plugin eller fragment, og der
elementId og elementVersion spesifiserer elementet nærmere.
Tilordningsfiloppføring for CVS
Formatet til tilordningsfiloppføringen for å hente innhold fra CVS er som følger:
der args er en kommadelt liste over nøkkel/verdi-par som beskrevet nedenfor:
- tag, CVS-koden som skal hentes ut,
- cvsRoot, en CVS-tilkoblingsstreng,
- path, en valgfri CVS-modul og bane for henting av mappe med elementet. Som standard brukes elementnavnet som modulnavn,
- prebuilt, en valgfri boolsk parameter som angir om elementet som lastes ned, er forhåndsbygd. Som standard er dette ikke tilfellet,
- cvsPassFile, en alternativbane til en CVS-sendefil,
- password, et valgfritt passord til bruk ved tilkobling til CVS.
Eksempel:
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
| Tilordningsoppføringer i gammel stil |
I Eclipse 3.2 og tidligere var formatet for tilordningsfiler i CVS:
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Hvis av de valgfrie argumentene ikke ble oppgitt, var det fremdeles nødvendig å skrive inn komma for å avgrense de påfølgende argumentene. Dette formatet anses som foreldet, og formatet med nøkkel/verdi foretrekkes.
|
Tilordningsfiloppføring for Ant GET
Formatet til en tilordningsfiloppføring for å hente innhold fra en URL som støttes av Ant GET, er som følger:
<key> = GET, <url> [,args]
der url er URLen som data hentes fra, og args er en valgfri kommadelt liste over nøkkel/verdi-par, som beskrevet her:
- unpack: Satt til sann (true) betyr denne at det nedlastede elementet må pakkes ut.
- verbose: Satt til sann (true) viser denne detaljert fremdriftsinformasjon ved nedlasting. Standardverdien er usann (false).
- ignoreerrors: Satt til sann (true) for å logge feil under transport. Standardverdien er usann (false).
- usetimestamp: Betinget nedlasting av fil basert på tidsangivelse for lokal kopi (bare for HTTP-URLer) når den er satt til sann (true). Standardverdien er usann (false).
- username: Brukernavn for grunnleggende ("BASIC") HTTP-autentisering.
- password: Passordet for å utføre nedlastingen.
Eksempel:
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
Vi har lagt til en ny utvidelse i PDE/Build hvor brukere kan hente artefakter fra p2-datalagre. Du kan nå legge til en oppføring i tilordningsfilen din som inndata til byggingen, og deretter vil PDE/Build hente dette artefaktet og inkludere det i bygget. Oppføringen i tilordningsfilen må inneholde IDen og versjonen til den installerbare enheten (IU), i tillegg til URIen til datalageret hvor IUen finnes. Det forventes at metadataene og artefaktdatalagrene finnes på samme sted.
Formatet til tilordningsfiloppføringen for å hente innhold via p2 er som følger:
<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
- id, identifikatoren til den installerbare enheten;
- version, versjonen til den installerbare enheten (valgfritt). Hvis dette ikke er oppgitt, blir den høyeste versjonen som er tilgjengelig, hentet.
- repository, plasseringen (URI) til datalageret hvor den installerbare enheten befinner seg.
Hente funksjoner med p2
Helios-utgaven kan du hente funksjoner med p2 ved å oppgi den installerbare enheten som representerer funksjonens jar. Siden for funksjonsmetadata inneholder
detaljer for strukturen på p2-metadata for funksjoner.
Eksempler:
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
Tilordningsfiloppføring for andre datalagre
PDE Build har et utvidelsespunkt der henteskriptgeneratorer for ulike datalagre kan plugges inn. Når Eclipse-installeringen
inneholder en bunt med en skriptgeneratorutvidelse for en annen type datalager, kan du bruke dette
datalageret ved å oppgi det i oppføringene i tilordningsfilen:
Konfigurere for henting av CVS-kilde
Slik konfigurerer
du for å hente kilden fra CVS:
- Kontroller at
du har en cvs.exe i systemets søkebane. (Last ned CVS
herfra).
- Opprett en
mappe kalt maps i byggekatalogen.
- Opprett en
fil med filtypen .map i katalogen maps.
- Fyll
ut denne tilordningsfilen med alle elementene som må hentes fra et datalager.
- Rediger
build.properties-filen fra konfigurasjonsmappen, og kommenter ut linjen skipFetch=true. Hvis denne
egenskapen er definert, vil PDE Build hoppe over hele hentefasen. Hvis du
ønsker at koden som er oppgitt i tilordningsfilene, skal ignoreres, kan du definere egenskapen
fetchTag til en bestemt verdi. Dette er nyttig
når det utføres en nattlig bygging fra HEAD, i stedet for fra de kodede versjonene.
Hente tilordningsfilene fra CVS
Tilordningsfiler
er vanligvis lagret i et datalager. PDE Build
tilbyr standard infrastruktur for å hente disse tilordningsfilene fra et CVS-datalager.
Du aktiverer denne
funksjonen ved å endre de følgende egenskapene i konfigurasjonens build.properties-fil fra
konfigurasjonskatalogen:
- skipMaps: Kommenter
ut denne egenskapen. Hvis
egenskapen er definert, vil PDE ikke hente tilordningsfilene.
- mapsRepo =
:pserver:anonymous@example.com/path/to/repo. CVS-datalageret
der du vil hente tilordningsfilene.
- mapsRoot =
/path/to/maps. Banen i
CVS-datalageret til katalogen som inneholder tilordningsfilene.
- mapsCheckoutTag =
HEAD. CVS-koden som
skal brukes til å hente ut tilordningsfilene.
Henting av
tilordningsfilene fra CVS forekommer i Pre-Build-fasen av byggingen. Skript for å
hente alle funksjonene og plugin-modulene som er inkludert i funksjonen du bygger, blir generert og
kjørt i hentefasen av byggingen.
Automatisk henting fra andre datalagre
Hvis du
henter tilordningsfilene fra datalageret automatisk, må du kopiere customTarget.xml-filen fra
org.eclipse.pde.build/templates/headless-build til konfigurasjonskatalogen. Målet getMapFiles
brukes til å hente tilordningsfilene. Dette kan endres for å hente fra datalageret.
Hente kildekode manuelt
Du kan
skrive tilpassede hentemål for å hente plugin-modulene og funksjonene som kan aktiveres fra
preSetup- eller postSetup-målene i customTargets.xml-filen.
Funksjoner og plugin-moduler
bør hentes til henholdsvis ${buildDirectory}/features og ${buildDirectory}/plugins.