Exemplo: Gravando um fragmento em alemão para o Plug-in XYZ

Os assistentes e editores PDE que manipulam plug-ins e fragmentos são quase iguais.  No entanto, você deve estar ciente de algumas diferenças importantes.

Iniciamos criando um novo projeto de fragmento.  

Na primeira página do assistente Novo Projeto de Fragmento, digite o nome do projeto "com.example.german".  Aceite os valores padrão e pressione Avançar.

A página Conteúdo do Fragmento possui três campos adicionais do assistente de criação do plug-in: ID de plug-in do host, versão de plug-in pai e regra de correspondência da versão.

Como estamos gravando um fragmento para um plug-in específico, podemos utilizar o botão Navegar para selecionar "com.example.xyz" no diálogo de seleção do plug-in. Utilizando o diálogo, poderíamos também ter escolhido qualquer plug-in externo.

Exemplo de Fragmento - Página de Conteúdo de Fragmento de Amostra

Uma vez que o projeto é criado, ele abre o editor de manifesto de fragmento.

Exemplo de Fragmento - Visão Geral do Manifesto

Ao contrário de um plug-in, um fragmento não possui uma classe de plug-in pois segue o ciclo de vida de seu plug-in do host.

Incluiremos um conjunto de ações semelhantes como no exemplo do plug-in, mas desta vez, em alemão.

  1. Vá para a página Extensão no editor manifest do fragmento. Pressione Incluir, para lançar o assistente Extensão.
  2. Selecione "org.eclipse.ui.actionSets" na lista de pontos de extensão. PressioneConcluir.
  3. Selecione o novo conjunto de ação. Selecione Novo->actionSet no menu pop-up.
  4. Na seção Detalhes do Elemento de Extensão, altere a propriedade etiqueta para "Deutsche Aktionsmenge."
  5. Na seção Todas as Extensões, clique com o botão direito no novo conjunto de ação e selecione Novo->menu a partir do menu pop-up.
  6. Altere a propriedade de etiqueta do menu para "Beispiel Menu" e a propriedade do id para "beispielMenu."
  7. Selecione o elemento do menu novamente e escolha Novo->separador no menu pop-up. Altere seu nome para "beispielGruppe" e salve.
  8. Crie um novo elemento de "ação" (similar à etapa 6). Defina a propriedade da etiqueta para "Beispiel Aktion." Defina menubarPath para "beispielMenu/beispielGruppe."
  9. Clique no hyperlink da propriedade classe para gerar uma nova classe para a ação. Utilize "com.example.german/src" como sua pasta de origem e deixe o nome do pacote em branco (utilize o pacote padrão). Altere o nome da classe para "DeutscheBeispielAktion". PressioneConcluir.
  10. Quando o editor Java com a nova classe é aberto, localize o método "executar" e inclua o seguinte:

    System.out.println("Hallo, PDE welt!");

  11. Salve e feche o editor de Java e o editor de manifest do fragmento.

Quando você executa o fragmento utilizando o botão "Executar" da barra de ferramentas, a instância da plataforma de tempo de execução deve ter a ação "Deutsche Aktionsmenge" definida como disponível.  (Utilize Janela->Personalizar Perspectiva...->Outro para ir para a lista de conjuntos de ações). Quando você ativar o conjunto de ações, o menu "Menu Beispiel " deverá aparecer na barra de ferramentas. Ao selecionar seu item de menu, você deverá ver "Hallo, PDE welt!" no Console. A plataforma do tempo de execução não consultou o fragmento Alemão diretamente. Em vez disso, seu registro de plug-in resolveu as referências ao fragmento de maneira que o conjunto de ações do fragmento aparecesse para a plataforma como se tivesse vindo diretamente do Plug-in XYZ.