Egenskaper for byggekonfigurasjon for funksjoner og plugin-moduler
Byggemekanismen er drevet av en byggekonfigurasjon. Byggekonfigurasjonen for
en enkelt plugin-modul, et enkelt fragment eller en enkelt funksjon finnes i en
build.properties-fil for det tilsvarende elementet.
Veiviseren for oppretting av PDE-prosjekter genererer build.properties-filen når
plugin-prosjektene blir opprettet. Filen inneholder informasjon om hvordan du kompilerer
kildemapper i JAR-filer. Du kan oppdatere denne informasjonen indirekte på
siden Kjøretid i manifestredigeringsprogrammet. Du kan også endre den direkte ved hjelp av det
passende redigeringsprogrammet.
PDE har et enkelt redigeringsprogram for build.properties
som har skjema- og kildevisninger.
Selve filen har formatet for Java-egenskaper. Du må oppgi
et antall nøkler og deres tilsvarende verdier. Du skiller flere verdier med komma.
Felles egenskaper
- bin.includes - viser filer som blir inkludert i den binære versjonen av plugin-modulen
som blir bygd
- bin.excludes - viser filer som skal ekskluderes fra den binære byggingen
- qualifier - når elementversjonsnummeret slutter med .qualifier, oppgir dette hvilken
verdi .qualifier må erstattes med. Verdien av egenskapen kan være enten context,
<value> eller none. context genererer en dato som samsvarer med systemdatoen,
eller bruk CVS-kodene når byggingen er automatisert. Verdien er en faktisk verdi. None
fjerner ".qualifier". Hvis egenskapen utelates, brukes context.
- custom=true - oppgir at byggeskriptet er generert manuelt og ikke automatisk. Derfor blir
ingen andre verdier konsultert.
- customBuildCallbacks -
oppgir en XML-fil som inneholder tilpassede mål som skal brukes når denne
funksjonen/plugin-modulen blir brukt. (Se
Trinn i tilpasset bygging av funksjoner og plugin-moduler)
Plugin-spesifikke egenskaper
- source.<library> - viser kildemapper som blir kompilert (for eksempel
source.xyz.jar=src/, src-ant/). Hvis biblioteket er oppgitt i plug-in.xml eller manifest.mf,
bør verdien samsvare med det
- output.<library> - viser utdatamappen som mottar resultatet av kompileringen
- exclude.<library> - viser filene som ikke skal kopieres til biblioteket av kompilatoren
- extra.<library> - ekstra klassebaner som brukes til å utføre
automatisk bygging. Klassebaner kan enten være relative baner, eller plattform-URLer som refererer
til plugin-moduler og fragmenter i utviklingsmiljøet (for eksempel
../someplugin/xyz.jar, platform:/plugins/org.apache.ant/ant.jar).
Det anbefales at plattform-URLer
brukes i stedet for relative baner
- manifest.<library> - oppgir at filen blir brukt som et manifest for
biblioteket. Filen må være plassert i en av kildemappene som blir brukt som inndata til JAR-filen.
- src.includes - viser filer som skal inkluderes i kildebyggingen
- src.excludes - viser filer som skal ekskluderes fra kildebyggingen
- jars.extra.classpath - (foreldet) samme virkning som extra.<library>,
bortsett fra at oppføringene blir brukt til alle biblioteker
- jars.compile.order - definerer rekkefølgen for kompilering av JAR-filer
(hvis det finnes flere biblioteker)
- jre.compilation.profile -
definerer miljøet som skal brukes til å kompilere denne bunten. (Se
Definere kompileringsmiljøet)
- javacSource -
definerer kildekompatibilitetsnivået for kompilering av denne bunten. Overstyrer
jre.compilation.profile.
- javacTarget -
definerer kompatibilitetsnivået for mål-.class for kompilering av denne bunten. Overstyrer
jre.compilation.profile.
- bootClasspath -
definerer oppstartsklassebanen som denne bunten skal kompileres mot. Overstyrer
jre.compilation.profile.
- javacWarnings.<library>
- definerer advarselsalternativene som skal sendes til kompilatoren. (Les om
alternativet -warn under Compiling
Java Code i utviklerhåndboken for JDT-plugin-moduler).
- javacDefaultEncoding.<library>
- definerer standardkodingen som skal brukes ved kompilering av det gitte biblioteket.
- javacCustomEncodings.<library>
- en kommadeltliste over baner og kodinger som skal brukes ved kompilering av det
gitte biblioteket. Eksempel:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Verdiene som er definert for disse nøklene som slutter med
"includes" eller "excludes", uttrykkes som Ant-"mønstres". Standardformatene gir de forventede
resultatene. "*.jar"
betyr for eksempel alle jar-filene i
toppnivåkatalogen. Mønstrene er som standard ikke dype. Hvis du for eksempel vil beskrive
alle Java-filer, bør du bruke mønsteret "**/*.java". Mønsteret
"**" samsvarer med et hvilket som helst antall katalognivåer. På samme måte beskriver
"xyz/" hele undertre.
Funksjonsspesifikke
egenskaper
- root - viser filene og mappene som må være inkludert i roten av
produktet. Disse verdiene støttes:
- <folderName> - en relativ bane til en mappe som skal kopieres
- file:<fileName> - en relativ bane til en fil som skal kopieres
- absolute:<folderName> - en absolutt bane til en mappe som skal kopieres
- absolute:file:<fileName> - en absolutt bane til en fil som skal kopieres
- root.<config> - viser filene og mappene som må
inkluderes i roten av produktet når det er bygd for den oppgitte konfigurasjonen. config består av
det tre (3) segmentene av en konfigurasjon atskilt med punktum
- root.permissions.<permissionValue> - viser filene og mappene
til chmod for den oppgitte verdien. Referanse til mapper må slutte med '/'
- root.permissions.<config>.<permissionValue> - viser filene og mappene
til chmod for den oppgitte verdien for en bestemt konfigurasjon. Referanse til mapper må
slutte med '/'
- root.link - viser parvis (atskilt med komma) filene og
mappene som må linkes symbolsk. Den første oppføringen er kilden
(målet i Unix-terminologien) og den andre oppføringen er linknavnet
- root.link.<config> - en kommadelt liste over par av filer og mapper
som må linkes symbolsk for en bestemt konfigurasjon. Den første oppføringen er kilden
(målet i Unix-terminologien) og den andre oppføringen er linknavnet
- generate.feature@<featureId> - oppgir at kildefunksjonen
featureId blir kildefunksjon for funksjonen som er oppgitt som verdi for denne
egenskapen. Verdiene som er
oppført etter første komma, står for elementer som må hentes fra datalageret. (Se
Generere kildefunksjoner og -plugin-moduler)
- generate.plugin@<pluginId> - oppgir at kilde-plugin-modulen
pluginId skal være kilde-plugin for det som er oppgitt som verdien av denne egenskapen
- significantVersionDigits
- antall signifikant siffer som skal brukes ved generering av
funksjonsversjonssuffikser (se Versjonskvalifikatorer)
- generatedVersionLength -
lengden på det genererte funksjonsversjonssuffikset.
Eksempelet nedenfor hentet ut fra build.properties for funksjonen org.eclipse.platform.
bin.includes=epl-v10.html,eclipse_update_120.jpg,feature.xml,feature.properties,license.html
root=rootfiles,file:../../plugins/org.eclipse.platform/startup.jar,configuration/
root.permissions.755=eclipse
root.linux.motif.x86=../../plugins/platform-launcher/bin/linux/motif,linux.motif
root.linux.motif.x86.link=libXm.so.2.1,libXm.so.2,libXm.so.2.1,libXm.so
root.linux.motif.x86.permissions.755=*.so*