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:
<key> = CVS, [,args]
der args er en kommadelt liste over nøkkel/verdi-par som beskrevet nedenfor: 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: 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

Tilordningsfiloppføring for en p2-henting

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>
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:

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: 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.