O plug-in associado a um recurso principal é onde as informações sobre marcas de um produto são especificadas. Há vários aspectos personalizáveis de um produto. As personalizações no nível do produto são definidas utilizando o arquivo about.ini e outros arquivos descritos a esse respeito. Os produtos também podem controlar os valores de preferência padrão de outros plug-ins. Isso é feito utilizando 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 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. Ela é 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 bem-vindo 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. (Consulte Arquivos específicos do locale para obter detalhes adicionais.)
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 500 x 330 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. Este é um arquivo de 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.
Uma personalização comum é definir a perspectiva padrão para o workbench. Essa preferência é definida no plug-in org.eclipse.ui. O seguinte exemplo assume que o produto deve ser ativado 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.