Die Installation von GeneSEZ kann einiges an zeitlichen Aufwand verursachen, daher sollte die Intention vorher festgelegt werden:
Änderungen am GeneSEZ Metamodell
Änderungen an Templates und Skripten zur Quellcodegenerierung, die nicht sinnvoll mit XPand AOP durchgeführt werden können
Treffen die beiden Punkte nicht zu, genügt die Installation des GeneSEZ Plug-Ins. Trifft nur der letzte Punkt zu, kann durch Nutzung des Metamodells aus dem GeneSEZ Plug-In einiges an Aufwand eingespart werden. Treffen beide Punkte zu sollte GeneSEZ komplett in dem Workspace liegen.
Für eine Installation von GeneSEZ in ein vorhandenes Eclipse mit dem Eclipse Update Manager die notwendigen Features der Eclipse Plug-Ins unter Section 2.4 sowie das GeneSEZ Eclipse Plug-In installieren.
Bei GeneSEZ Eclipse Distributionen des GeneSEZ Build Servers ab Eclipse Version 3.4 wird das dropins Verzeichnis genutzt. Das GeneSEZ Plug-In befindet sich im Verzeichnis dropins/genesez und die für GeneSEZ notwendigen Plug-Ins im Ordner dropins/prerequisites. Soll GeneSEZ in ein vorhandenes Eclipse ab Version 3.4 installiert werden, können einfach diese beiden Verzeichnisse in das dropins Verzeichnis der jeweiligen Eclipse kopiert werden. (Die Namen der Verzeichnisse genesez und prerequisites können natürlich beliebig umbenannt werden!).
Voraussetzung hierfür ist die Installation des GeneSEZ Plug-Ins. Zusätzlich werden die gewünschten Plattform-Projekte (alle Plug-In Projekte mit de.genesez.platforms im Namen) aus dem GeneSEZ Repository ausgecheckt. Ist das Ziel Java Quellcode, betrifft es das Projekt de.genesez.platforms.java und optional das Projekt de.genesez.platforms.common.
Wichtig ist hierbei die Wahl einer passenden Version der Plattform-Projekte zum GeneSEZ Plug-In. Daher sollten Tag oder Branch-Versionen genutzt werden.
Bei dieser Art der Installation ist GeneSEZ komplett als Quellcode im Workspace vorhanden. Dazu müssen die folgenden Schritte ausgeführt werden.
Checkout der benötigten GeneSEZ Eclipse Plug-In Projekte aus dem GeneSEZ Repository (Tag oder Branch-Versionen sollten bevorzugt werden)
Konfiguration von Verzeichnispfaden, siehe Section 2.2.3.1
Erstellung der GeneSEZ Metamodell-Implementierung, siehe Section 2.2.3.2
Im Projekt de.genesez.build im Ordner build muss die Datei environment.properties angelegt werden. Hierzu kann die Datei environment.properties.template als Vorlage genutzt werden, welche sich im selben Verzeichnis befindet. Die folgenden Eigenschaften sind obligatorisch:
spezifiziert das eclipse home directory, d.h. dort wo eclipse.exe bzw. eclipse als ausführbare Datei liegt
spezifiziert das MagicDraw home directory, d.h. das Verzeichnis wo MagicDraw installiert oder entpackt wurde
Die anderen Eigenschaften können ignoriert werden und nicht nicht notwendig, um das Metamodell zu erstellen.
Die Generierung der Implementierung des GeneSEZ-Metamodells erfolgt mit Hilfe von EMF. Dazu muss das Build-Skript build.xml im build-Ordner des Metamodell-Projektes de.genesez.metamodel ausgeführt werden. Zum Ausführen den Menüpunkt Run As » Ant Build... wählen und im Tab JRE den Punkt Run in same JRE as the workspace wählen.
Hinweis: Zeigt die Umgebungsvariable JAVA_HOME auf eine JRE und nicht auf einen JDK, können die ANT Skripte nicht ausgeführt werden, da diese den Java Compiler aufrufen.
Nachdem die Metamodell-Implementierung generiert wurde, sollte sich das GeneSEZ-Framework genauso nutzen lassen, wie wenn die Plug-Ins installiert worden wären.