Personalizar un producto

El conector asociado a una característica primaria es el lugar destinado a especificar la información de sello personal de un producto.  Existen muchos aspectos de un producto que pueden personalizarse.  Las personalizaciones a nivel de producto se definen mediante el archivo about.ini y otros archivos descritos en él.  Los productos también pueden controlar los valores de preferencias por omisión de otros conectores.  Esta operación se realiza mediante el archivo plugin_customization.ini.

Siguiendo con el conector de característica primaria de nuestro producto de ejemplo, veremos detenidamente cómo se personaliza el producto.

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

Diálogos Acerca de

En la plataforma, el diálogo "acerca de" se muestra siempre que el usuario selecciona Ayuda->Acerca de en el menú del entorno de trabajo.  

El diálogo acerca de se construye utilizando la información suministrada por las características y los conectores.  Todas las características y conectores deben aportar un archivo about.html que facilite información sobre el conector en cuestión.  Dicha información se visualiza cuando el usuario solicita detalles de la característica o del conector y selecciona una característica o un conector concreto.

La característica primaria también suministra información y gráficos del producto global.  Se emplean archivos adicionales para especificar esta información.

Imágenes de las ventanas

Puede utilizarse una imagen en color de 16x16 pixels para identificar las ventanas creadas por el producto.  Aparecerá en la esquina superior izquierda de las ventanas del producto.  Se especifica en el atributo windowImage del archivo about.ini.  La vía de acceso se debe especificar como relativa al conector.  A continuación se indica cómo sería una entrada para la estructura de directorios anterior:

windowImage=acme.gif

Página de bienvenida

La descripción de la página de bienvenida del producto se debe definir en un archivo xml cuyo formato sea el descrito en el tema Configuración de la página de bienvenida de la plataforma.  Se especifica en el atributo welcomePage del archivo about.ini. La vía de acceso se debe especificar como relativa al conector.  A continuación se indica cómo sería una entrada para la estructura de directorios anterior:

welcomePage=welcome.xml

También es posible especificar una búsqueda en idioma nacional para el archivo.  (En el tema Archivos específicos del entorno local hallará más detalles).

welcomePage=$nl$/welcome.xml

Pantallas de inicio

La pantalla de inicio del producto se suministra en un archivo splash.bmp situado en el directorio del conector de la característica primaria.   La imagen se debe suministrar con un formato BMP en color de 24 bits (formato RGB) y un tamaño aproximado de 500x330 pixels.  Si las pantallas de inicio se tuvieran que personalizar para distintos entornos locales, se podrían colocar en un fragmento del conector de la característica primaria.

Valores por omisión de las preferencias

Se utiliza el archivo plugin_customization.ini para establecer los valores por omisión de las preferencias definidas por otros conectores.  Este archivo tiene el formato de los archivos java.io.Properties. Normalmente, este archivo sirve para establecer los valores de las preferencias que se publican como parte de la API pública de un conector. Es decir, se expone a un riesgo si hace referencia a preferencias empleadas por los conectores, pero que no estén definidas formalmente en la API.  

Una personalización habitual consiste en establecer la perspectiva por omisión del entorno de trabajo.  Esta preferencia se define en el conector org.eclipse.ui.   En el siguiente ejemplo se presupone que el producto debe lanzarse de tal manera que la perspectiva por omisión sea la de recursos.

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

Si se da cuenta de que tiene que cambiar el valor por omisión de una de las preferencias de otro conector, consulte la documentación de la API de ese conector para ver si la preferencia se considera pública.

En el archivo plugin_customization.properties están las series traducidas del archivo plugin_customization.ini.

Copyright IBM Corporation y otros 2000, 2003.