Personalizando um Produto

O plug-in associado a um recurso principal é onde as informações de marca de um produto são especificadas.  Existem muitos aspectos personalizáveis de um produto.  As personalizações em nível de produto são definidas com o arquivo about.ini e outros arquivos descritos nesse sentido.  Os produtos também podem controlar os valores de preferência padrão de outros plug-ins.  Isso é feito com o arquivo plugin_customization.ini.

Referindo-se mais uma vez a nosso exemplo de plug-in do recurso principal do produto, vamos observar mais detalhadamente como o produto é personalizado.

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 Sobre

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

O diálogo Sobre é construído com as informações fornecidas pelos recursos e plug-ins.  Todos os recursos e plug-ins devem contribuir com um arquivo about.html que fornece informações sobre esse plug-in específico.  Essas informações são exibidas quando o usuário solicita detalhes do recurso ou do plug-in e seleciona um determinado recurso ou plug-in.

O recurso principal também fornece as informações e gráficos para o produto como um todo.  São utilizados arquivos adicionais para especificar essas informações.

Imagens da Janela

Uma imagem em cores com 16x16 pixels pode ser utilizada para marcar janelas criadas pelo produto.  Ela aparecerá no canto esquerdo superior das janelas de produto.  É especificada no atributo windowImage no arquivo about.ini.  O caminho deve ser especificado como um caminho relativo ao plug-in.  Uma entrada apropriada para a estrutura de diretórios mostrada acima seria a seguinte:

windowImage=acme.gif

Página Bem-vindo

A descrição da página de boas-vindas do produto deve ser definida em um arquivo xml no formato descrito em Configuração da Página Bem-vindo da Plataforma.  Ela é especificada no atributo welcomePage no arquivo about.ini. O caminho deve ser especificado como um caminho relativo ao plug-in.  Uma entrada apropriada para a estrutura de diretórios mostrada acima seria a seguinte:

welcomePage=welcome.xml

Também é possível especificar uma pesquisa de idioma nacional para o arquivo.  (Cosulte Arquivos específicos do locale para obter mais detalhes.)

welcomePage=$nl$/welcome.xml

Telas Iniciais

A tela inicial do produto é fornecida em um arquivo splash.bmp localizado no diretório de plug-in do recurso principal.  A imagem deve ser fornecida no formato BMP em cores de 24 bits (formato RGB) e deve ter aproximadamente 500x330 pixels de tamanho.  Se as telas iniciais precisarem ser personalizadas para locales diferentes, elas poderão ser colocadas em um fragmento do plug-in do recurso principal.

Padrões de Preferências

O arquivo plugin_customization.ini é utilizado para definir os valores de preferência padrão para as preferências definidas por outros plug-ins.  O formato deste arquivo é 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.  

Uma personalização comum é definir a perspectiva padrão para o workbench.  Esta preferência é definida no plug-in org.eclipse.ui.   O seguinte exemplo assume que o produto deve ser lançado com a perspectiva do recurso como a padrão.

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

Se você descobrir que é necessário alterar o valor padrão de uma das preferências de outro plug-in, consulte a documentação da API desse plug-in para ver se a preferência é considerada pública.

O arquivo plugin_customization.properties contém cadeias convertidas do arquivo plugin_customization.ini.

Copyright IBM Corp. e outros 2000,2002.