Personalizzazione di un prodotto

Sul plug-in associato a una funzione principale vengono specificate le informazioni relative al marchio di un prodotto.   È possibile personalizzare diversi aspetti di un prodotto. Le personalizzazioni a livello di prodotto vengono definite utilizzando il file about.ini e altri file descritti in questa sezione. I prodotti possono anche controllare i valori predefiniti delle preferenze di altri plug-in. A tale scopo è necessario utilizzare il file plugin_customization.ini.

Facendo riferimento ancora una volta al plug-in delle funzioni principali del prodotto di esempio, verranno illustrate più dettagliatamente le modalità di personalizzazione del prodotto.

com.example.acme.acmefeature_1.0.0/
		plugin.xml
		about.ini
		about.html
		about.mappings
		about.properties
		acme.gif
		plugin_customization.ini
		plugin_customization.properties
		splash.bmp
		welcome.xml

Finestre di dialogo Informazioni su

La finestra di dialogo "Informazioni su" della piattaforma viene visualizzata ogni volta che l'utente seleziona ?->Informazioni su nel menu del workbench.  

Tale finestra viene costruita utilizzando le informazioni fornite dalle funzioni e dai plug-in. Tutte le funzioni e i plug-in devono fornire un file about.html contenente informazioni sul particolare plug-in. Tali informazioni vengono visualizzate quando l'utente richiede dettagli sulla funzione o sul plug-in e seleziona una particolare funzione o un particolare plug-in.

La funzione principale fornisce anche le informazioni e le immagini relative al prodotto.  Per specificare tali informazioni vengono utilizzati file aggiuntivi.

Immagini delle finestre

È possibile utilizzare un'immagine a colori da 16x16 pixel per apporre un marchio sulle finestre create dal prodotto. Tale immagine verrà visualizzata nell'angolo superiore sinistro delle finestre del prodotto  e sarà specificata nell'attributo windowImage del file about.ini. Il percorso deve essere specificato come percorso relativo del plug-in. Una voce appropriata per la struttura di directory indicata sopra si presenterà nel modo seguente:

windowImage=acme.gif

Pagina di benvenuto

La descrizione della pagina di benvenuto del prodotto deve essere definita in un file xml utilizzando il formato descritto in Configurazione della pagina di benvenuto della piattaforma. Tale descrizione viene specificata nell'attributo welcomePage del file about.ini. Il percorso deve essere specificato come percorso relativo del plug-in. Una voce appropriata per la struttura di directory indicata sopra si presenterà nel modo seguente:

welcomePage=welcome.xml

È anche possibile specificare una ricerca delle lingue nazionali per il file. Per ulteriori informazioni, vedere File specifici locali.

welcomePage = $nl$/welcome.xml

Schermate iniziali

La schermata iniziale del prodotto viene fornita in un file splash.bmp disponibile nella directory dei plug-in delle funzioni principali. L'immagine deve essere fornita in formato BMP a colori da 24 bit (formato RGB) e deve avere una dimensione pari a circa 500x330 pixel.  Se è necessario personalizzare le schermate iniziali per le diverse impostazioni internazionali, è possibile inserirle in un frammento del plug-in delle funzioni principali.

Valori predefiniti delle preferenze

Il file plugin_customization.ini viene utilizzato per impostare i valori predefiniti per le preferenze definite da altri plug-in. Tale file è in formato java.io.Properties e generalmente viene utilizzato per impostare i valori delle preferenze pubblicate come parte di un'API pubblica del plug-in.  Ciò significa che può essere rischioso fare riferimento a preferenze utilizzate dai plug-in ma non definite formalmente nell'API.  

Una personalizzazione comune consiste nell'impostazione della prospettiva predefinita per il workbench. Questa preferenza è definita nel plug-in org.eclipse.ui .   Nell'esempio che segue si presuppone che il prodotto debba essere avviato con la prospettiva delle risorse come prospettiva predefinita.

org.eclipse.ui/defaultPerspectiveId=org.eclipse.ui.resourcePerspective

Se si avverte l'esigenza di modificare il valore predefinito di una delle preferenze di un altro plug-in, consultare la documentazione API relativa a tale plug-in per vedere se la preferenza in questione è considerata pubblica.

Il file plugin_customization.properties contiene stringhe convertite relative al file plugin_customization.ini.

Copyright IBM Corporation e altri 2000, 2003.