{"id":116,"date":"2007-08-16T19:16:21","date_gmt":"2007-08-16T18:16:21","guid":{"rendered":"http:\/\/www.sahits.ch\/blog\/?p=116"},"modified":"2017-12-24T21:42:29","modified_gmt":"2017-12-24T20:42:29","slug":"eclipse-wizard-plugin-erstellen","status":"publish","type":"post","link":"http:\/\/sahits.ch\/blog\/blog\/2007\/08\/16\/eclipse-wizard-plugin-erstellen\/","title":{"rendered":"Eclipse Wizard Plugin erstellen"},"content":{"rendered":"

Eclipse stellt bereits einen Wizard zur Verf\u00fcgung, um eine Wizard zu erstellen: \u00dcber New->Plug-in Development->Plug-in Project<\/strong> ein neues Projekt anlegen. Auf der Folgeseite habe ich dann als Target Eclipse (in Version 3.3) angegeben; das OSGi Framework habe ich nicht ganz durchschaut, jedenfalls war mein fertiges Plug-in dann nicht kompatibel. new Plugin step 3 of 5<\/a>
\nAuf der 3 Seite sind dann die Eckdaten zu vergeben: Plug-in ID \u00fcblicherweise der package name, Version ist selbsterkl\u00e4rend, der Plug-in Name hat nur bezeichnenden Charakter, sollte aber sprechend ausdr\u00fccken, wof\u00fcr das Plug-in steht. Der Plug-in Provider ist \u00fcblicherweise ein Teil der Webadresse z.B. eclipse.org, ibm.com oder sahits.ch. Der Activator wird ben\u00f6tigt, um das Plug-in zu aktivieren.
\nnew Plugin step 4 of 5<\/a>
\nAuf der folgenden Seite kann zwischen den verschiedenen Plug-ins ausgew\u00e4hlt werden. F\u00fcr einen Wizard ben\u00f6tigen wir ein „Plug-in with multi-page editor“; Mit Editor ist letztentlich die Grafische Oberfl\u00e4che des Wizards gemeint wo die Eingaben gemacht werden, wie auf gerade dieser Schritt. Multi-page besagt lediglich, dass der Wizard aus mehreren Schritten bestehen kann, aber nicht muss.
\nAuf den beiden letzten Seiten werden dann die Informationen f\u00fcr die zu erstellenden Klassen gemacht.
\nNach dem Abschluss hat man bereits ein funktionsf\u00e4higes Plug-in. Um es auszutesten w\u00e4hlt man das Projekt an und Run As->Eclipse Application<\/strong>. Dies startet eine zweite Eclipse Instanz mit eigenem Workspace (ein Workspace kann gleichzeitig nur von einer Eclipse Instanz benutzt werden). Hier kann der Wizard \u00fcber New->Other->Other<\/strong> gestartet werden.
\nNun geht es daran, den Wizard mit eigenem Code zu f\u00e4llen. Ein guter Einstiegspunkt ist Eclipse Plugins Exposed, Part 1: A First Glimpse<\/a>
\nHat man die eigene Funktionalit\u00e4t integriert gibt es noch etwas Sch\u00f6nheitspflege zu machen:<\/p>\n

    \n
  1. Wo in der Liste soll der Wizard erscheinen? Dies wird im plugin.xml im attribut category<\/em> des tags wizard<\/em> geregelt. Keine Angabe verfrachtet das Element in den Ordner other. Ein String bringt es in einem Ordner mit diesem Namen unter. Aber Achtung: Wenn bereits ein Ordner mit demselben Namen existiert, gibt aller Wahrscheinlichkeit nach einen zweiten Ordner. Soll der Wizard in einem anderen Ordner erscheinen ist hier die Klasse des Wizards einzutragen.Plugin.xml<\/a><\/li>\n
  2. Das Plug-in soll ja nicht nur einer Eclipse Instanz verf\u00fcgbar sein, sondern beim Starten verf\u00fcgbar sein. Dazu muss das Plug-in in das Verzeichnis eclipse\/plugins. Dies jedoch nicht in der Form, wie im Projekt. F\u00fcr das Plug-in wird das plugin.xml, ein jar-File der Klassen, das Verzeichnis icons und eventuell das Verzeichnis icons, zus\u00e4tzlich ben\u00f6tigte Bibliotheken und andere Resourcen ben\u00f6tigt.
    \nDies gibt man im Plug-in oder Manifest Editor im Tab Build ein.
    \n    Plugin.xml Build<\/a>
    \nUnter Runtime Information gibt man den Namen des jar files an, das erstellt werden soll. In Binary Build wird angegeben, was alles im Build enthalten sein soll. Unter Extra Classpath Entries werden zus\u00e4tzliche Bibliotheken angegeben.
    \nUm den aktuellen Build auszuf\u00fchren gibt es mehrere M\u00f6glichkeiten: 1. \u00dcber Export->Plug-in Development->Deployable plugins and features<\/strong>. Dies erstellt jedoch nur ein jar-file der Klassen mit dem angegebenen Namen in einem plugins Verzeichnis. 2. Wertvoller aber auch nicht ganz optimal ist der Weg \u00fcber ein Ant build script. Um das build.xml zu erhalten muss das plugin.xml angew\u00e4hlt sein, dann PDE Tools->Create Ant Build File<\/strong>. Dann kann zuerst das Default Target ausgef\u00fchrt werden, um das jar-File zu erhalten, sodann das target zip.plugin was ein Zip-Archiv des Ordners plugin-ID_Version erstellt und alles unter Binary Build angegebene enth\u00e4lt. Leider aber zus\u00e4tzlich zwei Zip-Files mit den Sourcen und das Verzeichnis bin. (Dies gilt zumindest f\u00fcr Eclipse 3.3). Also muss hier von Hand aussortiert werden.<\/li>\n<\/ol>\n
    \n

    Das Ganze ist nicht ganz ohne deshalb hier noch ein paar Tipps:<\/p>\n