Tuoteominaisuuksien ja lisäosien kokoonpanon ominaisuudet
Koontikokoonpano ohjaa koontimekanismia. Yksittäisen lisäosan, fragmentin tai tuoteominaisuuden koontikokoonpano löytyy vastaavan elementin build.properties-tiedostosta.
PDE-kehitysympäristön ohjatut projektien luontitoiminnot muodostavat build.properties-tiedoston lisäosaprojekteja luotaessa. Tiedostossa olevien tietojen avulla lähdekansiot käännetään JAR-arkistoiksi. Nämä tiedot voidaan päivittää epäsuorasti manifest-tiedoston muokkausohjelman Ajonaikainen ympäristö -sivulle. Niitä voidaan myös muokata suoraan sopivassa muokkausohjelmassa.
PDE-kehitysympäristössä on build.properties-tiedostoa varten yksinkertainen muokkausohjelma, jossa on lomake- ja lähdenäkymiä.
Itse tiedosto on Java-ominaisuusmuodon mukainen. Tiedostoon on määritettävä joukko avaimia ja niiden arvot. Jos arvoja on useita, ne erotetaan pilkulla.
Yleiset ominaisuudet
- bin.includes - luettelee tiedostot, jotka sisällytetään koottavan lisäosan binaariversioon.
- bin.excludes - luettelee binaarikoonnista pois jätettävät tiedostot.
- qualifier - kun elementin versionumeron lopussa on .qualifier, tämä ominaisuus osoittaa, millä arvolla .qualifier korvataan. Ominaisuuden arvo voi olla context, <value> tai none. Context-arvo muodostaa päivämäärän järjestelmän päivämäärän perusteella tai käyttää CVS-tunnisteita, kun koonti automatisoidaan. Value on todellinen arvo. Arvo "none" poistaa ".qualifier"-tunnisteen. Jos ominaisuus jätetään pois, käytetään arvoa context.
- custom=true - osoittaa, että koontikomentosarja muodostetaan käsin sen sijaan, että se muodostettaisiin automaattisesti. Siksi mitään muuta arvoa ei tarvita.
- customBuildCallbacks -
osoittaa xml-tiedoston, joka sisältää mukautettuja kohteita, joita käytetään tämän tuoteominaisuuden tai lisäosan käytön yhteydessä. (Lisätietoja on kohdassa Tuoteominaisuuksien ja lisäosien mukautetun koonnin vaiheet)
Lisäosan erityisominaisuudet
- source.<kirjasto> - luettelee käännettävät lähdekansiot (esimerkiksi source.xyz.jar=src/, src-ant/).
Jos kirjasto määritetään plug-in.xml- tai manifest.mf-tiedostossa, arvon tulee vastata sitä.
- output.<kirjasto> - luettelee käännöksen tuloksen vastaanottavan tulostuskansion.
- exclude.<library> - luettelee tiedostot, joita kääntäjä ei kopioi kirjastoon:
- extra.<kirjasto> - automatisoidussa koonnissa käytettävät lisäluokkapolut. Luokkapolut voivat olla joko suhteellisia polkuja tai käyttöympäristön URL-osoitteita, jotka viittaavat kehitysympäristössä oleviin lisäosiin ja fragmentteihin (esimerkiksi ../someplugin/xyz.jar, platform:/plugins/org.apache.ant/ant.jar).
Käyttöympäristön URL-osoitteita suositellaan käytettäväksi suhteellisten polkujen sijasta.
- manifest.<kirjasto> - osoittaa kirjaston manifest-tiedostona käytettävän tiedoston. Tiedoston on oltava jossakin JAR-arkiston syötteenä käytettävässä lähdekansiossa.
- src.includes - luettelee lähteen koontiin sisällytettävät tiedostot.
- src.excludes - luettelee lähteen koonnista pois jätettävät tiedostot.
- jars.extra.classpath - (vanhentunut) sama vaikutus kuin extra.<kirjasto>-määrityksellä, mutta merkinnät koskevat kaikkia kirjastoja.
- jars.compile.order - määrittää JAR-arkistojen käännösjärjestyksen (jos kirjastoja on useita).
- jre.compilation.profile -
määritä käytetty ympäristö kääntämään tämä resurssijoukko. (Lisätietoja on kohdassa Käännösympäristön hallinta)
- javacSource - aseta lähteen yhteensopivuustaso tämän resurssijoukon käännöksessä. Ohittaa kohteen jre.compilation.profile.
- javacTarget - aseta .class-kohteen yhteensopivuustaso
tämän resurssijoukon käännöksessä. Ohittaa kohteen jre.compilation.profile.
- bootClasspath - aseta alkulatauksen luokkapolku, jota vasten tämä resurssijoukko käännetään. Ohittaa kohteen jre.compilation.profile.
- javacWarnings.<library>
- aseta kääntäjälle välitettävät varoitusasetukset. (Katso asetus -warn JDT-lisäosan kehittäjän oppaan kohdassa Java-koodin käännös.)
- javacDefaultEncoding.<library>
- asettaa kirjaston käännöksessä käytettävän oletuskoodauksen.
- javacCustomEncodings.<library>
- pilkuin erotettu luettelo kirjaston käännöksessä käytettävistä poluista ja koodauksista. Esimerkki:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
Näille avaimille määritetyt includes- tai excludes-päätteiset arvot ilmaistaan Ant-ohjelman "malleina". Vakiomuodot antavat odotettuja tuloksia. Esimerkiksi "*.jar" tarkoittaa kaikkia ylätason hakemistossa olevia JAR-tiedostoja. Mallit eivät oletusarvoisesti mene yksityiskohtaiselle tasolle. Jos haluat kuvata esimerkiksi kaikki Java-tiedostot, käytä mallia **/*.java. Malli ** vastaa mitä tahansa hakemistotasojen määrää. Jos haluat kuvata kokonaisia alirakenteita, käytä mallia xyz/.
Tuoteominaisuuskohtaiset ominaisuudet
- root - luettele tuotteen juurihakemistoon sisällytettävät tiedostot ja kansiot. Tuetut arvot ovat:
- <kansion nimi> - kopioitavan kansion suhteellinen polku.
- file:<tiedoston nimi> - kopioitavan tiedoston suhteellinen polku.
- absolute:<kansion nimi> - kopioitavan kansion tarkka polku.
- absolute:file:<tiedoston nimi> - kopioitavan tiedoston tarkka polku.
- root.<kokoonpano> - luettele tiedostot ja kansiot, joiden on oltava tuotteen juurihakemistossa silloin, kun tuotteen koonnissa käytetään määritettyä kokoonpanoa. Kokoonpano muodostuu kolmesta toisistaan pisteellä erotetusta osasta.
- root.permissions.<käyttöoikeuksien arvo> - luettele tiedostot ja kansiot, joille asetetaan annettu käyttöoikeuksien arvo (chmod-komennolla). Kansioviittausten täytyy päättyä vinoviivaan.
- root.permissions.<kokoonpano>.<käyttöoikeuksien arvo> - luettele määritetyn kokoonpanon tiedostot ja kansiot, joille asetetaan annettu käyttöoikeuksien arvo (chmod-komennolla). Kansioviittausten täytyy päättyä vinoviivaan.
- root.link - luettele pareittain (pilkuin erotettuna) symbolisesti linkitettävät tiedostot ja kansiot. Ensimmäinen merkintä osoittaa lähteen (Unix-terminologiassa kohteen) ja toinen merkintä linkin nimen.
- root.link.<kokoonpano> - pilkuin erotettu luettelo sellaisten määritetyn kokoonpanon tiedostojen ja kansioiden pareista, jotka on linkitettävä symbolisesti. Ensimmäinen merkintä osoittaa lähteen (Unix-terminologiassa kohteen) ja toinen merkintä linkin nimen.
- generate.feature@<tuoteominaisuuden tunnus> - osoittaa, että kohdassa tuoteominaisuuden tunnus mainitusta lähdetuoteominaisuudesta tulee tämän ominaisuuden arvona määritetyn tuoteominaisuuden lähdetuoteominaisuus.
Ensimmäisen pilkun jälkeen luetellut arvot osoittavat tietovarastosta noudettavat elementit. (Lisätietoja on kohdassa Lähdelisäosien ja tuoteominaisuuksien muodostus.)
- generate.plugin@<lisäosan tunnus> - osoittaa, että kohdassa lisäosan tunnus mainitusta lähdeosasta tulee tämän ominaisuuden arvona määritetyn lisäosan lähdelisäosa.
- significantVersionDigits
- Merkitsevien numeroiden määrä tuoteominaisuusversion loppuliitteiden muodostuksessa. (Lisätietoja on kohdassa Versiotarkenteet.)
- generatedVersionLength -
Muodostetun tuoteominaisuusversion loppuliitteen pituus.
Seuraava esimerkki on noudettu org.eclipse.platform-tuoteominaisuuden build.properties-tiedostosta.
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*