Personnalisation d'un produit

Il y a de nombreux aspects personnalisables d'un produit, comme l'écran d'accueil, le texte de la boîte de dialogue A propos de, les icônes des fenêtres, etc. La plupart de ces personnalisations sont définies dans la contribution au point d'extension org.eclipse.core.runtime.products.

Etudions la définition de quelques éléments personnalisables les plus courants.

Boîtes de dialogue A propos de

La boîte de dialogue "A propos de" de la plate-forme s'affiche lorsque l'utilisateur sélectionne le menu Aide > A propos de dans le menu du plan de travail.  

Boîte de dialogue 'A propos de'

La partie supérieure de la boîte de dialogue affiche les informations de niveau de produit tandis que la partie inférieure décrit les fonctions (le cas échéant) et les plug-ins installés. Les détails de la fonction (informations commerciales si vous le souhaitez) sont fournis à l'aide des fichiers about.ini, about.properties et about.html dans le plug-in associé à la fonction. Ces informations sont affichées lorsque l'utilisateur demande des détails sur la fonction et sélectionne une fonction en particulier.

Les informations commerciales du produit (moitié supérieure de la boîte de dialogue) sont spécifiées par les propriétés d'extension qui décrivent le texte et les images qui sont affichés dans cette boîte de dialogue. Par exemple, l'extrait ci-dessous de la déclaration de produit de la plate-forme Eclipse.

	<property
		name="aboutText"
		value="%aboutText"/>
	<property
		name="aboutImage"
		value="icons/eclipse_lg.png"/>
	</product>

Pour plus d'informations sur ces propriétés, reportez-vous à IProductConstants.

Images de fenêtres

Une image couleur 16 x 16 pixels peut être utilisée pour les fenêtres de marque créés par le produit. Elle s'affiche dans le coin supérieur gauche des fenêtres de produit. Elle est spécifiée dans l'attribut windowImage dans la définition des extensions de produits. Autrement, l'attribut windowImages peut être utilisé pour décrire un tableau d'images de différentes tailles qui doivent être utilisées dans le coin supérieur gauche.

	<property
		name="windowImages"
		value="icons/eclipse.png,icons/eclipse32.png"/>

La propriété windowImages supplante la propriété windowImage si les deux propriétés sont spécifiées.

Page d'accueil

Les produits qui utilisent le mécanisme de page d'accueil Eclipse 2.1 peuvent spécifier le nom et l'emplacement du fichier de page d'accueil dans la propriété welcomePage.

	<property
		name="welcomePage"
		value="$nl$/welcome.xml"/>

L'utilisation de cette propriété n'est pas conseillé dans Eclipse 3.0. Vous devez lui préférer le point d'extension org.eclipse.ui.intro. Pour plus d'informations sur les nouveaux mécanismes de page d'accueil/d'introduction, reportez-vous à la section Prise en charge de l'introduction.

Valeurs par défaut des préférences

La propriété preferenceCustomization peut être utilisée pour spécifier un fichier contenant des valeurs de préférences par défaut pour le produit.

	<property
		name="preferenceCustomization"
		value="plugin_customization.ini"/>

Ce fichier est un fichier au format java.io.Properties. Il est généralement utilisé pour définir les valeurs des préférences publiées comme partie d'une API publique du plug-in. Vous risquez donc de mentionner des préférences utilisées par des plug-ins mais qui ne sont pas définies officiellement dans l'API.  

Ecrans d'accueil

L'écran d'accueil du produit est indiqué dans le fichier config.ini qui se trouve dans le répertoire configuration du produit. La propriété osgi.splashPath de ce fichier décrit les emplacements auxquels recherche un fichier appelé splash.bmp. La propriété osgi.splashLocation identifie un chemin complet et exact permettant d'accéder au fichier de la page d'accueil à utiliser. Si vous indiquez un chemin d'accès à la page d'accueil, il est possible d'utiliser des pages d'accueil spécifiques à des paramètres régionaux car le chemin de recherche indiqué peut désigner plusieurs plug-ins ou fragments dans lesquels effectuer la recherche ainsi que des chemins de style $nl$. Pour obtenir une description complète des propriétés qui peuvent être configurées dans ce fichier, reportez-vous au fichier config.ini du kit SDK de la plate-forme. L'image doit être fournie au format BMP couleurs 24 bits (format RVB). Sa taille doit être d'environ 500 x 330 pixels.