Le plug-in associé à un dispositif primaire 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 primaire 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.gif plugin_customization.ini plugin_customization.properties splash.bmp welcome.xml
La boîte de dialogue "A propos de" s'affiche chaque fois que l'utilisateur sélectionne Aide->A propos de dans le menu du plan de travail.
Cette boîte de dialogue est composée des informations fournies par des dispositifs et des plug-in. Tous doivent apporter un fichier about.html contenant des informations sur le plug-in en question. Ces données s'affichent lorsque l'utilisateur demande des détails sur un dispositif ou un plug-in et en choisi un.
Le dispositif primaire fournit également des informations et des graphiques pour le produit dans son ensemble. D'autres fichiers sont utilisés pour indiquer ces informations.
Une image couleur de 16x16 pixels peut être utilisée pour illustrer les fenêtres créées par le produit. Elle apparaît dans le coin supérieur gauche de la fenêtre du produit. Elle est précisée dans l'attribut windowImage du fichier about.ini. Le chemin d'accès doit être mentionné comme chemin relatif du plug-in. Une entrée propre pour la structure de répertoires évoquée devrait se présenter comme suit :
windowImage=acme.gif
La description de la page de bienvenue du produit doit être définie dans un fichier XML au format décrit dans la section Configuration de la page de bienvenue de la plateforme. Elle est précisée dans l'attribut welcomePage du fichier about.ini. Le chemin d'accès doit être mentionné comme chemin relatif du plug-in. Une entrée propre pour la structure de répertoires évoqué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
L'écran d'accueil du produit se trouve dans le fichier splash.bmp situé dans le répertoire de plug-in du dispositif primaire. 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 primaire.
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.