Plug-in de Arquivos JAR Existentes
O assistente Plug-in de arquivos JAR existentes está
disponível
em
Ficheiro
> Novo > Projecto... > Desenvolvimento de Plug-ins > Plug-in de
arquivos JAR existentes no menu de nível superior.
A criação de um projecto de plug-ins para arquivos de JAR existentes envolve um processo constituído por dois passos:
Selecção de JAR
A página do assistente Selecção de JAR enumera os arquivos de JAR a ser incluídos no plug-in.
O botão Adicionar... abre uma caixa de diálogo que permite procurar arquivos de JAR no espaço de trabalho.
O botão Adicionar Externo... abre uma caixa de diálogo de ficheiro que permite procurar arquivos de JAR no sistema de ficheiros.
Propriedades do plug-in
A página do assistente Propriedades do Plug-in permite-lhe especificar as definições do projecto de plug-ins, as propriedades do plug-in e a plataforma de destino.
Recomenda-se a utilização da convenção de nomenclatura inversa do domínio (por exemplo, com.example.bundle) para o nome do projecto.
O campo Localização especifica a localização predefinida do projecto como sendo um subdirectório imbricado na localização do espaço de trabalho. A localização do projecto pode ser alterada para qualquer localização gravável ao desmarcar a caixa de verificação Utilizar localização predefinida e ao introduzir a localização pretendida.
Um ID de Plug-in é obrigatório e tem de estar em conformidade com o plugin.dtd. É recomendado - apesar de não ser obrigatório - que o ID do plug-in corresponda ao nome do projecto.
Uma Versão de Plug-in é obrigatória e tem de estar no formato major.minor.service (por exemplo, 1.3.0).
Um Nome de Plug-in é o nome de apresentação traduzível do plug-in. Este campo é necessário.
Um Fornecedor de Plug-in é o nome traduzível do fornecedor de plug-in. Este campo é opcional.
Plataforma de Destino
As opções da Plataforma de Destino deverão ser um pré-filtro que determina quais as páginas do editor de manifesto que deverão estar visíveis durante a criação do novo projecto de plug-ins.
Por exemplo, as páginas Extensões e Pontos de Extensão estarão visíveis se for seleccionada a opção Versão do Eclipse, mas estarão ocultados se for seleccionada a opção enquadramento OSGi.
Do mesmo modo, a secção Visibilidade do Pacote na página Tempo de Execução do editor de manifesto será ocultada se a opção do enquadramento OSGi padrão estiver seleccionada, uma vez que esta secção faculta ferramentas específicas de Equinox.
Descompactar JARs
A opção de compactar ou descompactar JARs depende da forma como pretende empacotar o plug-in. Se o plug-in for enviado como um JAR único - que é o formato recomendado a partir da versão 3.1 do Eclipse - os arquivos de JAR individuais deverão ser descompactados. Se o plug-in for enviado como directório simples, os arquivos de JAR individuais deverão permanecer intactos.