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
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.
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
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
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.
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.