Funksjonsmanifest for Eclipse-plattformen
Versjon 3.0 - Sist endret 22. juni, 2004
Funksjonsmanifestformatet er definert av følgende DTD:
<?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
>
Dette er definisjonene av elementene og attributtene:
- <feature> - definerer funksjonen
- id - obligatorisk funksjons-ID (for eksempel com.xyz.myfeature)
- version - obligatorisk komponentversjon (for eksempel 1.0.3)
- label - valgfri etikett (navn) som kan vises. Skal
oversettes.
- provider-name - valgfri visningsetikett som identifiserer organisasjonen komponenten leveres av. Skal
oversettes.
- image - valgfritt bilde som skal brukes når det vises informasjon om funksjonen. Spesifisert i forhold til feature.xml.
- os - valgfri operativsystemspesifikasjon. En liste over operativsystemer definert av Eclipse (se
org.eclipse.core.runtime.Platform) i Javadoc. Listen bruker komma som skilletegn.
Viser at denne funksjonen bare skal installeres på et av de oppgitte OS-systemene. Hvis dette attributtet ikke er oppgitt, kan funksjonen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av funksjonen uavhengig av denne
innstillingen).
- arch - valgfri spesifikasjon av maskinarkitekturen. En liste over arkitekturer definert av Eclipse (se
org.eclipse.core.runtime.Platform i Javadoc). Listen bruker komma som skilletegn.
Viser at denne funksjonen bare skal installeres på et av de oppgitte systemene. Hvis dette attributtet ikke er oppgitt, kan funksjonen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av funksjonen uavhengig av denne
innstillingen).
- ws - valgfri vindussystemspesifikasjon. En liste over vindussystemer definert av Eclipse (se
org.eclipse.core.runtime.Platform i Javadoc). Listen bruker komma som skilletegn.
Viser at denne funksjonen bare skal installeres på et av de oppgitte vindussystemene. Hvis dette attributtet ikke er oppgitt, kan funksjonen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av funksjonen uavhengig av denne
innstillingen).
- nl - valgfri språkmiljøspesifikasjon. En liste over språkmiljøer definert av Java. Listen bruker komma som
skilletegn. Viser at denne funksjonen bare skal installeres på et system som kjøres med et kompatibelt språkmiljø
(ved hjelp av Javas regler for samsvarende språkmiljø). Hvis dette attributtet ikke er oppgitt, kan funksjonen
installeres på alle systemer (språknøytral implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av funksjonen uavhengig av denne
innstillingen).
- colocation-affinity - valgfri referanse til en annen funksjons-ID som brukes til å velge
standard installeringssted for denne funksjonen. Når denne funksjonen blir installert som en ny funksjon (ingen andre
versjoner av den er installert), blir det gjort et forsøk på å installere denne funksjonen på samme
installeringssted som funksjonen det refereres til.
- primary - valgfri indikator som oppgir om denne funksjonen kan brukes som en primær funksjon. Standardverdien
er false (ikke en primær funksjon).
- application - valgfri indikator i Eclipse-applikasjonen som skal brukes under oppstart når
deklareringsfunksjonen er den primære funksjonen. Applikasjons-IDen må representere en gyldig applikasjon som er
registrert i utvidelsespunktet org.eclipse.core.runtime.applications. Standardverdien er org.eclipse.ui.ide.workbench.
- plugin - valgfri ID som representerer IDen til plugin-modulen oppført i funksjonen som blir brukt til å
oppbevare merkevareinformasjon for funksjonen (bilder, oversettelser, oppstartsbilder ved primær funksjon osv.). Hvis
den ikke er oppgitt, antas det at plugin-modulen har samme ID som funksjonen.
- exclusive - valfritt flagg som, hvis "true", viser at funksjonen ikke kan installeres i en
gruppe med andre funksjoner.
- <install-handler>
- library - valgfritt .jar-bibliotek som inneholder installeringsbehandlerklasser.
Hvis oppgitt, må .jar-filen det refereres til, ligge i funksjonsarkivet.
Det er oppgitt som en bane i funksjonsarkivet, i forhold til oppføringen feature.xml. Hvis dette ikke er
oppgitt, blir selve funksjonsarkivet brukt til å laste inn installeringsbehandlerklassene. Dette attributtet blir bare
tolket hvis class-attributtet også er oppgitt.
- handler - valgfri ID for installeringsbehandler. Verdien blir tolket avhengig av verdien til
library-attributtet. Hvis library er oppgitt, blir verdien tolket som et fullt kvalifisert navn
på en klasse som ligger i et oppgitt library. Hvis library ikke er oppgitt, blir verdien tolket som en
utvidelses-ID for en utvidelse registrert i utvidelsespunktet org.eclipse.update.installHandlers. I begge
tilfeller må den resulterende klassen implementere IInstallHandler-grensesnittet. Klassen blir dynamisk
lastet inn og kalt ved bestemte punkter under funksjonsbehandling. Når behandleren er oppgitt som en klasse, har
den synlighet for API-klassene fra plugin-modulen org.eclipse.update.core og plugin-modulene for Eclipse som
kreves av denne plugin-modulen. Hvis den er oppgitt som en utvidelse, har den tilgang til alle klassene i
egenskap av plugin-modulen som definerer utvidelsen.
- <description> - kort komponentbeskrivelse i form av ren tekst. Skal oversettes.
- url - valgfri URL for den fullstendige beskrivelsen i form av HTML. URLen kan oppgis som absolutt eller
relativ. Hvis
den er relativ, antas den å være relativ til (og pakket i) funksjonsarkivet. Legg merket til at ved NL-behandling skal
URL-verdien holdes atskilt, slik at alternative URLer kan oppgis for hvert språk.
- <copyright> - opphavsrett for funksjonen i form av ren tekst. Skal oversettes.
- url - valgfri URL for den fullstendige beskrivelsen i form av HTML. URLen kan oppgis som absolutt eller
relativ. Hvis
den er relativ, antas den å være relativ til (og pakket i) funksjonsarkivet. Legg merket til at ved NL-behandling skal
URL-verdien holdes atskilt, slik at alternative URLer kan oppgis for hvert språk.
- <license> - funksjonens "klikk-deg-gjennom"-lisens i form av ren tekst. Skal oversettes. Den blir vist i en standard dialogboks med handlingene [Godta] [Avvis] under nedlasting/installering. Legg
merke til at klikk-deg-gjennom-lisensen må oppgis for alle funksjoner som skal installeres eller oppdateres ved
hjelp av Eclipse-oppdateringsstyreren. Når du bruker nestede funksjoner, er det bare den nestende overordnede
(det vil si funksjonen som er valgt for installering eller oppdatering) som må ha definert en
klikk-deg-gjennom-lisenstekst. Lisensteksten kreves selv om det valgfrie url-attributtet er oppgitt.
- url - valgfri URL for den fullstendige beskrivelsen i form av HTML. URLen kan oppgis som absolutt eller
relativ. Hvis
den er relativ, antas den å være relativ til (og pakket i) funksjonsarkivet. Legg merket til at ved NL-behandling
skal URL-verdien holdes atskilt, slik at alternative URLer kan oppgis for hvert språk. Legg også merke til at
"innholdet" i denne URLen ikke er det som blir presentert i klikk-deg-gjennom-lisensen under
installeringen. Klikk-deg-gjennom-lisensen er den faktiske verdien for <license>-elementet (for
eksempel <license>click through text</license>)
- <url> - valgfri URL som oppgir nettsted(er) som inneholder funksjonsoppdateringer, eller nye funksjoner
- <update> - URL med oppdateringer til denne funksjonen
- url - faktisk URL
- label - etikett (navn) som kan vises for nettstedet det refereres til
- <discovery> - URL med nye funksjoner. Generelt kan en leverandør bruke dette elementet til å referere til
sine egne nettsteder, eller til nettsteder til partnere som tilbyr tilhørende funksjoner. Eclipse bruker dette
elementet ganske enkelt som en måte å distribuere nye URLer til klientene på. Nettsteder som hører til
rotfunksjoner (øverst i hierarkiet), blir som regel vist i "Steder som skal besøkes" i
oppdateringsstyreren.
- url - faktisk URL
- label - etikett (navn) som kan vises for nettstedet det refereres til
- type (ny i 2.1) - som standard blir det antatt at oppdagingssteder er oppdateringssteder ("update"). Ved
å sette verdien for dette attributtet til "web", er det mulig å vise Eclipse at URLen skal behandles som
en vanlig web-hyperlink som kan vises direkte i en passende nettleser.
- <includes> - valgfri referanse til en nestet funksjon som ses på som del av denne funksjonen. Nestede
funksjoner må ligge på samme oppdateringssted som denne funksjonen.
- id - obligatorisk nestet funksjons-ID. Hvis funksjonen er en rettelse (se <requires>-delen nedenfor), må
dette være IDen for en annen rettelse.
- version - obligatorisk nestet funksjonsversjon
- optional - det er mulig å inkludere en funksjon som valgfri når dette attributtet er "true". Brukere
kan velge å ikke installere valgfrie funksjoner, deaktivere dem hvis de ble installert, og installere dem
senere. Hvis en valgfri funksjon mangler, blir det ikke sett på som en feil.
- name - hvis en valgfri funksjon mangler, kan ikke Eclipse gjengi funksjonsnavnet på riktig måte. Dette
attributtet kan brukes som en 'plassholder' slik at Eclipse kan gjengi navnet på den valgfrie funksjonen selv om
den ikke er installert.
- search-location - en inkludert funksjon kan oppdateres av rettelser. Som standard blir det søkt i "root", noe som betyr at URLen som er oppgitt i elementet "update"
i "url"-elementet til den overordnede, blir vurdert. Hvis en inkludert funksjon har definert et eget
"update"-element, blir det som standard ignorert.
Hvis den overordede funksjonen vil tillate at den
underordnede oppdateres fra sitt eget sted, kan den sette dette attributtet til "both" eller "self".
- os - valgfri operativsystemspesifikasjon. En liste over operativsystemer definert av Eclipse (se
org.eclipse.core.runtime.Platform) i Javadoc. Listen bruker komma som skilletegn.
Viser at denne oppføringen bare skal installeres på et av de oppgitte OS-systemene. Hvis dette attributtet
ikke er oppgitt, kan oppføringen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av oppføringen uavhengig av denne
innstillingen).
- arch - valgfri spesifikasjon av maskinarkitekturen. En liste over arkitekturer definert av Eclipse (se
org.eclipse.core.runtime.Platform i Javadoc). Listen bruker komma som skilletegn.
Viser at denne funksjonen bare skal installeres på et av de oppgitte systemene. Hvis dette attributtet ikke er oppgitt, kan funksjonen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av funksjonen uavhengig av denne
innstillingen).
- ws - valgfri vindussystemspesifikasjon. En liste over vindussystemer definert av Eclipse (se
org.eclipse.core.runtime.Platform i Javadoc). Listen bruker komma som skilletegn.
Viser at denne oppføringen bare skal installeres på et av de oppgitte vindussystemene.
Hvis dette attributtet
ikke er oppgitt, kan oppføringen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av oppføringen uavhengig av denne
innstillingen).
- nl - valgfri språkmiljøspesifikasjon. En liste over språkmiljøer definert av Java. Listen bruker komma som
skilletegn. Viser at denne oppføringen bare skal installeres på et system som kjøres med et kompatibelt språkmiljø
(ved hjelp av Javas regler for samsvarende språkmiljø). Hvis dette attributtet ikke er oppgitt, kan oppføringen
installeres på alle systemer (språknøytral implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av oppføringen uavhengig av denne
innstillingen).
- <requires> - valgfri informasjon om funksjonsavhengigheter. Denne er uttrykt i form av avhengige
plugin-moduler. Hvis den er oppgitt, blir den tvunget gjennom av installerings- og oppdateringsstøtten under
installering
- <import> - avhengighetsoppføring. Spesifisering og behandling er et delsett av
<import>-spesifikasjonen i plugin.xml.
- plugin - ID for avhengig plugin-modul, hvis en plugin-modul er brukt for å uttrykke avhengighet
- feature (ny i 2.1) - ID for avhengig funksjon, hvis en funksjon er brukt for å uttrykke avhengighet. Det
må defineres enten et plugin- eller funksjonsattributt, men ikke begge. Hvis "patch" er
"true", må det brukes et funksjonsattributt.
- version - valgfri plugin-versjonsspesifikasjon. Hvis "patch" er "true", må
versjonen oppgis.
- match - valgfri samsvarsregel. Dette er gyldige verdier og behandling:
- hvis versjonsattributtet ikke er oppgitt, blir samsvarsattributtet (hvis oppgitt) ignorert.
- perfect - avhengig plugin-versjon må samsvare nøyaktig med den oppgitte versjonen. Hvis
"patch" er "true", antas "perfect", og andre verdier kan ikke defineres.
- equivalent - avhengig plugin-versjon må minst ha den oppgitte versjonen, eller et høyere
tjenestenivå (nivået på hovedversjonen og underversjonen må tilsvare den oppgitte versjonen).
- compatible - avhengig plugin-versjon må minst ha den oppgitte
versjonen, eller et høyere tjenestenivå eller undernivå (nivået på hovedversjonen må
tilsvare den oppgitte versjonen).
- greaterOrEqual - avhengig plugin-versjon må minst ha den oppgitte versjonen, eller et
høyere tjeneste-, hoved- eller undernivå.
- patch - hvis "true", deklarerer denne begrensningen at den innkapslende funksjonen skal være en
rettelse for funksjonen det refereres til. Det er bestemte regler som må følges når dette attributtet
defineres:
- funksjonsattributtet må brukes for å identifisere funksjonen som skal rettes
- versjonsattributtet må defineres
- samsvarsattributtet skal ikke defineres, og "perfect"-verdien antas
- hvis <include> er oppgitt for andre funksjoner, må de også rettes
En rettelse er en spesialfunksjon som har nyere versjoner av plugin-moduler for funksjonen den retter. Den
erstatter ikke funksjonen. En rettelse kan også inkludere andre rettelser.
- <plugin> - identifiserer plugin-moduler det refereres til
- id - obligatorisk plugin-ID (from plugin.xml)
- version - obligatorisk plugin-versjon (fra plugin.xml)
- fragment - valgfri spesifikasjon som viser at denne oppføringen er et plugin-fragment. Standardverdien
er "false"
- os - valgfri operativsystemspesifikasjon. En liste over operativsystemer definert av Eclipse (se
org.eclipse.core.runtime.Platform) i Javadoc. Listen bruker komma som skilletegn.
Viser at denne oppføringen bare skal installeres på et av de oppgitte OS-systemene. Hvis dette attributtet
ikke er oppgitt, kan oppføringen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av oppføringen uavhengig av denne
innstillingen).
- arch - valgfri spesifikasjon av maskinarkitekturen. En liste over arkitekturer definert av Eclipse (se
org.eclipse.core.runtime.Platform i Javadoc). Listen bruker komma som skilletegn.
Viser at denne funksjonen bare skal installeres på et av de oppgitte systemene. Hvis dette attributtet ikke er oppgitt, kan funksjonen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av funksjonen uavhengig av denne
innstillingen).
- ws - valgfri vindussystemspesifikasjon. En liste over vindussystemer definert av Eclipse (se
org.eclipse.core.runtime.Platform i Javadoc). Listen bruker komma som skilletegn.
Viser at denne oppføringen bare skal installeres på et av de oppgitte vindussystemene.
Hvis dette attributtet
ikke er oppgitt, kan oppføringen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av oppføringen uavhengig av denne
innstillingen).
- nl - valgfri språkmiljøspesifikasjon. En liste over språkmiljøer definert av Java. Listen bruker komma som
skilletegn. Viser at denne oppføringen bare skal installeres på et system som kjøres med et kompatibelt språkmiljø
(ved hjelp av Javas regler for samsvarende språkmiljø). Hvis dette attributtet ikke er oppgitt, kan oppføringen
installeres på alle systemer (språknøytral implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av oppføringen uavhengig av denne
innstillingen).
- download-size - valgfritt tips fra funksjonspakkeren som viser nedlastingsstørrelsen i kB for
plugin-arkivet det blir referert til. Hvis den ikke er oppgitt, er ikke nedlastingsstørrelsen kjent
(Implementeringsmerknad: implementeringen må skille mellom "ikke kjent" og størrelse 0)
- install-size - valgfritt tips fra funksjonspakkeren som viser installeringsstørrelsen i kB for
plugin-arkivet det blir referert til. Hvis den ikke er oppgitt, er ikke installeringsstørrelsen kjent
(Implementeringsmerknad: implementeringen må skille mellom "ikke kjent" og størrelse 0)
- unpack (ny i 3.0) - valgfri spesifikasjon fra funksjonspakkeren som viser at plugin-modulen kan kjøres fra
en jar-fil, og at innholdet i plugin-jar ikke skal pakkes ut i en katalog. Standardverdien er "true".
(Implementeringsmerknad: ufullstendige plugin-moduler i en funksjon som oppgir
org.eclipse.update.core.DeltaInstallHandler som en installeringsbehandler, skal
ikke sette unpack til "false")
- <data> - identifiserer ikke-plugin-data som er del av funksjonen
- id - obligatorisk data-ID i form av en relativ bane.
- os - valgfri operativsystemspesifikasjon. En liste over operativsystemer definert av Eclipse (se
org.eclipse.core.runtime.Platform) i Javadoc. Listen bruker komma som skilletegn.
Viser at denne oppføringen bare skal installeres på et av de oppgitte operativsystemene.
Hvis dette attributtet
ikke er oppgitt, kan oppføringen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av oppføringen uavhengig av denne
innstillingen).
- arch - valgfri spesifikasjon av maskinarkitekturen. En liste over arkitekturer definert av Eclipse (se
org.eclipse.core.runtime.Platform i Javadoc). Listen bruker komma som skilletegn.
Viser at denne funksjonen bare skal installeres på et av de oppgitte systemene. Hvis dette attributtet ikke er oppgitt, kan funksjonen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av funksjonen uavhengig av denne
innstillingen).
- ws - valgfri vindussystemspesifikasjon. En liste over vindussystemer definert av Eclipse (se
org.eclipse.core.runtime.Platform i Javadoc). Listen bruker komma som skilletegn.
Viser at denne oppføringen bare skal installeres på et av de oppgitte vindussystemene. Hvis dette attributtet ikke
er oppgitt, kan oppføringen installeres på alle systemer (flyttbar implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av oppføringen uavhengig av denne
innstillingen).
- nl - valgfri språkmiljøspesifikasjon. En liste over språkmiljøer definert av Java. Listen bruker komma som
skilletegn. Viser at denne oppføringen bare skal installeres på et system som kjøres med et kompatibelt språkmiljø
(ved hjelp av Javas regler for samsvarende språkmiljø). Hvis dette attributtet ikke er oppgitt, kan oppføringen
installeres på alle systemer (språknøytral implementering). Denne informasjonen blir brukt som et tips av
installerings- og oppdateringsstøtten (brukeren kan tvinge gjennom installering av oppføringen uavhengig av denne
innstillingen).
- download-size - valgfritt tips fra funksjonspakkeren som viser nedlastingsstørrelsen i kB for dataarkivet
det blir referert til. Hvis den ikke er oppgitt, er ikke nedlastingsstørrelsen kjent
(Implementeringsmerknad: implementeringen må skille mellom "ikke kjent" og størrelse 0)
- install-size - valgfritt tips fra funksjonspakkeren som viser installeringsstørrelsen i kB for dataarkivet
det blir referert til. Hvis den ikke er oppgitt, er ikke installeringsstørrelsen kjent
(Implementeringsmerknad: implementeringen må skille mellom "ikke kjent" og størrelse 0)
Ved interaksjon med oppdateringsstedet tilordner funksjonsimplementeringen elementene <plugin>
og <data> til bane-IDer som brukes av nettstedet, for å bestemme de faktiske filene som skal lastes
ned og installeres. Standard funksjonsimplementering som leveres av Eclipse, konstruerer bane-IDene på følgende
måte:
-
<plugin>-elementet resulterer i en baneoppføring som har formen
"plugins/<pluginId>_<pluginVersion>.jar"
(for eksempel "plugins/org.eclipse.core.boot_2.0.0.jar")
-
<data>-elementet resulterer i en baneoppføring som har formen
"features/<featureId>_<featureVersion>/<dataId>"
(for eksempel "features/com.xyz.tools_1.0.3/examples.zip")
Legg merke til at feature.xml-manifestdokumentene generelt skal oppgi UTF-8-koding. Eksempel:
<?xml version="1.0" encoding="UTF-8"?>
Tekst som kan oversettes, som ligger i feature.xml, kan deles inn i feature<_locale>.properties-filer ved
hjelp av konvensjoner for Java-egenskapsbunter.
Legg merke til at strenger som kan oversettes, blir brukt under
installering (det vil si at de ikke bruker kjøretidsmekanismen for plugin-fragmentet).