Eclipse-ympäristön tuoteominaisuuden manifest-tiedosto
Versio 3.0 - Viimeksi muutettu 22.6.2004
Tuoteominaisuuden manifest-tiedoston muodon dtd-määritys on seuraava:
<?xml encoding="ISO-8859-1"?>
<!ELEMENT feature (install-handler? | description? | copyright? |
license? | url? | includes* | requires? | plugin* | data*)>
<!ATTLIST feature
id
CDATA #REQUIRED
version
CDATA #REQUIRED
label
CDATA #IMPLIED
provider-name CDATA #IMPLIED
image
CDATA #IMPLIED
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl CDATA #IMPLIED
colocation-affinity
CDATA #IMPLIED
primary
(true | false) "false"
exclusive (true | false)
"false"
plugin CDATA
#IMPLIED
application CDATA #IMPLIED
>
<!ELEMENT install-handler EMPTY>
<!ATTLIST install-handler
library
CDATA #IMPLIED
handler
CDATA #IMPLIED
>
<!ELEMENT description (#PCDATA)>
<!ATTLIST description
url
CDATA #IMPLIED
>
<!ELEMENT copyright (#PCDATA)>
<!ATTLIST copyright
url
CDATA #IMPLIED
>
<!ELEMENT license (#PCDATA)>
<!ATTLIST license
url
CDATA #IMPLIED
>
<!ELEMENT url (update?, discovery*)>
<!ELEMENT update EMPTY>
<!ATTLIST update
url
CDATA #REQUIRED
label
CDATA #IMPLIED
>
<!ELEMENT discovery EMPTY>
<!ATTLIST discovery
type
(web | update) "update"
url
CDATA #REQUIRED
label
CDATA #IMPLIED
>
<!ELEMENT includes EMPTY>
<!ATTLIST includes
id
CDATA #REQUIRED
version
CDATA #REQUIRED
name
CDATA #IMPLIED
optional (true | false)
"false"
search-location (root | self | both)
"root"
os CDATA #IMPLIED
arch CDATA #IMPLIED
ws CDATA #IMPLIED
nl CDATA #IMPLIED
>
<!ELEMENT requires (import+)>
<!ELEMENT import EMPTY>
<!ATTLIST import
plugin
CDATA #IMPLIED
feature CDATA #IMPLIED
version
CDATA #IMPLIED
match
(perfect | equivalent | compatible | greaterOrEqual) "compatible"
patch (true |
false) "false"
>
<!ELEMENT plugin EMPTY>
<!ATTLIST plugin
id
CDATA #REQUIRED
version
CDATA #REQUIRED
fragment (true
| false) "false"
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl CDATA #IMPLIED
download-size CDATA #IMPLIED
install-size CDATA #IMPLIED
unpack (true |
false) "true"
>
<!ELEMENT data EMPTY>
<!ATTLIST data
id
CDATA #REQUIRED
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl CDATA #IMPLIED
download-size CDATA #IMPLIED
install-size CDATA #IMPLIED
>
Elementin ja määritteen määritykset ovat seuraavat:
- <feature> - määrittää tuoteominaisuuden
- id - pakollinen tuoteominaisuuden tunnus (esimerkiksi com.xyz.myfeature)
- versio - pakollinen komponentin versio (esimerkiksi 1.0.3)
- label - valinnainen näytettävä nimiö (nimi). Se on tarkoitus kääntää.
- provider-name - valinnainen näyttönimiö, jonka avulla komponentin toimittava organisaatio tunnistetaan. Se on tarkoitus kääntää.
- image - valinnainen kuva, jota käytetään näytettäessä tuoteominaisuutta koskevia tietoja. Määritetään suhteessa feature.xml-tiedostoon.
- os - valinnainen käyttöjärjestelmän määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä käyttöjärjestelmän nimistä (ks. luokan
org.eclipse.core.runtime.Platform Javadoc.
Osoittaa, että tuoteominaisuus tulee asentaa vain johonkin määritetyistä käyttöjärjestelmistä. Jos tämän määritteen arvoa
ei ole määritetty, tuoteominaisuus voidaan asentaa kaikkiin järjestelmiin (kannettava
toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa tuoteominaisuuden asennuksen tästä asetuksesta huolimatta).
- arch - valinnainen koneen arkkitehtuurin määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä arkkitehtuurin nimistä (ks. luokan
org.eclipse.core.runtime.Platform) Javadoc.
Se osoittaa, että tämä tuoteominaisuus asennetaan vain
määritettyyn järjestelmään. Jos tämän määritteen arvoa
ei ole määritetty, tuoteominaisuus voidaan asentaa kaikkiin järjestelmiin (kannettava
toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa tuoteominaisuuden asennuksen tästä asetuksesta huolimatta).
- ws - valinnainen ikkunointijärjestelmän määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä ikkunointijärjestelmän nimistä (ks. luokan
org.eclipse.core.runtime.Platform) Javadoc.
Se osoittaa, että tämä tuoteominaisuus asennetaan vain
määritettyyn ikkunointijärjestelmään. Jos tämän määritteen arvoa
ei ole määritetty, tuoteominaisuus voidaan asentaa kaikkiin järjestelmiin (kannettava
toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa tuoteominaisuuden asennuksen tästä asetuksesta huolimatta).
- nl - valinnainen paikallistunnuksen määritys. Tämä on pilkuin erotettu luettelo Javan määrittämistä paikallistunnuksen nimistä. Se osoittaa, että tämä tuoteominaisuus asennetaan vain järjestelmään,
jossa on yhteensopiva paikallistunnus (Javan paikallistunnusten vastaavuussääntöjen mukaan). Jos tämän määritteen arvoa
ei ole määritetty, tuoteominaisuus voidaan asentaa kaikkiin järjestelmiin (kielellisesti neutraali
toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa tuoteominaisuuden asennuksen tästä asetuksesta huolimatta).
- colocation-affinity - valinnainen viittaus toiseen tuoteominaisuuden tunnukseen, jota käytetään tämän tuoteominaisuuden oletusasennuspaikan valintaan. Kun tämä tuoteominaisuus asennetaan uutena tuoteominaisuutena (siitä ei ole asennettu muita versioita), se yritetään asentaa samaan asennuspaikkaan kuin tuoteominaisuus, johon viitataan.
- primary - valinnainen tieto, joka määrittää, voidaanko tuoteominaisuutta käyttää ensisijaisena tuoteominaisuutena. Oletusarvo on false
(ei ensisijainen tuoteominaisuus).
- application - Eclipse-sovelluksen valinnainen tunnus, jota käytetään aloituksen aikana, kun esittelevä tuoteominaisuus on ensisijainen tuoteominaisuus. Sovelluksen tunnuksen täytyy edustaa org.eclipse.core.runtime.applications-laajennuspisteessä rekisteröityä kelvollista sovellusta. Oletusarvo on org.eclipse.ui.ide.workbench.
- plugin - valinnainen tunnus, joka edustaa sellaista tuoteominaisuudessa mainittua lisäosaa, jota käytetään tuoteominaisuuden tuotteistustietojen (esimerkiksi kuvien, käännösten ja ensisijaisen tuoteominaisuuden aloitusruudun) esittämiseen. Jos tunnus jätetään määrittämättä, oletuksena on, että lisäosalla on sama tunnus kuin tuoteominaisuudella.
- exclusive - valinnainen määrite, jonka arvo true osoittaa, että tuoteominaisuutta ei voi asentaa ryhmään muiden tuoteominaisuuksien kanssa.
- <install-handler>
- library - valinnainen .jar-kirjasto, joka sisältää asennuksen käsittelytoiminnon luokat.
Jos kirjasto määritetään, .jar-tiedoston, johon viitataan, on oltava tuoteominaisuusarkistossa.
Se määritetään tuoteominaisuusarkistossa olevana polkuna suhteessa feature.xml-merkintään. Jos kirjastoa ei määritetä, asennuksen käsittelytoiminnon luokkien lataukseen käytetään itse tuoteominaisuusarkistoa. Tämä määrite tulkitaan vain, jos myös class-määritteen arvo määritetään.
- handler - asennuksen käsittelytoiminnon valinnainen tunnus. Arvo tulkitaan library-määritteelle annetun arvon mukaan. Jos library-määritteen arvo määritetään, arvoksi tulkitaan määritetyssä kirjastossa olevan luokan tarkennettu nimi. Jos library-määritteen arvo jätetään määrittämättä, arvoksi tulkitaan org.eclipse.update.installHandlers-laajennuspisteessä rekisteröidyn laajennuksen tunnus. Molemmissa tapauksissa tuloksena olevan luokan täytyy toteuttaa IInstallHandler-rajapinta. Luokka ladataan ja sitä kutsutaan dynaamisesti tietyissä kohdissa tuoteominaisuuden käsittelyn aikana. Jos käsittelytoiminto on määritetty luokkana, se näkyy org.eclipse.update.core-lisäosan API-luokille ja tämän lisäosan edellyttämille Eclipse-lisäosille. Jos se on määritetty laajennuksena, se pystyy käyttämään kaikkia luokkia laajennuksen määrittävänä lisäosana.
- <description> - komponentin lyhyt kuvaus tavallisena tekstinä. Se on tarkoitus kääntää.
- url - valinnainen URL-osoite koko kuvaukseen HTML-muodossa. URL-osoite voidaan määrittää
tarkkana tai suhteellisena. Jos osoite määritetään suhteellisena, sen oletetaan olevan määritetty suhteessa tuoteominaisuusarkistoon (ja paketoitu siihen). Huomaa, että URL-arvo on erotettava kansallisten kielten käsittelyssä, jotta
kullekin kielelle voidaan määrittää vaihtoehtoiset URL-osoitteet.
- <copyright> - tuoteominaisuuden copyright-tieto tavallisena tekstinä. Se on tarkoitus kääntää.
- url - valinnainen URL-osoite koko kuvaukseen HTML-muodossa. URL-osoite voidaan määrittää
tarkkana tai suhteellisena. Jos osoite määritetään suhteellisena, sen oletetaan olevan määritetty suhteessa tuoteominaisuusarkistoon (ja paketoitu siihen). Huomaa, että URL-arvo on erotettava kansallisten kielten käsittelyssä, jotta
kullekin kielelle voidaan määrittää vaihtoehtoiset URL-osoitteet.
- <license> - tuoteominaisuuden hyväksyttävä lisenssi tavallisena tekstinä. Se on tarkoitus kääntää. Se näytetään vakiomuotoisessa valintaikkunassa [Hyväksy]- ja [Hylkää]-vaihtoehtojen kanssa lataus- tai asennusprosessin aikana. Huomaa, että hyväksyttävä lisenssi täytyy määrittää sellaiselle tuoteominaisuudelle, joka valitaan asennettavaksi tai päivitettäväksi Eclipse-päivitystenhallinnan avulla. Sisäkkäisiä tuoteominaisuuksia käytettäessä vain asennettavaksi tai päivitettäväksi valitulla päätason tuoteominaisuudella täytyy olla hyväksyttävä lisenssiteksti määritettynä. Lisenssiteksti tarvitaan, vaikka valinnainen url-määrite olisikin määritetty.
- url - valinnainen URL-osoite koko kuvaukseen HTML-muodossa. URL-osoite voidaan määrittää
tarkkana tai suhteellisena. Jos osoite määritetään suhteellisena, sen oletetaan olevan määritetty suhteessa tuoteominaisuusarkistoon (ja paketoitu siihen). Huomaa, että URL-arvo on erotettava kansallisten kielten käsittelyssä, jotta
kullekin kielelle voidaan määrittää vaihtoehtoiset URL-osoitteet. Huomaa, että tämän URL-osoitteen "sisältö" ei ole sama kuin se, mikä esitetään hyväksyttävänä lisenssinä asennuksen aikana. Hyväksyttävä lisenssi on <license>-elementin (esimerkiksi <license>hyväksyttävä teksti</license>) todellinen arvo.
- <url> - valinnainen URL-osoite, joka määrittää tuoteominaisuuden päivityksiä tai uusia tuoteominaisuuksia sisältävät sivustot
- <update> - URL-osoite, josta voi hakea tuoteominaisuuden päivityksiä
- url - todellinen URL-osoite
- label - sen sivuston näytettävä nimiö (nimi), johon viitataan
- <discovery> - URL-osoite, josta voi hakea uusia tuoteominaisuuksia. Yleensä toimittaja voi tämän elementin avulla viitata omiin sivustoihinsa tai täydentäviä tuoteominaisuuksia tarjoavien kumppaneiden sivustoihin. Eclipse käyttää tätä elementtiä vain uusien sivustojen URL-osoitteiden jakamiseen asiakkaille. Päätuoteominaisuuksiin kuuluvat sivustot (hierarkian yläosassa) näkyvät tavallisesti päivitystenhallinnan Muita sivustoja -välilehdessä.
- url - todellinen URL-osoite
- label - sen sivuston näytettävä nimiö (nimi), johon viitataan
- type (uusi versiossa 2.1) - oletusarvoisesti etsintäsivustojen oletetaan olevan päivityssivustoja (update). Jos tämän määritteen arvoksi asetetaan web, se osoittaa Eclipse-ympäristölle, että URL-osoitetta tulee käsitellä tavallisena Web-hyperlinkkinä, joka voidaan suoraan näyttää sopivassa selaimessa.
- <includes> - valinnainen viittaus tämän tuoteominaisuuden osana pidettävään sisäkkäiseen tuoteominaisuuteen. Sisäkkäisten tuoteominaisuuksien täytyy olla samassa päivityssivustossa kuin tämän tuoteominaisuuden.
- id - pakollinen sisäkkäisen tuoteominaisuuden tunnus. Jos tuoteominaisuus on ohjelmakorjaus (katso alla olevaa <requires>-osaa), tunnuksen täytyy olla toisen ohjelmakorjauksen tunnus.
- version - pakollinen sisäkkäisen tuoteominaisuuden versio
- optional - tuoteominaisuus voidaan sisällyttää valinnaisena, kun tämän määritteen arvo on true. Käyttäjien sallitaan olemaan asentamatta valinnaisia tuoteominaisuuksia, poistaa käytöstä asennettuja tuoteominaisuuksia ja asentaa niitä myöhemmin. Puuttuvaa valinnaista tuoteominaisuutta ei pidetä virheenä.
- name - jos valinnainen tuoteominaisuus puuttuu, Eclipse ei voi esittää sen nimeä oikein. Tätä määritettä voidaan käyttää paikanvaraajana, jotta Eclipse voisi esittää valinnaisen tuoteominaisuuden nimen, kun sitä ei ole asennettu.
- search-location - sisällytetty tuoteominaisuus voidaan päivittää ohjelmakorjauksilla.
Oletusarvoisesti hakupaikkana on root, mikä tarkoittaa, että päätuoteominaisuuden url-elementtiin kuuluvassa update-elementissä määritetty URL-osoite otetaan huomioon. Jos sisällytetylle tuoteominaisuudelle on määritetty oma update-elementtinsä, se jätetään oletusarvoisesti huomioon ottamatta.
Jos halutaan, että päätuoteominaisuus sallii alituoteominaisuuden päivityksen omasta paikastaan, tämän määritteen arvoksi voidaan asettaa both tai self.
- os - valinnainen käyttöjärjestelmän määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä käyttöjärjestelmän nimistä (ks. luokan
org.eclipse.core.runtime.Platform Javadoc.
Osoittaa, että merkintä tulee asentaa vain johonkin määritetyistä käyttöjärjestelmistä. Jos tämän määritteen arvo jätetään määrittämättä, merkintä voidaan asentaa kaikkiin järjestelmiin (siirrettävissä oleva toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa merkinnän asennuksen tästä asetuksesta huolimatta).
- arch - valinnainen koneen arkkitehtuurin määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä arkkitehtuurin nimistä (ks. luokan
org.eclipse.core.runtime.Platform) Javadoc.
Se osoittaa, että tämä tuoteominaisuus asennetaan vain
määritettyyn järjestelmään. Jos tämän määritteen arvoa
ei ole määritetty, tuoteominaisuus voidaan asentaa kaikkiin järjestelmiin (kannettava
toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa tuoteominaisuuden asennuksen tästä asetuksesta huolimatta).
- ws - valinnainen ikkunointijärjestelmän määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä ikkunointijärjestelmän nimistä (ks. luokan
org.eclipse.core.runtime.Platform) Javadoc.
Osoittaa, että merkintä tulee asentaa vain johonkin määritetyistä ikkunointijärjestelmistä.
Jos tämän määritteen arvo jätetään määrittämättä, merkintä voidaan asentaa kaikkiin järjestelmiin (siirrettävissä oleva toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa merkinnän asennuksen tästä asetuksesta huolimatta).
- nl - valinnainen paikallistunnuksen määritys. Tämä on pilkuin erotettu luettelo Javan määrittämistä paikallistunnuksen nimistä. Osoittaa, että merkintä tulee asentaa vain järjestelmään, jossa on yhteensopiva paikallistunnus (Javan paikallistunnusten vastaavuussääntöjen mukaan). Jos tämän määritteen arvo jätetään
määrittämättä, merkintä voidaan asentaa kaikkiin järjestelmiin (kielellisesti neutraali toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa merkinnän asennuksen tästä asetuksesta huolimatta).
- <requires> - valinnaiset tuoteominaisuuden riippuvuustiedot. Ilmaistaan lisäosien riippuvuussuhteina. Jos nämä tiedot määritetään, asennuksen ja päivityksen tuki ottaa ne käyttöön asennuksen aikana.
- <import> - riippuvuussuhdemerkintä. Sen määritys ja käsittely perustuu plugin.xml-tiedostossa olevan <import>-määrityksen alijoukkoon.
- plugin - alisteisen lisäosan tunnus, jos lisäosaa käytetään ilmaisemaan riippuvuussuhdetta
- feature (uusi versiossa 2.1) - alisteisen tuoteominaisuuden tunnus, jos tuoteominaisuutta käytetään ilmaisemaan riippuvuussuhdetta. Joko plugin- tai feature-määrite täytyy määrittää, muttei molempia. Jos patch-määritteen arvo on true, feature-määritettä täytyy käyttää.
- version - valinnainen lisäosan version määritys. Jos patch-määritteen arvo on true, versio täytyy määrittää.
- match - valinnainen vastaavuussääntö. Kelvolliset arvot ja käsittelytapa on määritetty seuraavassa:
- Jos version-määritteen arvo jätetään määrittämättä, match-määrite (jos sen arvo on määritetty) ohitetaan.
- perfect - alisteisen lisäosan version täytyy vastata täsmälleen määritettyä versiota. Jos patch-määritteen arvo on true, oletusarvona on perfect eikä muita arvoja voi määrittää.
- equivalent - alisteisen lisäosan version täytyy olla vähintään määritetyn version tasolla tai korkeammalla päivitystasolla (pää- ja alaversioiden tasojen täytyy olla samoja kuin määritetyn version tason).
- compatible - alisteisen lisäosan version täytyy olla vähintään määritetyn version tasolla, korkeammalla päivitystasolla tai alatasolla (pääversion tason täytyy olla sama kuin määritetyn version tason).
- greaterOrEqual - alisteisen lisäosan version täytyy olla vähintään määritetyn version tasolla, korkeammalla päivitystasolla tai ala- tai päätasolla.
- patch - jos arvo on true, tämä rajoite esittelee sisällytystuoteominaisuuden sen tuoteominaisuuden ohjelmakorjauksena, johon viitataan. Kun tämän määritteen arvo määritetään, on noudatettava tiettyjä sääntöjä:
- Korjattavan tuoteominaisuuden tunnus on määritettävä feature-määritteen avulla.
- Version-määritteen arvo on määritettävä.
- Match-määritteen arvoa ei tule määrittää, ja oletuksena on arvo perfect.
- Jos muita tuoteominaisuuksia otetaan mukaan (<include>), myös niiden täytyy olla ohjelmakorjauksia.
Ohjelmakorjaus on erityinen tuoteominaisuus, joka sisältää uudempia versioita korjattavan tuoteominaisuuden lisäosista. Se ei korvaa tuoteominaisuutta. Ohjelmakorjaus voi sisältää myös muita ohjelmakorjauksia.
- <plugin> - yksilöi lisäosan, johon viitataan
- id - pakollinen lisäosan tunnus (tiedostosta plugin.xml)
- version - pakollinen lisäosan versio (tiedostosta plugin.xml)
- fragment - valinnainen määritys, joka osoittaa, onko merkintä lisäosan fragmentti. Oletusarvo on false.
- os - valinnainen käyttöjärjestelmän määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä käyttöjärjestelmän nimistä (ks. luokan
org.eclipse.core.runtime.Platform Javadoc.
Osoittaa, että merkintä tulee asentaa vain johonkin määritetyistä käyttöjärjestelmistä. Jos tämän määritteen arvo jätetään määrittämättä, merkintä voidaan asentaa kaikkiin järjestelmiin (siirrettävissä oleva toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa merkinnän asennuksen tästä asetuksesta huolimatta).
- arch - valinnainen koneen arkkitehtuurin määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä arkkitehtuurin nimistä (ks. luokan
org.eclipse.core.runtime.Platform) Javadoc.
Se osoittaa, että tämä tuoteominaisuus asennetaan vain
määritettyyn järjestelmään. Jos tämän määritteen arvoa
ei ole määritetty, tuoteominaisuus voidaan asentaa kaikkiin järjestelmiin (kannettava
toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa tuoteominaisuuden asennuksen tästä asetuksesta huolimatta).
- ws - valinnainen ikkunointijärjestelmän määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä ikkunointijärjestelmän nimistä (ks. luokan
org.eclipse.core.runtime.Platform) Javadoc.
Osoittaa, että merkintä tulee asentaa vain johonkin määritetyistä ikkunointijärjestelmistä.
Jos tämän määritteen arvo jätetään määrittämättä, merkintä voidaan asentaa kaikkiin järjestelmiin (siirrettävissä oleva toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa merkinnän asennuksen tästä asetuksesta huolimatta).
- nl - valinnainen paikallistunnuksen määritys. Tämä on pilkuin erotettu luettelo Javan määrittämistä paikallistunnuksen nimistä. Osoittaa, että merkintä tulee asentaa vain järjestelmään, jossa on yhteensopiva paikallistunnus (Javan paikallistunnusten vastaavuussääntöjen mukaan). Jos tämän määritteen arvo jätetään
määrittämättä, merkintä voidaan asentaa kaikkiin järjestelmiin (kielellisesti neutraali toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa merkinnän asennuksen tästä asetuksesta huolimatta).
- download-size - tuoteominaisuuden pakkausohjelman toimittama valinnainen vihje, joka osoittaa kilotavuina sen lisäosa-arkiston latauskoon, johon viitataan. Jos latauskokoa ei määritetä, sitä ei tunneta. (Toteutusta koskeva huomautus: Toteutuksen täytyy pystyä erottamaan tuntematon- ja 0-koot.)
- install-size - tuoteominaisuuden pakkausohjelman toimittama valinnainen vihje, joka osoittaa kilotavuina sen lisäosa-arkiston asennuskoon, johon viitataan. Jos asennuskokoa ei määritetä, sitä ei tunneta. (Toteutusta koskeva huomautus: Toteutuksen täytyy pystyä erottamaan tuntematon- ja 0-koot.)
- unpack (uusi versiossa 3.0) - tuoteominaisuuden pakkausohjelman toimittama valinnainen määritys, joka osoittaa, että lisäosaa voidaan ajaa jar-tiedostosta ja ettei lisäosan jar-tiedoston sisältöä pidä purkaa hakemistoon. Oletusarvo on true.
(Toteutusta koskeva huomautus: Osittaisille lisäosille, jotka toimitetaan sellaisessa tuoteominaisuudessa, jolle on määritetty org.eclipse.update.core.DeltaInstallHandler asennuksen käsittelytoiminnoksi, ei pidä määrittää unpack-määritteen arvoa false.)
- <data> - yksilöi muut kuin lisäosan tiedot, jotka ovat osa tuoteominaisuutta.
- id - pakollinen datatunnus suhteellisen polun muodossa.
- os - valinnainen käyttöjärjestelmän määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä käyttöjärjestelmän nimistä (ks. luokan
org.eclipse.core.runtime.Platform Javadoc.
Osoittaa, että merkintä tulee asentaa vain johonkin määritetyistä käyttöjärjestelmistä.
Jos tämän määritteen arvo jätetään määrittämättä, merkintä voidaan asentaa kaikkiin järjestelmiin (siirrettävissä oleva toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa merkinnän asennuksen tästä asetuksesta huolimatta).
- arch - valinnainen koneen arkkitehtuurin määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä arkkitehtuurin nimistä (ks. luokan
org.eclipse.core.runtime.Platform) Javadoc.
Se osoittaa, että tämä tuoteominaisuus asennetaan vain
määritettyyn järjestelmään. Jos tämän määritteen arvoa
ei ole määritetty, tuoteominaisuus voidaan asentaa kaikkiin järjestelmiin (kannettava
toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa tuoteominaisuuden asennuksen tästä asetuksesta huolimatta).
- ws - valinnainen ikkunointijärjestelmän määritys. Tämä on pilkuin erotettu luettelo
Eclipse-ympäristön määrittämistä ikkunointijärjestelmän nimistä (ks. luokan
org.eclipse.core.runtime.Platform) Javadoc.
Osoittaa, että merkintä tulee asentaa vain johonkin määritetyistä ikkunointijärjestelmistä. Jos tämän määritteen arvo jätetään määrittämättä, merkintä voidaan asentaa kaikkiin järjestelmiin (siirrettävissä oleva toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa merkinnän asennuksen tästä asetuksesta huolimatta).
- nl - valinnainen paikallistunnuksen määritys. Tämä on pilkuin erotettu luettelo Javan määrittämistä paikallistunnuksen nimistä. Osoittaa, että merkintä tulee asentaa vain järjestelmään, jossa on yhteensopiva paikallistunnus (Javan paikallistunnusten vastaavuussääntöjen mukaan). Jos tämän määritteen arvo jätetään
määrittämättä, merkintä voidaan asentaa kaikkiin järjestelmiin (kielellisesti neutraali toteutus). Tätä tietoa käytetään vihjeenä asennuksen ja
päivityksen tuessa (käyttäjä voi pakottaa merkinnän asennuksen tästä asetuksesta huolimatta).
- download-size - tuoteominaisuuden pakkausohjelman toimittama valinnainen vihje, joka osoittaa kilotavuina sen data-arkiston latauskoon, johon viitataan. Jos latauskokoa ei määritetä, sitä ei tunneta. (Toteutusta koskeva huomautus: Toteutuksen täytyy pystyä erottamaan tuntematon- ja 0-koot.)
- install-size - tuoteominaisuuden pakkausohjelman toimittama valinnainen vihje, joka osoittaa kilotavuina sen data-arkiston asennuskoon, johon viitataan. Jos asennuskokoa ei määritetä, sitä ei tunneta. (Toteutusta koskeva huomautus: Toteutuksen täytyy pystyä erottamaan tuntematon- ja 0-koot.)
Kun tuoteominaisuuden toteutus on vuorovaikutuksessa päivityssivuston kanssa, se yhdistää <plugin>- ja <data>-elementit sivuston käyttämiin polun tunnuksiin ja määrittää siten ladattavat ja asennettavat tiedostot. Eclipse-ympäristön toimittama tuoteominaisuuden oletustoteutus muodostaa polun tunnukset seuraavasti:
-
<plugin>-elementin tuloksena syntyy polkumerkintä, jonka muoto on plugins/<lisäosan tunnus>_<lisäosan versio>.jar
(esimerkiksi plugins/org.eclipse.core.boot_2.0.0.jar)
-
<data>-elementin tuloksena syntyy polkumerkintä, jonka muoto on features/<tuoteominaisuuden tunnus>_<tuoteominaisuuden versio>/<datatunnus>
(esimerkiksi features/com.xyz.tools_1.0.3/examples.zip)
Huomaa, että feature.xml-manifest-asiakirjoissa on yleensä määritettävä
UTF-8-koodaus.
Esimerkiksi:
<?xml version="1.0" encoding="UTF-8"?>
Käännettävä teksti feature.xml-tiedostossa voidaan erottaa feature<_locale>.properties-tiedostoiksi,
joissa käytetään Javan ominaisuustiedostoryhmäkäytäntöjä.
Huomaa, että käännettyjä
merkkijonoja käytetään asennuksen aikana (älä siis käytä lisäosafragmentin
ajonaikaista mekanismia).