Esempio: scrittura di un frammento Tedesco per il plug-in XYZ

Gli editor e le procedure guidate PDE che modificano i plug-in e i frammenti sono pressappoco simili.  Tuttavia, è bene avere presente alcune importanti differenze.

Si comincerà creando un nuovo progetto di frammento.  

Sulla prima pagina della procedura guidata Nuovo frammento, immettere il nome del progetto "com.example.german."  Premere Avanti e accettare i valori predefiniti presenti sulla seconda pagina.  Quindi, premere nuovamente Avanti.  Sulla pagina "Generatori di codice del frammento", scegliere il pulsante di opzione per la creazione di un frammento da un modello e selezionare la procedura guidata "Generatore di frammento predefinito".  Dopo aver premuto Avanti, verrà visualizzata la pagina "Contenuto di frammento semplice".

Questa pagina differisce in parte rispetto alla procedura guidata dei plug-in poiché contiene due ulteriori campi: id e versione del plug-in di destinazione. Dato che si sta scrivendo un frammento per un plug-in specifico, è possibile utilizzare il pulsante Sfoglia per selezionare "Plug-in XYZ" dal gruppo "Plug-in dell'area di lavoro" (è anche possibile scegliere uno qualsiasi dei plug-in esterni).

Una volta creato il progetto, viene aperto l'editor del manifest del frammento.

Questo editor è abbastanza simile all'editor del manifest di plug-in, ad eccezione di quanto riportato di seguito:

  1. Nella pagina Panoramica, l'attributo "class" non è più presente.  I frammenti non hanno una classe di plug-in poiché seguono il ciclo di vita del rispettivo plug-in di destinazione.  Invece, vengono visualizzati i campi dell'id e della versione del plug-in di destinazione.

  2. Non è presente la pagina Dipendenze.  Se si seleziona il progetto di frammento e si sceglie Proprietà > Percorso di build, si vedrà che il frammento presenta un percorso di build identico al plug-in di destinazione.

Verrà aggiunta una serie di azioni simili a quanto effettuato nell'esempio di plug-in, ma questa volta in tedesco.

  1. Aprire  la pagina Estensioni dell'editor del manifest del frammento. Premere Nuova per avviare la procedura guidata Estensione.
  2. Selezionare "Procedure guidate generiche" e "Estensione basata su schema". Premere Avanti
  3. Selezionare "Serie di azioni" dall'elenco dei punti di estensione. Fare clic su Fine.
  4. Selezionare la nuova serie di azioni. Selezionare Nuovo > actionSet dal menu di scelta rapida.
  5. Passare al foglio delle proprietà e modificare la proprietà label in "Deutsche Aktionsmenge."
  6. Passare alla sezione "Elementi secondari dell'estensione" e selezionare Nuovo > menu dal menu di scelta rapida.
  7. Modificare la proprietà label del menu in "Beispiel Menu" e la proprietà id in "beispielMenu."
  8. Selezionare nuovamente l'elemento menu e scegliere Nuovo > separatore dal menu di scelta rapida. Modificarne il nome nelle proprietà in "beispielGruppe" e salvarlo.
  9. Creare un nuovo elemento "action" (come al passo 6). Impostare la proprietà label su "Beispiel Aktion." Impostare menubarPath su "beispielMenu/beispielGruppe."
  10. Selezionare per la modifica la proprietà class e visualizzare la finestra dell'editor di cella. Selezionare il pulsante di opzione "Genera una nuova classe".
  11. Ricercare il contenitore di classe e selezionare la cartella "GERMAN Fragment" nel progetto "com.example.german".
  12. Cambiare il nome della classe in "DeutscheBeispielAktion". Fare clic su Fine.
  13. Quando viene aperto l'editor Java con la nuova classe, localizzare il metodo "run" e aggiungere quanto segue:

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

Salvare e chiudere l'editor Java e l'editor del manifest del frammento.

Quando si esegue il frammento utilizzando il pulsante "Esegui" della barra degli strumenti, l'istanza della piattaforma run-time deve avere la serie di azioni "Deutsche Aktionsmenge" disponibile.  Utilizzare Prospettiva > Personalizza... > Altro per richiamare l'elenco delle serie di azioni. Quando si attiva la serie di azioni, il menu "Beispiel Menu" deve apparire sulla barra degli strumenti. Quando si seleziona la relativa voce di menu, "Hallo, PDE welt!" dovrebbe essere visibile nella Console. La piattaforma run-time non visualizzava direttamente il frammento Tedesco. Diversamente, il registro di plug-in ha risolto i riferimenti del frammento in modo che la serie di azioni del frammento venga visualizzata nella piattaforma come se provenisse direttamente dal plug-in XYZ.