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