Personalizar um produto

São vários os aspectos personalizáveis de um produto como, por exemplo, ecrã de boas-vindas, texto da caixa de diálogo Acerca, ícones de janela, etc. A maioria destas personalizações está definida no contributo para o ponto de extensão org.eclipse.core.runtime.products.

Vejamos como são definidos os elementos personalizáveis mais comuns.

Caixa de diálogos Acerca

A caixa de diálogo "acerca de" da plataforma é mostrado sempre que o utilizador seleccionar Ajuda> Acerca de no menu da área de trabalho.  

caixa de diálogo Acerca

A parte superior da caixa de diálogo Acerca mostra informações a nível do produto, ao passo que a parte inferior pormenoriza as funções (se as houver) e os plug-ins instalados.  Os detalhes das funções (ou a marca, digamos) são fornecidos com os ficheiros about.ini, about.properties e about.html no plug-in associado à função.  Estas informações são apresentadas quando o utilizador solicita detalhes de função e selecciona determinada função.

A marca do produto (metade superior da caixa de diálogo) é especificada pelas propriedades de extensão que descrevem o texto e as imagens mostradas nesta caixa de diálogo. Por exemplo, o extracto seguinte da declaração do produto Plataforma Eclipse.

	<property
		name="aboutText"
		value="%aboutText"/>
	<property
		name="aboutImage"
		value="icons/eclipse_lg.png"/>
	</product>

Consulte IProductConstants para mais informações sobre estas propriedades.

Imagens de janelas

Pode ser utilizada uma imagem com cores de 16x16 pixéis para criar a marca de janelas criadas pelo utilizador.  Aparece no canto superior esquerdo das janelas do produto.  Está especificada no atributo windowImage na definição da extensão do produto. Em alternativa, pode ser usado o atributo windowImages para descrever uma matriz de imagens de diferentes tamanhos que deva ser utilizada no canto superior esquerdo.

	<property
		name="windowImages"
		value="icons/eclipse.png,icons/eclipse32.png"/>

A propriedade windowImages sobrepõe-se à propriedade windowImage se ambas forem especificadas.

Página de boas-vindas

Os produtos que utilizem o mecanismo da página de boas-vindas do Eclipse 2.1 podem especificar nome e localização do respectivo ficheiro de página de boas-vindas na propriedade welcomePage.

	<property
		name="welcomePage"
		value="$nl$/welcome.xml"/>

O uso desta propriedade é desencorajado em benefício do ponto de extensão org.eclipse.ui.intro. Consulte Bem-vindo/Suporte de Introdução para mais detalhes sobre os novos mecanismos de boas-vindas/introdução.

Predefinições de preferências

A propriedade preferenceCustomization pode ser utilizada para especificar um ficheiro que contenha valores predefinidos de preferências para o produto.

	<property
		name="preferenceCustomization"
		value="plugin_customization.ini"/>

Este ficheiro é do formato java.io.Properties. Regra geral, este ficheiro é utilizado para definir valores para preferências que sejam publicadas como parte da API pública de um plug-in.  Significa isto que se corre o risco de remeter para preferências que sejam utilizadas por plug-ins mas não estejam definidas formalmente na API.  

Ecrãs de boas-vindas

O ecrã de boas-vindas do produto está especificado em config.ini, o qual se encontra abaixo do directório de configuração do produto. A propriedade osgi.splashPath property neste ficheiro descreve lugares onde pesquisar um ficheiro chamado splash.bmp. A propriedade osgi.splashLocation identifica um caminho exacto e completo para o ficheiro de ecrã de boas-vindas a utilizar. Ao especificar um caminho de boas-vindas permite-se a utilização de ecrãs de boas-vindas específicos a locales, dado que o caminho de pesquisa pode indicar vários plug-ins ou fragmentos a pesquisar, bem como caminhos de estilo $nl$. Consulte o ficheiro config.ini do SDK da plataforma para uma descrição completa das propriedades que se podem configurar neste ficheiro. A imagem deve ser fornecida em formato BMP com cores de 24 bits (formato RGB) e deve ter aproximadamente 500x330 pixéis de tamanho.

A localização, o tamanho e a cor da barra de progresso e a mensagem de progresso apresentados no ecrã de boas-vindas durante o arranque podem ser configurados através da utilização das propriedades startupProgressRect, startupMessageRect e startupForegroundColor. Consulte IProductConstants para mais informações sobre estas propriedades. Repare que, por predefinição, não será reportado nenhum progresso no arranque. Para activar o relatório de progresso do arranque, defina a seguinte preferência como true, por exemplo, no ficheiro de personalização de preferências: IWorkbenchPreferenceConstants.SHOW_PROGRESS_ON_STARTUP