Personnalisation d'une fonction principale

La personnalisation des produits est différente lorsque vous utilisez le mécanisme de fonction principale. Les informations commerciales de la fonction se trouvent dans un plug-in identifié par la fonction principale (ou le plug-in du même nom que la fonction principale en l'absence d'indication). Les fichiers qui désignent et définissent les informations commerciales pour l'application acmeweb hypothétique sont mis en évidence dans l'exemple de structure de répertoires ci-dessous :

acmeweb/
	acmeweb.exe	(produit exécutable - appelle eclipse.exe et indique le dispositif principal)
	eclipse/
		.eclipseproduct
		eclipse.exe
		startup.jar
		install.ini
		.config/
		platform.cfg
		jre/
		features/
			com.example.acme.acmefeature_1.0.0/    (dispositif principal)
				feature.xml
		plugins/
			com.example.acme.acmefeature_1.0.0/    (plug-in pour le dispositif principal. Contient des informations commerciales.)
				plugin.xml
				about.ini
				about.html
				about.mappings
				about.properties
				acme.png
				plugin_customization.ini
				splash.jpg
				welcome.xml
			com.example.acme.acmewebsupport_1.0.0/
			...
		links/
			...

Le plug-in associé à un dispositif principal se trouve à l'endroit où les informations commerciales d'un produit figurent. Plusieurs aspects d'un produit sont personnalisables. Les personnalisations sont définies à l'aide du fichier about.ini et d'autres décrits plus loin. Les produits peuvent également contrôler les valeurs de préférences par défaut d'autres plug-in. Le fichier plugin_customization.ini permet cette opération.

Reprenons l'exemple de plug-in de dispositif principal d'un produit et observons comment le produit est personnalisé.

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

Nous examinerons les personnalisations que nous avons présentées pour le point d'extension des produits, en nous concentrant sur la manière dont la spécification diffère à l'aide du mécanisme de fonction principale.

Boîtes de dialogue A propos de

Comme vous l'avez découvert lors de la personnalisation au niveau des produits, toutes les fonctions et tous les plug-ins doivent fournir un fichier about.html qui contient des informations relatives à un plug-in déterminé.

Le dispositif principal fournit également des informations et des graphiques pour le produit dans son ensemble. D'autres fichiers sont utilisés pour indiquer ces informations.

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 le fichier about.ini.  Le chemin d'accès doit être spécifié comme un chemin relatif de plug-in.  Pour être adéquate, l'entrée de la structure de répertoire pré-citée doit se présenter comme suit :

windowImage=acme.png

Page de bienvenue

Les plug-ins qui utilisent les mécanismes Welcome de la version 2.1 d'Eclipse doivent spécifier le fichier de page d'accueil dans l'attribut welcomePage dans le fichier about.ini. Le chemin d'accès doit être indiqué comme un chemin relatif de plug-in.  Pour être adéquate, l'entrée de la structure de répertoire pré-citée doit se présenter comme suit :

welcomePage=welcome.xml

Vous pouvez également demander une consultation dans la langue nationale. Consultez la section Fichiers spécifiques à des environnements locaux pour en savoir plus.

welcomePage=$nl$/welcome.xml

Ecrans d'accueil

L'écran d'accueil du produit se trouve dans le fichier splash.bmp situé dans le répertoire de plug-in du dispositif principal. L'image doit être au format BMP couleurs 24 bit (format RGB) et sa taille doit être environ de 500x330 pixels. Si des écrans d'accueil doivent être personnalisés pour d'autres environnements locaux, ils peuvent être placés dans un fragment du plug-in du dispositif principal.

Valeurs des préférences par défaut

Le fichier plugin_customization.ini est utilisé pour définir les valeurs par défaut pour les préférences définies par d'autres plug-in. Ce fichier est un ficher de 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.  

Souvent, la personnalisation consiste à définir la perspective par défaut du plan de travail. Cette préférence est établie dans le plug-in org.eclipse.ui.  L'exemple suivant suppose que le produit doit être lancé avec la perspective de ressource comme perspective par défaut.

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

Si vous pensez devoir modifier la valeur par défaut pour l'une des préférences de plug-in, reportez-vous à la documentation de l'API afin de savoir si cette préférence est considérée publique.

Le fichier plugin_customization.properties contient les chaînes traduites pour le fichier plugin_customization.ini.