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. (Lisätietoja on aiheessa Versiotarkenteet.)
- 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)
- customBuildCallbacks.failonerror - määrittää subant-tehtävän failonerror-parametrin. Oletusarvo on false.
- customBuildCallbacks.buildpath - määrittää subant-tehtävän koontipolkuparametrin. Käytetään, kun mukautetun vastakutsun tiedostolla ei ole lisäosan juureen nähden suhteellista sijaintia.
- customBuildCallbacks.inheritall - määrittää subant-tehtävän inheritall-parametrin. Ant-tehtävän oletusarvo on false.
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).
Kääntäjän asetukset. Katso myös Käännösympäristön hallinta- ja
Kääntäjän asetukset -sivuja.
- jre.compilation.profile - määritä käytetty ympäristö kääntämään tämä resurssijoukko.
- 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 Java-kehityksen käyttäjän oppaan -warn-valinnasta
kertovaa kohtaa ohjeessa Eräkääntäjän käyttö).
- javacErrors.<library>
- aseta kääntäjälle välitettävät virheasetukset. (Katso Java-kehityksen käyttäjän oppaan -err-valinnasta
kertovaa kohtaa ohjeessa Eräkääntäjän käyttö).
- 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]
- javacProjectSettings - Suhteellinen polku oletusasetustiedostoon, joka määrittää JDT-kääntäjän oletusasetukset. Määritä ominaisuuden arvoksi true, jos haluat käyttää oletusasetuksia ".settings/org.eclipse.jdt.core.prefs".
- compilerArg - määritä mukautetut kääntäjän argumentit
- compilerAdapter - määritä mukautettu kääntäjän sovitin käytettäväksi oletussovittimen org.eclipse.jdt.core.JDTCompilerAdapter sijasta
- compilerAdapter.useLog - true/false: määrittää, vastaanottaako mukautettu kääntäjän sovitin -log-argumentin.
- -compilerAdapter.useArgFile - true/false: määrittää, vastaanottaako mukautettu kääntäjän sovitin muodostetun javaCompiler.<library>.args-argumenttitiedoston
- sourceFileExtensions - luettelo laajennuksista (*.java, *.aj), jotka pitää ottaa huomioon lähdetiedostoina käytettäessä kääntäjän sovitinta.
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. Kohdassa Juuritiedostojen ohjesivu on lisätietoja ja seuraavat lisäominaisuudet:
- root.<config>: kokoonpanon juuritiedostot.
- root.folder : alikansioissa sijaitsevat juuritiedostot.
- root.permissions : chmod-komennot juuritiedostoissa.
- root.link : softlink-linkkien luonti juuritiedostoille.
- 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,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*