Personalizzazione di un prodotto

Il plug-in associato a una funzione principale è il luogo in cui vengono specificate le informazioni relative al marchio di un dato prodotto.  Sono numerosi gli aspetti di un prodotto che è possibile personalizzare.  Le personalizzazioni a livello di prodotto vengono definite mediante il file about.ini e altri file indicati al suo interno.  I prodotti possono anche controllare i valori predefiniti relativi alle preferenze di altri plug-in.  Tale operazione può essere eseguita mediante 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 Guida->Informazioni su dal menu del workbench.  

La finestra di dialogo Informazioni su si basa su informazioni fornite da funzioni e plug-in.  Tutte le funzioni e i plug-in devono fornire un file about.html contenente informazioni su quel particolare plug-in.  Tali informazioni vengono visualizzate quando l'utente richiede dettagli sulle funzioni o i plug-in selezionando una funzione o un plug-in specifici.

La funzione principale fornisce anche tutte le informazioni e le immagini relative al prodotto.  File aggiuntivi vengono utilizzati per specificare tali informazioni.

Immagini delle finestre

E possibile utilizzare un'immagine a colori di 16 x 16 pixel per inserire il marchio nelle finestre create dal prodotto.  L'immagine verrà visualizzata nell'angolo superiore sinistro delle finestre del prodotto  e viene specificata nell'attributo windowImage all'interno del file about.ini.  Il percorso deve essere specificato come percorso relativo di plug-in.  Una voce appropriata per la struttura di directory mostrata sopra si presenterà come segue:

windowImage=acme.gif

Pagina di benvenuto

La descrizione relativa alla pagina di benvenuto del prodotto deve essere definita in un file xml nel formato descritto in Configurazione della pagina di benvenuto della piattaforma.  Viene specificata nell'attributo welcomePage all'interno del file about.ini. Il percorso deve essere specificato come percorso relativo di plug-in.  Una voce appropriata per la struttura di directory mostrata sopra si presenterà come segue:

welcomePage=welcome.xml

E anche possibile specificare una ricerca delle lingue nazionali per il file.  (VedereFile specifici delle impostazioni internazionali per maggiori dettagli.)

welcomePage=$nl$/welcome.xml

Schermate iniziali

La schermata iniziale del prodotto viene fornita in un file splash.bmp ubicato nella directory dei plug-in delle funzioni principali.  L'immagine deve essere in formato BMP con colori a 24 bit (formato RGB) e deve presentare una dimensione di circa 500 x 330 pixel.  Se occorre personalizzare le schermate iniziali per impostazioni internazionali differenti, è possibile posizionarle in un frammento del plug-in della funzione principale.

Valori predefiniti delle preferenze

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

Una personalizzazione frequente consiste nell'impostare la prospettiva predefinita per il workbench.  Tale preferenza viene definita nel plug-in org.eclipse.ui .   Nell'esempio riportato di seguito 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 tradotte relative al file plugin_customization.ini.

Copyright
IBM Corp. e altri 2000,2002.