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