Personalizar una característica primaria

La personalización de productos funciona de forma diferente cuando se utiliza el mecanismo de característica primaria. La información de sello personal de la característica se encuentra en un conector identificado por la característica primaria (o en el conector del mismo nombre que la característica primaria, si no se especifica ninguno). Los archivos que designan y definen la información de sello personal de la aplicación hipotética acmeweb están resaltados en la siguiente estructura de directorios de ejemplo:

acmeweb/
	acmeweb.exe	(ejecutable del producto - invoca a eclipse.exe y
especifica la característica primaria)
	eclipse/
		.eclipseproduct
		eclipse.exe
		startup.jar
		install.ini
		.config/
		platform.cfg
		jre/
		features/
			com.example.acme.acmefeature_1.0.0/    (característica primaria)
				feature.xml
		plugins/
			com.example.acme.acmefeature_1.0.0/    (conector de la característica primaria. Contiene información de sello personal.)
				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/
			...

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.png
		plugin_customization.ini
		plugin_customization.properties
		splash.bmp
		welcome.xml

Revisaremos la misma personalización que hemos revisado para el punto de extensión de productos, centrándonos en la divergencia de la especificación cuando se utiliza el mecanismo de característica primaria.

Diálogos Acerca de

Como se ha descrito en la personalización a nivel de producto, todas las características y conectores deben aportar un archivo about.html que facilite información sobre el conector en cuestión.

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

Página Bienvenida

Los conectores que utilicen los mecanismos de bienvenida de Eclipse 2.1 deben especificar el archivo de página de bienvenida 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.  El formato de este archivo es de tipo 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.