Koonnin tulosmuodon ohjaus
Tässä osiossa kuvaillaan, miten tuoteominaisuuden tai tuotteen koonnin tulosta voi ohjata.
Tulosmuodon ohjaus
Ominaisuuden archivesFormat avulla voi määrittää koonnin tulosmuodon (zip, tar ja kansio) kokoonpanoperusteisesti. Ominaisuuden muoto on <kokoonpano> - <muoto>, jossa kokoonpano on sama arvo kuin configs-ominaisuudessa määritetty arvo ja muoto on jokin seuraavista arvoista.
- folder - tulos tallennetaan kansioon, joka sijaitsee kohteessa ${buildDirectory}/tmp/${archivePrefix}. Tiedostossa allElements.xml määritettyjä kohteita ei käytetä tässä tapauksessa.
Voimassa olevien rajoitusten takia folder-tulosmuotoa käytettäessä voidaan koota vain yksi kokoonpano kerrallaan.
- zip - tulos tallennetaan zip-tiedostoon. Zip-tiedoston luo koonnin ajavalla tietokoneella sijaitseva zip.exe. Tämä vaihtoehto on hyödyllinen, jos käytössä on tiettyjä käyttöoikeuksia edellyttäviä tiedostoja sisältäviä lisäosia, jotka eivät sisälly jar-arkistoihin (pääosin UNIX-järjestelmään perustuvissa järjestelmissä).
Ominaisuuden zipargs avulla voi välittää lisäasetuksia zip-komentoon.
- antZip - tulos tallennetaan zip-tiedostoon. Zip-tiedoston luo Ant-työkalujen zip-toteutus. Tämä on oletusarvo, jos arvoa ei määritetä.
- tar - tulos tallennetaan gzip-arkistoituun tar-tiedostoon.
Käyttöjärjestelmän tar- ja gzip-toteutukset ovat käytössä. Ominaisuuden tarargs avulla voi välittää lisäasetuksia tar-komentoon.
Huomaa, että tulosmuodon muuttaminen ei muuta luodun tiedoston nimeä. Se tulee muuttaa allElements.xml-tiedostossa.
JNLP-manifest-tiedostojen muodostus
JNLP-manifest-tiedostojen muodostus koonnin aikana otetaan käyttöön määrittämällä ominaisuuden generateJnlp arvoksi true, ominaisuuden jnlp.codebase arvoksi sijainti, josta jnlp-tiedostoa jaellaan (tutustu codebase-määritteeseen jnlp-tunnisteessa) ja määrittämällä ominaisuus jnlp.j2se käyttöön.
Huomaa, että tällöin lisäosia ja tuoteominaisuuksia ei paketoida päivityssivustoa varten. Lisätietoja on jäljempänä ohjeessa "Tuloksen valmistelu päivitys- tai jnlp-sivustoa varten".
Voimassa olevien rajoitusten takia jnlp-manifest-tiedoston luonti toimii vain, kun kansioita tuotetaan tulosmuotona.
Tuloksen valmistelu päivitys- tai jnlp-sivustoa varten
Kun lisäosia ja tuoteominaisuuksia viedään päivitys- tai Java Web -aloitussivustoihin, ne tulee paketoida oikein. Voit tehdä tämän määrittämällä outputUpdateJars-ominaisuuden arvoksi true. Huomaa, että tällä tavoin ei muodosteta tiedostoa site.xml Eclipse-päivityssivustoa varten eikä jnlp-tiedostoja (lisätietoja on ohjeessa "Jnlp-tiedostojen muodostus").
Useiden kokoonpanojen ryhmitys yhteen arkistoon
Jos haluat tuottaa tuloksen, joka sisältää useiden kokoonpanojen lisäosat ja tuoteominaisuudet, määritä ominaisuuden groupConfigurations arvoksi true.
Tällä tavoin luodaan arkisto, joka sisältää kaikki configs-ominaisuudessa lueteltuja kokoonpanoja vastaavat lisäosat ja tuoteominaisuudet.
Kun käytät tätä ominaisuutta, muista lisätä <feature.id>.group.group.group-niminen kohde tiedostoon
allElements.xml.
Voimassa olevien rajoitusten takia tämän asetuksen käyttö aiheuttaa archivesFormat-ominaisuudessa määritetyn arvon ohituksen ja oletusarvon antZip käytön.
Jar-arkistojen allekirjoitus
Voit allekirjoittaa jar-arkistoja koonnin aikana määrittämällä ominaisuuden signJars arvoksi true ja määrittämällä arvot ominaisuuksille sign.alias, sign.keystore ja sign.storepass.