2.1 Installation

 
GuiBuilder wurde als Plug-in unter Eclipse realisiert. Bevor Sie also GuiBuilder installieren können, brauchen Sie eine bestehende Eclipse-Installation. Die Eclipse Version muss dabei 3.0 oder neuer sein. Zum Zeitpunkt der Erstellung dieses Handbuchs ist die neueste erhältliche Version 3.1.

Desweiteren wird das sogenannte Graphical Editor Framework (GEF) benötigt. Dabei handelt es sich um ein weiteres Plug-in für Eclipse, von dem GuiBuilder abhängig ist. GEF wiederum benötigt zur Ausführung Draw2d, welches aber standardmäßig zusammen mit GEF installiert wird.

Figure 2.1: Graphical Editor Framework

 

Eclipse können Sie sich unter www.eclipse.org/downloads/ herunterladen. Zur Installation entpacken Sie Eclipse einfach in ein beliebiges Verzeichnis. Das GEF erhalten Sie unter download.eclipse.org/tools/gef/downloads. In diesem Archiv ist das benötigte Draw2d bereits enthalten. Zur Installation von GEF müssen Sie dieses einfach in Ihr Eclipse-Verzeichnis entpacken. Weiterführende Informationen zu Eclipse finden Sie unter www.eclipse.org.

Figure 2.2: GuiBuilder von der Update-Site installieren

 

Die Installation von GuiBuilder können Sie auf zwei verschiedene Arten vornehmen. Die bequemste und sicherste ist es, GuiBuilder mithilfe des Eclipse-eigenen Install/Update-Mechanismus zu installieren. Dazu müssen Sie den Menüpunkt Help $\to$ Software Updates $\to$ Find and Install... auswählen. Daraufhin öffnet sich ein mehrseitiger Dialog, indem Sie zuerst angeben müssen, ob Sie ein neues Feature installieren oder ein bereits installiertes Feature aktualisieren möchten. Sollte GuiBuilder also einmal installiert sein, so können Sie diesen Mechanismus auch dazu benutzen, um für GuiBuilder regelmäßig Updates herunterzuladen. Jetzt wollen Sie aber GuiBuilder erst einmal installieren. Also wählen Sie: Search for new features to install.

Als nächstes wird Ihnen eine Liste von Update-Sites präsentiert. Sie müssen jetzt, bevor Sie fortfahren können, eine neue Remote-Site hinzufügen. Dabei handelt es sich um eine URL, auf der der Install-Mechanismus nach neuen Inhalten (Features) für Eclipse suchen wird. Sie müssen also eine neue URL für die Remote Site hinzufügen und selektieren, damit GuiBuilder auch gefunden wird. Das i-3 Team bietet Ihnen GuiBuilder auf folgender Update-Site an: http://updates.i3team.de.

Nachdem Sie die neue Update-Site hinzugefügt und auch selektiert haben, werden Ihnen auf der nächsten Seite des Dialogs die dort gefundenen Features zur Installation angeboten. Darunter befindet sich auch der GuiBuilder (Abb. 2.2). Sie müssen diesen jetzt nur noch auswählen und Ihre Selektion durch ein paar Next- und Finish-Buttons bestätigen. Der GuiBuilder wird dann automatisch für Sie installiert. Sie können dabei auch immer sicher sein, dass Sie die aktuellste Version von GuiBuilder installieren.

Die zweite Möglichkeit besteht darin, dass Sie eine .zip-Datei von GuiBuilder verwenden. Diese können Sie zum Beispiel auf der Homepage von GuiBuilder erhalten: http://www.i3team.de/projects/GuiBuilder/. Zur Installation müssen Sie diese lediglich in Ihr Eclipse-Installationsverzeichnis entpacken und Eclipse neu starten.

Figure 2.3: Dialog zu Details der Plug-ins

 

Um festzustellen, ob GuiBuilder korrekt installiert und erkannt wurde, können Sie im Menüpunkt Help $\to$ About Eclipse Platform $\to$ Plug-in Details nachschauen. Dort sollte ein Eintrag für den Provider i-3 existieren, mit dem Plug-in Namen GuiBuilder (Abb. 2.3). Oft ist es auch notwendig, Eclipse nach einer Plug-in Installation mit dem Parameter -clean zu starten (also: eclipse -clean), um die interne Registrierung neu aufzubauen. Ab Version 3.1 sollte dies aber nicht mehr nötig sein.

GuiBuilder wird standardmäßig in englischer Sprache angeboten. Es wird allerdings auch eine deutsche Sprachdatei mitgeliefert, so dass Sie auch auf diese Sprache wechseln können. In weiteren Releases können weitere Sprachen hinzukommen. Um die Sprache zu wechseln, müssen Sie die Datei plugin.properties durch eine ihrer Entsprechungen plugin.properties_de oder plugin.properties_en ersetzen. Diese Dateien befinden sich in Ihrem Eclipse-Verzeichnis unter plugins/de.upb.guibuild.plugin_1.0.0. Die Versionsnummer am Ende des Verzeichnisnamens unterscheidet sich dabei natürlich von Version zu Version.