Criar o projecto de plug-in

Poderá utilizar o IDE de Java que preferir para construir plug-ins Eclipse, mas claro que o SDK Eclipse proporciona ferramentas específicas para desenvolvimento de plug-ins. Vamos abordar os passos para construir o nosso plug-in com o SDK Eclipse, dado que este é o caso habitual. Se ainda não conhecer bem a área de trabalho Eclipse e o IDE de Java, consulte o manual Java Development User Guide ou PDE Guide para mais explicações sobre os passos que vamos tomar. Por agora concentramo-nos no código e não na ferramenta; todavia, existe alguma logística IDE para começar.

Criar o projecto de plug-in

É necessário criar um projecto que contenha o trabalho. Tiraremos partido de algumas das funções de geração de código do PDE (Plug-in Development Environment) para termos um modelo por onde começar. Isto estabelece o projecto para compor código Java e gerar os ficheiros de manifesto de plug-in predefinidos (explicação a seguir) e uma classe para manter a vista.

  1. Abra o assistente Novo Projecto... ( Ficheiro > Novo > Projecto...), escolha Projecto de Plug-in na categoria Desenvolvimento de Plug-ins e faça clique em Seguinte.
  2. Na página Projecto de Plug-in, utilize com.example.helloworld como nome para o projecto e marque a caixa junto de Criar projecto Java (deverá ser a predefinição). Deixe as outras definições da página na predefinição e depois faça clique em Seguinte para aceitar a estrutura de projecto de plug-in predefinida.
  3. Na página Conteúdo do Plug-in, observe as predefinições. O assistente define com.example.helloworld como ID do plug-in. O assistente gera também uma classe de plug-in para o plug-in em questão e permite que se facultem informações adicionais sobre contributos para a UI. Estas predefinições são aceitáveis, por isso faça clique em Seguinte.
  4. Na página Modelos, marque a caixa junto a Criar um plug-in com um dos modelos. Em seguida seleccione o modelo Plug-in com uma vista. Faça clique em Seguinte.
  5. Pretendemos criar um plug-in minimalista, por isso neste ponto precisamos de alterar as predefinições para manter tudo o mais simples possível. Na página Definições da Vista Principal, altere as predefinições sugeridas como se segue: Definições da vista do plug-in
  6. Na página Funções da Vista, desmarque todas as caixas de verificação para que não seja geradas funções extraordinárias para o plug-in. Faça clique em Terminar para criar o projecto e a estrutura do plug-in.
  7. Quando surgir a pergunta para mudar para a perspectiva Desenvolvimento de Plug-ins, responda Sim.
  8. Navegue até ao novo projecto e examine-lhe o conteúdo.

A estrutura do projecto inclui várias pastas, ficheiros e um pacote Java. Os ficheiros importantes nesta fase são plugin.xml e MANIFEST.MF (manifesto) e o código fonte Java para o plug-in. Começaremos pela implementação de uma vista e depois iremos aos ficheiros de manifesto.