Personalizando um Produto

Há muitos aspectos personalizáveis de um produto, como a tela inicial, o texto do diálogo sobre, ícones de janela, etc. A maioria dessas personalizações é definida na contribuição para o ponto de extensãoorg.eclipse.core.runtime.products.

Vamos ver como alguns dos elementos personalizáveis mais comuns são definidos.

Diálogos Sobre

O diálogo "sobre" da plataforma é mostrado sempre que o usuário seleciona Ajuda > Sobre no menu do workbench.  

Sobre Diálogo

A parte superior do diálogo sobre mostra informações em nível de produto enquanto a parte inferior detalha os recursos (se houver) e os plug-ins instalados.  Os detalhes do recurso (marca se desejar) são fornecidos utilizando os arquivos about.ini, about.properties e about.html no plug-in associado ao recurso.  Essas informações são exibidas quando o recurso de pedidos do usuário detalha e seleciona um recurso específico.

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

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

Consulte IProductConstants para obter informações adicionais sobre essas propriedades.

Imagens da Janela

Uma imagem colorida com 16 x 16 pixels pode ser utilizada para marcar as janelas criadas pelo produto.  Ela aparecerá no canto superior esquerdo das janelas do produto.  É especificada no atributo windowImage na definição de extensão dos produtos. Alternativamente, o atributo windowImages pode ser utilizado para descrever uma matriz de imagens de tamanhos diferentes que deve ser utilizada no canto superior esquerdo.

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

A propriedade windowImages substitui a propriedade windowImage se ambas estiverem especificadas.

Página Bem-vindo

Os produtos utilizando o mecanismo da página de boas-vindas do Eclipse 2.1 podem especificar o nome e o local do arquivo da página de boas-vindas na propriedade welcomePage.

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

A utilização dessa propriedade não é aconselhável no Eclipse 3.0 em favor do ponto de extensãoorg.eclipse.ui.intro. Consulte oSuporte à introdução para obter detalhes adicionais sobre os novos mecanismos de boas-vindas/introdução.

Padrões de Preferências

A propriedade preferenceCustomization pode ser utilizada para especificar um arquivo contendo os valores de preferência padrão para o produto.

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

Este arquivo é um arquivo do formato java.io.Properties. Normalmente, este arquivo é utilizado para definir os valores de preferências que são publicadas como parte da API pública de um plug-in.  Isto é, você estará se arriscando se referir-se a preferências que são utilizadas por plug-ins, mas não definidas formalmente na API.  

Telas Iniciais

A tela inicial do produto é especificada no config.ini que está localizado embaixo do diretório de configuração do produto. A propriedade osgi.splashPath neste arquivo descreve locais para procurar um arquivo chamado splash.bmp. A propriedade osgi.splashLocation identifica um caminho completo e exato para que o arquivo da tela inicial utilize. Especificar um caminho inicial permite que as telas iniciais específicas do código do idioma sejam utilizadas como o caminho de procura determinado pode indicar vários plug-ins ou fragmentos para procurar assim como caminhos de estilo de $nl$. Consulte o arquivo config.ini do SDK da plataforma para obter uma descrição completa das propriedades que podem ser configuradas neste arquivo. A imagem deve ser fornecida no formato BMP em cores de 24 bits (formato RGB) e deve ter aproximadamente 500x330 pixels de tamanho.