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:

  1. Seleccionar os arquivos de JAR
  2. Especificar as propriedades do plug-in

 

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.

Selecção de JAR

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.

Conteúdo do Plug-in

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.