Eclipse platform szolgáltatásleírás
Verzió: 3.0 - Utolsó
felülvizsgálat: 2004. június 22.
A szolgáltatásleírás formátumát a következő dtd határozza meg:
<?xml encoding="ISO-8859-2"?>
<!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
>
Az elemek és attribútumok meghatározása a következő:
- <feature> - meghatározza a szolgáltatást
- id - kötelező szolgáltatásazonosító (pl.: com.xyz.myfeature)
- version - kötelező összetevő-verzió (pl.: 1.0.3)
- label - nem kötelező megjeleníthető címke (név). Lefordítandó.
- provider-name - nem kötelező képernyőcímke az összetevőt biztosító szervezet azonosítására. Lefordítandó.
- image - nem kötelező kép; a szolgáltatásról szóló információk megjelenítésekor
használható. A feature.xml fájlra vonatkozik.
- os - nem kötelező operációsrendszer-meghatározás. Az operációsrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a szolgáltatás csak a megadott operációs rendszerek
egyikén telepíthető. Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- arch - nem kötelező gép architektúra specifikáció. Az architektúra-kijelölők vesszővel elválasztott listája az Eclipse által
meghatározva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a szolgáltatás csak a megadott rendszerek valamelyikén
telepíthető. Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- ws - nem kötelező ablakkezelőrendszer-meghatározás. Az ablakrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a szolgáltatás csak a megadott ablakkezelő rendszerek
egyikén telepíthető. Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- nl - nem kötelező területi beállítás meghatározás. A területi beállítás kijelölők vesszővel elválasztott, Java által
meghatározott listája. Azt jelzi, hogy ez a szolgáltatás csak egy kompatibilis területi beállítással
futó rendszeren telepíthető (a Java területibeállítás-egyeztetési
szabályainak használatával). Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(nyelvsemleges implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- colocation-affinity - nem kötelező hivatkozás más szolgáltatásazonosítóra, a
jelen szolgáltatás alapértelmezett telepítési helyének kiválasztására. Amikor a szolgáltatás új szolgáltatásként kerül telepítésre (nincs másik
verziója telepítve), a rendszer megkísérli a szolgáltatást ugyanarra a
helyre telepíteni, mint a hivatkozott szolgáltatást.
- primary - nem kötelező jelzés annak megadására, hogy ez a szolgáltatás
elsődleges szolgáltatásként kerül-e használatra. Az alapértelmezés a false érték (nem elsődleges szolgáltatás).
- application - az Eclipse alkalmazás nem kötelező azonosítója; az indítás
során használatos, amikor a deklarálás szolgáltatás az elsődleges szolgáltatás. Az alkalmazás azonosítójának egy érvényes, az
org.eclipse.core.runtime.applications kiterjesztési ponton
regisztrált érvényes alkalmazást kell képviselnie. Az alapértelmezés az org.eclipse.ui.ide.workbench.
- plugin - nem kötelező azonosító, amely a bedolgozó a szolgáltatásban
felsorolt azonosítóját jelenti; a szolgáltatás arculati információit hordozza
(képek, fordítások, elsődleges szolgáltatás esetén nyitóképernyők stb.). Ha nincs megadva, a feltevés az lesz, hogy az azonosító megegyezik a
szolgáltatáséval.
- exclusive - nem kötelező jelző; ha az értéke "true", akkor azt
jelzi, hogy a szolgáltatás nem telepíthető egy csoportban más szolgáltatásokkal.
- <install-handler>
- library - nem kötelező .jar könyvtár, amely a telepítéskezelő osztályokat
tartalmazza.
Ha meg van adva, a hivatkozott .jar állománynak szerepelnie kell a
szolgáltatás archívumában.
Elérési útvonalként van megadva a szolgáltatás archívumán belül, a
feature.xml bejegyzéshez képest. Ha nincs megadva, maga a szolgáltatás archívuma kerül felhasználásra a
telepítéskezelő osztályok betöltésére. Ez az attribútum csak akkor kerül értelmezésre, ha a class
attribútum is meg van adva.
- handler - a telepítéskezelő nem kötelező azonosítója. Az érték a library attribútum értékétől függően kerül értelmezésre. Ha a library meg van adva, az érték a megadott
könyvtárban található osztály teljes képzésű neveként kerül
értelmezésre. Ha a library nincs megadva, az érték egy, az
org.eclipse.update.installHandlers kiterjesztési ponton bejegyzett
kiterjesztési azonosítójaként kerül értelmezésre. Az eredményül kapott osztálynak mindkét esetben implementálnia kell az
IInstallHandler felületet. Az osztály a szolgáltatás feldolgozása során
dinamikusan betöltésre kerül és meghívódik a megadott pontokon. Amikor a kezelő osztályként van megadva, látható az
org.eclipse.update.core bedolgozó API osztályai számára; amikor viszont
kiterjesztésként van megadva, minden osztályhoz hozzáfér, ahogy a
bedolgozó megadja a kiterjesztést.
- <description> - rövid összetevőleírás egyszerű szövegként. Lefordítandó.
- url - nem kötelező URL-cím a teljes, HTML-formátumú leíráshoz. Abszolút és relatív URL-ként is meg lehet adva. Ha relatív, az elfogadott az, hogy a szolgáltatás archívumára vonatkozzon
és abba legyen csomagolva. Figyeljen rá, hogy az URL érték NL kezelését külön kell választani annak
engedélyezésére, hogy alternatív URL-címek legyenek megadhatók minden
nemzeti nyelvhez.
- <copyright> - a szolgáltatás szerzői jogi információi egyszerű szövegként. Lefordítandó.
- url - nem kötelező URL-cím a teljes, HTML-formátumú leíráshoz. Abszolút és relatív URL-ként is meg lehet adva. Ha relatív, az elfogadott az, hogy a szolgáltatás archívumára vonatkozzon
és abba legyen csomagolva. Figyeljen rá, hogy az URL érték NL kezelését külön kell választani annak
engedélyezésére, hogy alternatív URL-címek legyenek megadhatók minden
nemzeti nyelvhez.
- <license> - a szolgáltatás "átkattintgatós" licence egyszerű szövegként. Lefordítandó. Egy szabványos párbeszédablakban jelenik meg [Elfogadás] és
[Visszautasítás] műveletekkel, a letöltési/telepítési folyamat során. Figyeljen rá, hogy átkattintgatós licencet minden szolgáltatáshoz meg kell
adni, amely kiválasztásra fog kerülni telepítésre vagy frissítésre az
Eclipse frissítéskezelő használatával. A beágyazott szolgáltatások használatakor csak a beágyazó szülőnek (a
telepítéshez vagy frissítéshez kiválasztott szolgáltatásnak) kell meghatározott
átkattintgatós licencszöveggel rendelkeznie. A licencszöveg akkor is kötelező, ha a nem kötelező url attribútum
van megadva.
- url - nem kötelező URL-cím a teljes, HTML-formátumú leíráshoz. Abszolút és relatív URL-ként is meg lehet adva. Ha relatív, az elfogadott az, hogy a szolgáltatás archívumára vonatkozzon
és abba legyen csomagolva. Figyeljen rá, hogy az URL érték NL kezelését külön kell választani annak
engedélyezésére, hogy alternatív URL-címek legyenek megadhatók minden
nemzeti nyelvhez. Figyeljen rá, hogy ennek az URL-címnek a "tartalma" nem az, amely
átkattintgatós licencként megjelent a telepítési folyamat során. Az átkattintgatós licenc az aktuális értéke a <license> elemnek
(pl. <license>átkattintgatós szöveg</license>)
- <url> - nem kötelező URL, amely szolgáltatásfrissítéseket vagy új szolgáltatásokat
tartalmazó webhelye(ke)t határoz meg
- <update> - a szolgáltatás frissítéseinek eléréséhez meglátogatandó URL
- url - aktuális URL
- label - a hivatkozott webhely megjelenítendő címkéje (neve)
- <discovery> - új szolgáltatásokért meglátogatandó URL. Egy szolgáltató általában ezt az elemet használhatja a hivatkozáshoz a
saját webhelyére/webhelyeire, vagy a kiegészítő szolgáltatásokat kínáló
partner webhely(ek)re. Az Eclipse ezt az elemet egyszerűen mint egy módszert használja az új
webhely URL-címek eljuttatására az ügyfelekhez. A gyökér (a hierarchia legfelső szintjén található) szolgáltatásokhoz tartozó
webhelyek általában a "Meglátogatandó webhelyek" között jelennek
meg a Frissítéskezelőben.
- url - aktuális URL
- label - a hivatkozott webhely megjelenítendő címkéje (neve)
- type (új a 2.1 verzióban) - a feltérképezési helyek a feltételezés
szerint frissítési helyek ("update"). Ha az attribútumot
"web" értékre állítjuk, jelezni lehet az Eclipse számára, hogy
az URL-címet szabályos webes hiperhivatkozásként kell feldolgozni, amely
közvetlenül megjeleníthető egy megfelelő böngészőben.
- <includes> - nem kötelező hivatkozás egy beágyazott szolgáltatásra, amelyre
a jelen szolgáltatás részeként kell gondolni. A beágyazott szolgáltatásoknak a jelen szolgáltatással azonos frissítési helyen kell
lenniük.
- id - kötelező beágyazott szolgáltatásazonosító. Ha a szolgáltatás egy javítás (lásd alább a <requires> szakaszt), akkor
ennek egy másik javítás azonosítójának kell lennie.
- version - kötelező beágyazott szolgáltatás verziószám
- optional - amikor ezen attribútum értéke "true", akkor a
szolgáltatás választhatóként is megadható. A felhasználók számára lehetőség van a
választható szolgáltatások telepítésének mellőzésére, elhalasztására, vagy a
telepítettek letiltására. Egy hiányzó választható szolgáltatást a rendszer nem kezel hibaként.
- name - ha egy választható szolgáltatás hiányzik, akkor az Eclipse nem tudja a
nevét megfelelően feldolgozni. Ez az attribútum helykitöltőként használható; lehetőséget ad az Eclipse
számára a nem telepített választható szolgáltatások nevének lefordítására.
- search-location - egy tartalmazott szolgáltatást a javítások képesek
frissíteni.
Alapértelmezésben a keresési hely a "root", ami azt jelenti,
hogy a szülő "url" elemén belül található "update"
elemben megadott URL kerül figyelembevételre. Ha egy tartalmazott szolgáltatásnak saját megadott "update" eleme
van, ez alapértelmezésben nem kerül figyelembe vételre.
Ha a szülő szolgáltatás engedélyezni szeretné, hogy a leszármazott saját
helyéről kerüljön frissítésre, ezt az attribútumot "both" vagy
"self" értékre állítja.
- os - nem kötelező operációsrendszer-meghatározás. Az operációsrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a bejegyzés csak a megadott operációs rendszerek
valamelyikén telepíthető. Ha ez az attribútum nincs megadva, a bejegyzés minden rendszeren
telepíthető (hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a bejegyzések telepítését).
- arch - nem kötelező gép architektúra specifikáció. Az architektúra-kijelölők vesszővel elválasztott listája az Eclipse által
meghatározva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a szolgáltatás csak a megadott rendszerek valamelyikén
telepíthető. Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- ws - nem kötelező ablakkezelőrendszer-meghatározás. Az ablakrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a bejegyzés csak a megadott ablakrendszerek
egyikén telepíthető.
Ha ez az attribútum nincs megadva, a bejegyzés minden rendszeren
telepíthető (hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a bejegyzések telepítését).
- nl - nem kötelező területi beállítás meghatározás. A területi beállítás kijelölők vesszővel elválasztott, Java által
meghatározott listája. Azt jelzi, hogy ez a bejegyzés csak egy kompatibilis területi beállítással
futó rendszeren telepíthető (a Java területibeállítás-egyeztetési
szabályainak használatával). Ha ez az attribútum nincs megadva, a bejegyzés minden rendszeren
telepíthető (nyelvsemleges implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a bejegyzések telepítését).
- <requires> - nem kötelező függőségi információk. Bedolgozó-függőségekben van kifejezve. Ha meg van adva, a telepítés és a frissítés támogatása kikényszeríti a
telepítés időpontjában.
- <import> - függőségi bejegyzés. A specifikáció és a feldolgozás az
<import> specifikáció részhalmaza a plugin.xml-ben.
- plugin - függő bedolgozó azonosítója, ha a függőség bedolgozóval van
kifejezve
- feature (új a 2.1 verzióban) - függő szolgáltatás azonosítója, ha a
függőség szolgáltatással van kifejezve. Vagy a bedolgozó, vagy a szolgáltatás attribútumot be kell állítani, de csak
az egyiket. Ha a "patch" értéke "true", a szolgáltatás attribútumot
kell használni.
- version - nem kötelező bedolgozó verziószám meghatározás. Ha a "patch" értéke "true", a verziószámot meg kell
adni.
- match - nem kötelező egyeztetési szabály. Az érvényes értékek és
feldolgozás a következők:
- ha a verzióattribútum nincs megadva, az egyeztetési attribútum (ha van
ilyen megadva) figyelmen kívül lesz hagyva.
- perfect - a függő bedolgozóverziónak pontosan illeszkednie
kell a megadott verzióhoz. Ha a "patch" értéke "true", a feltételezés a
"perfect", és más érték nem állítható be.
- equivalent - a függő bedolgozóverziónak legalább a
megadott verziónak kell lennie, vagy magasabb szolgáltatási szinten kell
lennie (a fő és al-verziószámoknak meg kell egyezniük a megadott
verzióval).
- compatible - a függő bedolgozóverziónak legalább a megadott
verziónak kell lennie, illetve magasabb szolgáltatási szinten vagy alszinten
kell lennie (a fő verziószámnak meg kell egyeznie a megadott verzióval).
- greaterOrEqual - a függő bedolgozó verziószámának legalább a
megadott verziónak kell lennie, illetve magasabb szolgáltatási szinten vagy
kell lennie (fő és alszinten).
- patch - ha az értéke "true", akkor ez a megszorítás azt
határozza meg, hogy a mellékelt szolgáltatásnak a hivatkozott szolgáltatás
javításának kell lennie. Az attribútum beállításakor követni kell bizonyos szabályokat:
- a feature attribútumot kell használni a javítani kívánt szolgáltatás
azonosítására
- meg kell adni a version attribútumot
- a match attribútumot nem kell megadni, a "perfect" érték
lesz a feltételezett.
- ha más szolgáltatások is <elhelyez>ésre kerülnek, azokon is
alkalmazni kell a javítást.
A javítás egy speciális szolgáltatás, amely a javított szolgáltatás bedolgozóinak
újabb verzióját tartalmazza. Nem cseréli le a szolgáltatást. Egy javítás más javításokat is tartalmazhat.
- <plugin> - azonosítja a hivatkozott bedolgozót
- id - kötelező bedolgozó-azonosító (a plugin.xml-ből)
- version - kötelező bedolgozóverzió (a plugin.xml-ből)
- fragment - nem kötelező specifikáció, amely azt jelzi, hogy ez a bejegyzés
egy bedolgozótöredék. Az alapértelmezett érték a "false"
- os - nem kötelező operációsrendszer-meghatározás. Az operációsrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a bejegyzés csak a megadott operációs rendszerek
valamelyikén telepíthető. Ha ez az attribútum nincs megadva, a bejegyzés minden rendszeren
telepíthető (hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a bejegyzések telepítését).
- arch - nem kötelező gép architektúra specifikáció. Az architektúra-kijelölők vesszővel elválasztott listája az Eclipse által
meghatározva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a szolgáltatás csak a megadott rendszerek valamelyikén
telepíthető. Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- ws - nem kötelező ablakkezelőrendszer-meghatározás. Az ablakrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a bejegyzés csak a megadott abalrendszerek
valamelyikén telepíthető.
Ha ez az attribútum nincs megadva, a bejegyzés minden rendszeren
telepíthető (hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a bejegyzések telepítését).
- nl - nem kötelező területi beállítás meghatározás. A területi beállítás kijelölők vesszővel elválasztott, Java által
meghatározott listája. Azt jelzi, hogy ez a bejegyzés csak egy kompatibilis területi beállítással
futó rendszeren telepíthető (a Java területibeállítás-egyeztetési
szabályainak használatával). Ha ez az attribútum nincs megadva, a bejegyzés minden rendszeren
telepíthető (nyelvsemleges implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a bejegyzések telepítését).
- download-size - a szolgáltatáscsomagoló által nyújtott nem kötelező
útbaigazítás, amely a hivatkozott bedolgozó archívumának
letöltési méretét jelzi kilobyte-ban. Ha nincs megadva, akkor a letöltési méret ismeretlen Implementációs
megjegyzés: az implementációnak különbséget kell tennie a "nem ismert"
és a 0 méret között.
- install-size - a szolgáltatáscsomagoló által nyújtott nem kötelező
útbaigazítás, amely a hivatkozott bedolgozó archívumának
telepítési méretét jelzi kilobyte-ban. Ha nincs megadva, akkor a telepítési méret ismeretlen Implementációs
megjegyzés: az implementációnak különbséget kell tennie a "nem ismert"
és a 0 méret között.
- unpack (új a 3.0 verzióban) - a szolgáltatáscsomagoló által nyújtott nem
kötelező specifikáció, amely azt jelzi, hogy a bedolgozó képes egy jar
fájlból futni és a bedolgozó jar tartalmát nem kell kicsomagolni egy
könyvtárba. Az alapértelmezett érték a "true".
(Megvalósítási megjegyzés: a részleges bedolgozókban - amelyek egy
olyan szolgáltatásban kerülnek szállításra, amely az
org.eclipse.update.core.DeltaInstallHandler osztályt adják meg
telepítéskezelőként, nem szabad beállítani "false" értéket a
kicsomagolásra)
- <data> - azonosítja a szolgáltatás részét képező nem bedolgozó adatokat
- id - kötelező adat-azonosító egy relatív elérési útvonal formájában.
- os - nem kötelező operációsrendszer-meghatározás. Az operációsrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a bejegyzés csak a megadott operációs rendszerek
valamelyikén telepíthető.
Ha ez az attribútum nincs megadva, a bejegyzés minden rendszeren
telepíthető (hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a bejegyzések telepítését).
- arch - nem kötelező gép architektúra specifikáció. Az architektúra-kijelölők vesszővel elválasztott listája az Eclipse által
meghatározva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Azt jelzi, hogy ez a szolgáltatás csak a megadott rendszerek valamelyikén
telepíthető. Ha ez az attribútum nincs megadva, a szolgáltatás minden rendszeren telepíthető
(hordozható implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a szolgáltatások telepítését).
- ws - nem kötelező ablakkezelőrendszer-meghatározás. Az ablakrendszer-kijelölők vesszővel elválasztott listája, az Eclipse
által megadva (lásd: Javadoc, org.eclipse.core.runtime.Platform).
Jelzi, hogy a bejegyzés csak a megadott ablakrendszerek egyikén
telepíthető. Ha ez az attribútum nincs megadva, akkor a bejegyzés
mindegyik rendszeren telepíthető (hordozható megvalósítás). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a bejegyzések telepítését).
- nl - nem kötelező területi beállítás meghatározás. A területi beállítás kijelölők vesszővel elválasztott, Java által
meghatározott listája. Azt jelzi, hogy ez a bejegyzés csak egy kompatibilis területi beállítással
futó rendszeren telepíthető (a Java területibeállítás-egyeztetési
szabályainak használatával). Ha ez az attribútum nincs megadva, a bejegyzés minden rendszeren
telepíthető (nyelvsemleges implementáció). Ezt az információt a telepítés és a frissítési támogatás útbaigazításként
használhatja (a felhasználók ettől a beállítástól függetlenül
kikényszeríthetik a bejegyzések telepítését).
- download-size - a szolgáltatáscsomagoló által nyújtott nem kötelező
útbaigazítás, amely a hivatkozott adat archívumának letöltési méretét
jelzi kilobyte-ban. Ha nincs megadva, akkor a letöltési méret ismeretlen Implementációs
megjegyzés: az implementációnak különbséget kell tennie a "nem ismert"
és a 0 méret között.
- install size - a szolgáltatáscsomagoló által nyújtott nem kötelező
útbaigazítás, amely a hivatkozott adat archívumának telepítési méretét
jelzi kilobyte-ban. Ha nincs megadva, akkor a telepítési méret ismeretlen Implementációs
megjegyzés: az implementációnak különbséget kell tennie a "nem ismert"
és a 0 méret között.
Amikor interakcióba lép a frissítési hellyel, a szolgáltatás-implementáció
útvonal-azonosítóvá képezi le a hely által használt <plugin>
és <data> elemeket a ténylegesen letöltendő és telepítendő
fájlok meghatározására. Az Eclipse által biztosított alapértelmezett szolgáltatásimplementáció a
következőképpen építi fel az útvonal-azonosítókat:
-
A <plugin> elem egy útvonal-bejegyzést eredményez a következő
formában: "plugins/<pluginId>_<pluginVersion>.jar" (például
"plugins/org.eclipse.core.boot_2.0.0.jar")
-
A <data> elem egy útvonal-bejegyzést eredményez a következő
formában:
"features/<featureId>_<featureVersion>/<dataId>"
(például "features/com.xyz.tools_1.0.3/examples.zip")
Figyeljen rá, hogy a feature.xml leíró dokumentumoknak általában
UTF-8 kódolást kell megadniuk. Például:
<?xml version="1.0" encoding="UTF-8"?>
A feature.xml-ben található lefordítandó szövegeket a Java
tulajdonságköteg-megállapodások használatával szét kell szedni
feature<_locale>.properties fájlokba.
Ne felejtse el, hogy telepítéskor a lefordított karaktersorozatokat
telepítéskor kell használni (vagyis ne alkalmazza a
futásidejű bedolgozó-töredék mechanizmust).