Manifest di funzione della piattaforma Eclipse
Versione 3.0 - Ultima
revisione: 22 giugno 2004
Il formato del manifest di funzione viene definito dalla seguente
dichiarazione 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
>
Di seguito sono riportate le definizioni degli elementi e degli attributi:
- <feature> - definisce la funzione
- id - identificativo necessario della funzione (ad esempio com.xyz.myfeature)
- version - versione necessaria del componente (ad esempio 1.0.3)
- label - etichetta facoltativa visualizzabile (nome). Da utilizzare per la traduzione.
- provider-name - etichetta facoltativa di visualizzazione che identifica
l'organizzazione che fornisce questo componente. Da utilizzare per la traduzione.
- image - immagine facoltativa da utilizzare quando vengono visualizzate
informazioni relative alla funzione.
Specificata rispetto a feature.xml.
- os - specifica facoltativa del sistema operativo. Elenco di identificativi del sistema operativo,
separati da una virgola, definito da Eclipse (consultare Javadoc per
org.eclipse.core.runtime.Platform).
Indica che questa funzione dovrebbe essere installata solo su uno dei sistemi operativi specificati. Se tale attributo non è specificato, è possibile
installare la funzione su tutti i sistemi (implementazione trasferibile). Questa informazione viene utilizzata come suggerimento dal
supporto di installazione e di aggiornamento (l'utente può forzare
l'installazione della funzione senza tener conto di tale impostazione).
- arch - specifica facoltativa relativa all'architettura del computer. Elenco di
identificativi dell'architettura, separati da una virgola, definito da Eclipse
(consultare Javadoc per org.eclipse.core.runtime.Platform).
Indica che questa funzione dovrebbe essere installata solo su uno dei
sistemi specificati. Se tale attributo non è specificato, è possibile
installare la funzione su tutti i sistemi (implementazione trasferibile). Questa informazione viene utilizzata come suggerimento dal
supporto di installazione e di aggiornamento (l'utente può forzare
l'installazione della funzione senza tener conto di tale impostazione).
- ws - specifica facoltativa relativa ai sistemi a finestre. Elenco di identificativi del sistema
a finestre, separati da una virgola, definito da Eclipse (consultare Javadoc per
org.eclipse.core.runtime.Platform).
Indica che questa funzione dovrebbe essere installata solo su
uno dei sistemi a finestre specificati. Se tale attributo non è specificato, è possibile
installare la funzione su tutti i sistemi (implementazione trasferibile). Questa informazione viene utilizzata come suggerimento dal
supporto di installazione e di aggiornamento (l'utente può forzare
l'installazione della funzione senza tener conto di tale impostazione).
- nl - specifica facoltativa relativa alle impostazioni internazionali. Elenco
di identificativi delle impostazioni internazionali, separati da virgola,
definito da Java. Indica che questa funzione dovrebbe essere installata
solo su un sistema che utilizza un'impostazione internazionale compatibile
(che utilizza le regole di corrispondenza delle impostazioni
internazionali di Java). Se tale attributo non è specificato, è possibile
installare la funzione su tutti i sistemi (implementazione lingua di
sistema). Questa informazione viene utilizzata come suggerimento dal
supporto di installazione e di aggiornamento (l'utente può forzare
l'installazione della funzione senza tener conto di tale impostazione).
- colocation-affinity - riferimento facoltativo a un altro
identificativo di funzione utilizzato per selezionare il percorso di
installazione predefinita per questa funzione. Quando questa funzione
viene installata come nuova funzione (non esistono altre versioni
installate), viene fatto un tentativo di installare tale funzione nello stesso
percorso di installazione della funzione di riferimento.
- primary - indicazione facoltativa che specifica se è possibile
utilizzare questa funzione come funzione principale. Il valore predefinito è
false (non è una funzione principale).
- application - identificativo facoltativo dell'applicazione Eclipse da
utilizzare durante la fase di avvio quando la funzione che viene dichiarata
è la funzione principale. L'identificativo dell'applicazione deve
rappresentare un'applicazione valida registrata nel punto di estensione
org.eclipse.core.runtime.applications. Il valore predefinito é org.eclipse.ui.ide.workbench.
- plugin - identificativo facoltativo che rappresenta
l'id del plugin elencato nella funzione utilizzata per trasportare
informazioni di identificazione sulla funzione (immagini, traduzioni,
schermate iniziali nel caso di funzione primaria, ecc.). Se non viene
specificato, si presuppone che il plugin di attribuzione abbia lo stesso ID
della funzione.
- exclusive - indicatore facoltativo che, se "true", indica che la
funzione non può essere installata in un gruppo con altre funzioni.
- <install-handler>
- library - libreria .jar facoltativa, contenente le classi del gestore di
installazione.
Se specificato, il .jar a cui si fa riferimento deve essere contenuto
nell'archivio di funzioni.
Viene specificato come un percorso all'interno dell'archivio di funzioni,
relativo alla voce feature.xml. Se invece non è specificato, sarà
utilizzato l'archivio di funzioni per caricare le classi del gestore di
installazione. Questo attributo viene interpretato solo se viene
specificato anche l'attributo class
- handler - identificativo facoltativo del gestore di installazione. Il
valore viene interpretato relativamente al valore dell'attributo library. Se
library è specificato, il valore viene interpretato come il
nome completo di una classe contenuta nel library specificato. Se
invece library non è specificato, il valore viene interpretato come
un identificativo di estensione registrato nel punto di estensione
org.eclipse.update.installHandlers. In entrambi i casi la classe
risultante deve implementare l'interfaccia IInstallHandler. La
classe viene caricata in maniera dinamica e chiamata in punti specifici
durante l'elaborazione della funzione. Quando il gestore viene specificato
come classe, ha una visibilità per le classe API dal plugin
org.eclipse.update.core e i plugin Eclipse richiesti da questo plugin. In
caso contrario, quando viene specificato come estensione, accede a tutte le
classi come il plugin che definisce l'estensione.
- <description> - breve descrizione del componente come testo semplice. Da utilizzare per la traduzione.
- url - URL facoltativo per la descrizione completa come HTML. Può essere specificato come assoluto o relativo. Se relativo, è presumibile che
corrisponda all'archivio di funzioni (e che sia nel relativo pacchetto). Tenere presente che per la gestione delle lingue nazionali il valore di URL deve essere separato per consentire di specificare URL
alternativi per ciascuna lingua.
- <copyright> - copyright di funzione come testo semplice. Da utilizzare per la traduzione.
- url - URL facoltativo per la descrizione completa come HTML. Può essere specificato come assoluto o relativo. Se relativo, è presumibile che
corrisponda all'archivio di funzioni (e che sia nel relativo pacchetto). Tenere presente che per la gestione delle lingue nazionali il valore di URL deve essere separato per consentire di specificare URL
alternativi per ciascuna lingua.
- <license> - funzione di "accettazione a schermo" della licenza come
testo semplice. Da utilizzare per la traduzione. Viene visualizzata in una finestra di dialogo standard
con le azioni [Accept] [Reject] durante il processo di
scaricamento/installazione. Occorre
notare che l'accettazione a schermo della licenza deve essere specificata
per qualsiasi funzione che verrà selezionata per l'installazione o
l'aggiornamento con il gestore aggiornamenti di Eclipse. Quando vengono
utilizzate funzioni nidificate, è necessario che solo la nidificazione
principale (ad esempio la funzione selezionata per l'installazione o
l'aggiornamento) abbia un testo definito di licenza con accettazione a
schermo. Il
testo della licenza è richiesto anche nel caso in cui venga specificato
l'attributo facoltativo url.
- url - URL facoltativo per la descrizione completa come HTML. Può essere specificato come assoluto o relativo. Se relativo, è presumibile che
corrisponda all'archivio di funzioni (e che sia nel relativo pacchetto). Si
noti che per la gestione delle lingue nazionali il valore di URL deve essere
separato per consentire di specificare URL alternativi per ciascuna lingua. È necessario inoltre notare
che il "contenuto" di questo URL non corrisponde a quello che
viene presentato come la licenza con accettazione a schermo durante il
processo di installazione. La licenza con accettazione a schermo
rappresenta il valore effettivo dell'elemento <license>
(ad esempio <license>click
through text</license>)
- <url> - URL facoltativo che specifica i siti che contengono
aggiornamenti delle funzioni o nuove funzioni
- <update> - URL cui collegarsi per aggiornare questa funzione
- url - URL corrente
- label - etichetta visualizzabile (nome) del sito indicato
- <discovery> - URL cui collegarsi per nuove funzioni. In genere un
fornitore utilizza questo collegamento per fare riferimento al proprio
sito o ai siti dei partner che offrono funzioni complementari. La piattaforma
Eclipse utilizza questo elemento semplicemente per distribuire nuovi URL ai
client. I siti che appartengono a funzioni principali (al livello superiore
della gerarchia) sono generalmente visualizzati in "Siti da visitare" in
Gestore aggiornamenti.
- url - URL corrente
- label - etichetta visualizzabile (nome) del sito indicato
- type (nuovo in 2.1) - per impostazione predefinita, i siti di
esplorazione sono considerati siti di aggiornamento ("update"). Impostando
il valore di questo attributo a "web", è possibile indicare a Eclipse
che l'URL deve essere considerata un normale collegamento Web ipertestuale che
può essere visualizzato direttamente in un browser.
- <includes> - riferimento facoltativo a una funzione nidificata
che viene considerata parte di questa funzione. Le funzioni nidificate
devono essere posizionate nello stesso sito di aggiornamento di questa
funzione
- id - identificativo della funzione nidificata obbligatorio. Se la funzione è
una patch, (vedere la sezione <requires> che segue), deve essere
l'ID di un'altra patch.
- version - versione della funzione nidificata obbligatoria
- optional - è possibile includere una funzione come facoltativa quando questo attributo è
"true". Gli utenti possono non installare le
funzioni facoltative, disabilitarle se sono installate e installarle
successivamente. Una funzione facoltativa mancante non è considerata un errore.
- name - se una funzione facoltativa risulta mancante, Eclipse non può utilizzarne il nome
correttamente. Questo attributo può essere utilizzato
come "segnaposto" per consentire a Eclipse di gestire il nome della funzione
facoltativa quando questa non è installata.
- search-location - una funzione inclusa può essere aggiornata dalle patch.
Per impostazione predefinita, il
percorso di ricerca è "root", ovvero verrà considerato l'URL
specificato nell'elemento "update" all'interno dell'elemento
"url" principale. Se una funzione inclusa ha definito
un proprio elemento "update", questo sarà ignorato.
Se la funzione principale vuole consentire alla funzione secondaria di essere
aggiornata dal proprio percorso, deve impostare questo attributo a
"both" o "self".
- os - specifica facoltativa del sistema operativo. Elenco di identificativi del sistema operativo,
separati da una virgola, definito da Eclipse (consultare Javadoc per
org.eclipse.core.runtime.Platform).
Indica che questa voce dovrebbe essere installata solo su uno dei sistemi operativi specificati. Se tale attributo non è specificato, è possibile
installare la voce su tutti i sistemi (implementazione trasferibile). Questa informazione
viene utilizzata come suggerimento dal supporto di installazione e di
aggiornamento (l'utente può forzare
l'installazione della voce senza tener conto di tale impostazione).
- arch - specifica facoltativa relativa all'architettura del computer. Elenco di
identificativi dell'architettura, separati da una virgola, definito da Eclipse
(consultare Javadoc per org.eclipse.core.runtime.Platform).
Indica che questa funzione dovrebbe essere installata solo su uno dei
sistemi specificati. Se tale attributo non è specificato, è possibile
installare la funzione su tutti i sistemi (implementazione trasferibile). Questa informazione viene utilizzata come suggerimento dal
supporto di installazione e di aggiornamento (l'utente può forzare
l'installazione della funzione senza tener conto di tale impostazione).
- ws - specifica facoltativa relativa ai sistemi a finestre. Elenco di identificativi del sistema
a finestre, separati da una virgola, definito da Eclipse (consultare Javadoc per
org.eclipse.core.runtime.Platform).
Indica che questa funzione dovrebbe essere installata solo su uno dei sistemi a finestre specificati.
Se tale attributo non è specificato, è possibile
installare la voce su tutti i sistemi (implementazione trasferibile). Questa informazione
viene utilizzata come suggerimento dal supporto di installazione e di
aggiornamento (l'utente può forzare
l'installazione della voce senza tener conto di tale impostazione).
- nl - specifica facoltativa relativa alle impostazioni internazionali. Elenco
di identificativi delle impostazioni internazionali, separati da virgola,
definito da Java. Indica che questa voce dovrebbe essere installata solo
su un sistema che utilizza un'impostazione internazionale compatibile
(che utilizza le regole di corrispondenza delle impostazioni internazionali di Java). Se tale attributo non è specificato, è possibile installare la voce su
tutti i sistemi (implementazione lingua di sistema). Questa informazione
viene utilizzata come suggerimento dal supporto di installazione e di
aggiornamento (l'utente può forzare
l'installazione della voce senza tener conto di tale impostazione).
- <requires> - informazioni facoltative sulle dipendenze della funzione. Vengono
espresse in termini di dipendenze dei plugin. Se specificato, vengono
imposte dal supporto di installazione e aggiornamento al momento
dell'installazione
- <import> - voce di dipendenza. Specifica ed elaborazione rappresentano un
sottoinsieme della specifica <import> nel plugin.xml
- plugin - identificativo del plugin dipendente, se il plugin è utilizzato per
esprimere dipendenza
- feature (nuovo in 2.1) - identificativo della funzione dipendente, se la
funzione è utilizzata per esprimere dipendenza. Deve essere definito uno
tra gli attributi plugin e feature, ma non entrambi. Se "patch" è
"true", deve essere utilizzato l'attributo feature.
- version - specifica facoltativa della versione del plugin. Se
"patch" è "true", deve essere impostato l'attributo
version.
- match - regola di corrispondenza facoltativa. I valori validi e
l'elaborazione sono quelli riportati di seguito:
- Se l'attributo della versione non viene specificato, l'attributo
di corrispondenza (se specificato) verrà ignorato.
- perfect - la versione del plugin dipendente deve
corrispondere esattamente alla versione specificata. Se "patch" è
"true", si assume il valore "perfect" e non è possibile
impostare altri valori.
- equivalent - la versione del plugin dipendente deve essere
almeno al livello della versione specificata o a un livello di servizio
superiore (i livelli di versione principale e secondario devono
uguagliare la versione specificata).
- compatible - la versione del plugin dipendente deve
essere almeno al livello della versione specificata, oppure a un livello di
servizio superiore o a un livello secondario (il livello della versione
principale deve uguagliare la versione specificata).
- greaterOrEqual - la versione del plugin dipendente deve
essere almeno al livello della versione specificata, o a un livello
principale o secondario di servizio superiore.
- patch - se "true", questa restrizione dichiara che la funzione inclusa deve essere una
patch per la funzione a cui viene fatto riferimento. Quando
si imposta questo attributo si devono seguire alcune regole:
- l'attributo feature deve essere utilizzato come identificatore
della funzione su cui si applica la patch
- l'attributo version deve essere impostato
- l'attributo match non deve essere impostato, viene assunto il valore
"perfect".
- se altre funzioni presentano attributi <include>, è necessario
che siano anche patch.
Una patch è una funzione speciale che contiene versioni più recenti di
plugin per la funzione su cui viene applicata la patch e non sostituisce la
funzione. Può anche portare con sé altre patch per inclusione.
- <plugin> - identifica il plugin referenziato
- id - identificativo obbligatorio del plugin (da plugin.xml)
- version - versione obbligatoria del plugin (da plugin.xml)
- fragment - specifica facoltativa che indica se questa voce è un frammento
di plugin. Il valore predefinito è "falso"
- os - specifica facoltativa del sistema operativo. Elenco di identificativi del sistema operativo,
separati da una virgola, definito da Eclipse (consultare Javadoc per
org.eclipse.core.runtime.Platform).
Indica che questa voce dovrebbe essere installata solo su uno dei sistemi
operativi specificati. Se tale attributo non è specificato, è possibile
installare la voce su tutti i sistemi (implementazione trasferibile). Questa informazione
viene utilizzata come suggerimento dal supporto di installazione e di
aggiornamento (l'utente può forzare
l'installazione della voce senza tener conto di tale impostazione).
- arch - specifica facoltativa relativa all'architettura del computer. Elenco di
identificativi dell'architettura, separati da una virgola, definito da Eclipse
(consultare Javadoc per org.eclipse.core.runtime.Platform).
Indica che questa funzione dovrebbe essere installata solo su uno dei
sistemi specificati. Se tale attributo non è specificato, è possibile
installare la funzione su tutti i sistemi (implementazione trasferibile). Questa informazione viene utilizzata come suggerimento dal
supporto di installazione e di aggiornamento (l'utente può forzare
l'installazione della funzione senza tener conto di tale impostazione).
- ws - specifica facoltativa relativa ai sistemi a finestre. Elenco di identificativi del sistema
a finestre, separati da una virgola, definito da Eclipse (consultare Javadoc per
org.eclipse.core.runtime.Platform).
Indica che questa funzione dovrebbe essere installata solo su uno dei sistemi a finestre specificati.
Se tale attributo non è specificato, è possibile
installare la voce su tutti i sistemi (implementazione trasferibile). Questa informazione
viene utilizzata come suggerimento dal supporto di installazione e di
aggiornamento (l'utente può forzare
l'installazione della voce senza tener conto di tale impostazione).
- nl - specifica facoltativa relativa alle impostazioni internazionali. Elenco
di identificativi delle impostazioni internazionali, separati da virgola,
definito da Java. Indica che questa voce dovrebbe essere installata solo
su un sistema che utilizza un'impostazione internazionale compatibile
(che utilizza le regole di corrispondenza delle impostazioni internazionali di Java). Se tale attributo non è specificato, è possibile installare la voce su
tutti i sistemi (implementazione lingua di sistema). Questa informazione
viene utilizzata come suggerimento dal supporto di installazione e di
aggiornamento (l'utente può forzare
l'installazione della voce senza tener conto di tale impostazione).
- download-size - suggerimento facoltativo fornito dal packager della
funzione, che indica le dimensioni in KB dell'archivio di
plugin da scaricare. Se non è specificato, le dimensioni non sono note (Nota di implementazione: è necessario che
l'implementazione distingua tra "non noto" e dimensione 0)
- install-size - suggerimento facoltativo fornito dal packager della
funzione, che indica le dimensioni di installazione in KB dell'archivio di
plugin a cui si fa riferimento. Se non è specificato, le
dimensioni di installazione non sono note (Nota di implementazione:
è necessario che l'implementazione distingua tra "non noto" e dimensione 0)
- unpack (nuovo nella versione 3.0) - specifica facoltativa fornita dal
programma di creazione pacchetti della funzione, che indica che il plugin può
essere eseguito da un jar e che il contenuto del jar di un plugin non deve
essere decompresso in una directory. L'impostazione predefinita è "true".
(Nota di implementazione: i plugin parziali - forniti in una
funzione che specifica org.eclipse.update.core.DeltaInstallHandler
come gestore di installazione non deve impostare unpack su "false")
- <data> - identifica dati non di plugin che fanno parte della funzione
- id - identificativo necessario di dati sotto forma di percorso relativo.
- os - specifica facoltativa del sistema operativo. Elenco di identificativi del sistema operativo,
separati da una virgola, definito da Eclipse (consultare Javadoc per
org.eclipse.core.runtime.Platform).
Indica che questa voce dovrebbe essere installata solo su uno dei sistemi operativi specificati.
Se tale attributo non è specificato, è possibile
installare la voce su tutti i sistemi (implementazione trasferibile). Questa informazione
viene utilizzata come suggerimento dal supporto di installazione e di
aggiornamento (l'utente può forzare
l'installazione della voce senza tener conto di tale impostazione).
- arch - specifica facoltativa relativa all'architettura del computer. Elenco di
identificativi dell'architettura, separati da una virgola, definito da Eclipse
(consultare Javadoc per org.eclipse.core.runtime.Platform).
Indica che questa funzione dovrebbe essere installata solo su uno dei
sistemi specificati. Se tale attributo non è specificato, è possibile
installare la funzione su tutti i sistemi (implementazione trasferibile). Questa informazione viene utilizzata come suggerimento dal
supporto di installazione e di aggiornamento (l'utente può forzare
l'installazione della funzione senza tener conto di tale impostazione).
- ws - specifica facoltativa relativa ai sistemi a finestre. Elenco di identificativi del sistema
a finestre, separati da una virgola, definito da Eclipse (consultare Javadoc per
org.eclipse.core.runtime.Platform).
Indica che questa funzione dovrebbe essere installata solo su uno dei sistemi a finestre specificati. Se
tale attributo non è specificato, è possibile installare su tutti i sistemi (implementazione
trasferibile). Questa informazione
viene utilizzata come suggerimento dal supporto di installazione e di
aggiornamento (l'utente può forzare
l'installazione della voce senza tener conto di tale impostazione).
- nl - specifica facoltativa relativa alle impostazioni internazionali. Elenco
di identificativi delle impostazioni internazionali, separati da virgola,
definito da Java. Indica che questa voce dovrebbe essere installata solo
su un sistema che utilizza un'impostazione internazionale compatibile
(che utilizza le regole di corrispondenza delle impostazioni internazionali di Java). Se tale attributo non è specificato, è possibile installare la voce su
tutti i sistemi (implementazione lingua di sistema). Questa informazione
viene utilizzata come suggerimento dal supporto di installazione e di
aggiornamento (l'utente può forzare
l'installazione della voce senza tener conto di tale impostazione).
- download-size - suggerimento facoltativo fornito dal programma di creazione
pacchetti della funzione, che indica le dimensioni in KB dell'archivio di
dati cui si fa riferimento. Se non è specificato, le dimensioni non sono note (Nota di implementazione: è necessario che
l'implementazione distingua tra "non noto" e dimensione 0)
- install-size - suggerimento facoltativo fornito dal programma di creazione
pacchetti della funzione, che indica le dimensioni di installazione in KB
dell'archivio di dati cui si fa riferimento. Se non è specificato, le
dimensioni di installazione non sono note (Nota di implementazione:
è necessario che l'implementazione distingua tra "non noto" e dimensione 0)
Quando si interagisce con il sito di aggiornamento, l'implementazione
della funzione associa gli elementi <plugin> e
<data> in identificativi di percorso utilizzati dal sito
per determinare quali siano i file effettivi da scaricare e installare. L'implementazione
della funzione predefinita fornita da Eclipse costruisce gli
identificativi di percorso come riportato di seguito:
-
L'elemento <plugin> determina una voce di percorso nel formato
"plugins/<pluginId>_<pluginVersion>.jar"
(ad esempio, "plugins/org.eclipse.core.boot_2.0.0.jar")
-
L'elemento <data> determina una voce di percorso nel formato
"features/<featureId>_<featureVersion>/<dataId>"
(ad esempio, "features/com.xyz.tools_1.0.3/examples.zip")
In generale i documenti di manifest di feature.xml devono specificare la codifica UTF-8. Ad esempio:
<?xml version="1.0" encoding="UTF-8"?>
È possibile separare il testo traducibile contenuto nella
funzione.xml, nei file feature<_locale>.properties utilizzando le
convenzioni dell'insieme delle proprietà Java.
Tenere presente che le stringhe tradotte vengono utilizzate in fase di
installazione e quindi non utilizzano il meccanismo di run-time del
frammento di plugin.