Benutzer-Werkzeuge

Webseiten-Werkzeuge


develop:eclipse

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
develop:eclipse [d.m.Y H:i] mainzdevelop:eclipse [d.m.Y H:i] (aktuell) – [Jameica per git importieren] willuhn
Zeile 1: Zeile 1:
-===== Jameica in Eclipse einrichten =====+====== Jameica in Eclipse einrichten ======
  
  
-==== Einleitung ====+===== Einleitung =====
  
 Die folgende Anleitung beschreibt, wie du Jameica innerhalb der [[http://www.eclipse.org|Eclipse Entwicklungsumgebung]] einrichten kannst. Die folgende Anleitung beschreibt, wie du Jameica innerhalb der [[http://www.eclipse.org|Eclipse Entwicklungsumgebung]] einrichten kannst.
  
  
-=== Eclipse installieren ===+===== Eclipse installieren =====
  
-Eine aktuelle Version der Eclipse-Entwicklungsumgebung (SDK) für Java findest du auf [[http://www.eclipse.org/downloads/]].+Eine aktuelle Version der Eclipse-Entwicklungsumgebung (SDK) für Java findest du auf [[http://www.eclipse.org/downloads/]]
  
 +===== Jameica per git importieren =====
 +Diese Beschreibung basiert auf Eclipse "Mars": Wähle eine Version für "Java Developer" incl. Git aus.
  
-=== Jameica und das Beispiel-Plugin herunterladen und importieren ===+  * Starte Eclipse und öffne den "Package Explorer" 
 +  * starte mit einem Rechtsklick der Maus den "Import" 
 +  * Wähle aus unter Punkt "Git" -> "Projects from Git" 
 +  * Wähle "Clone URI" aus 
 +  * Gib das Jameica Repository ein: [[https://github.com/willuhn/jameica]] 
 +  * Als nächstes nur die benötigten Branches aktivieren (üblicherweise master und origin) 
 +  * Dann den Zielort auf deinem System eingeben... 
 +  * Den Dialog bestätigen, dann wird auch schon heruntergeladen... 
 +  * Dann noch "Eclipse-Projekte in diesem Pfad suchen ausführen, voila - dann sollte es als Eclipse-Projekt vorhanden sein. 
 + 
 +Weitere Eclipse-Projekte sind unter https://github.com/willuhn/ zu finden... 
 + 
 +Zum Erstellen der ausführbaren Programme werden folgende Repositories benötigt: 
 + 
 +  * https://github.com/willuhn/jameica 
 +  * https://github.com/willuhn/hibiscus 
 + 
 +Die folgenden Repositories sind optional, da die daraus erzeugten JAR-Dateien bereits in o.g. Hibiscus-Repository (im Ordner "lib") enthalten sind: 
 + 
 +  * https://github.com/hbci4j/hbci4java 
 +  * http://git.code.sf.net/p/obantoo/obantoo 
 + 
 +BTW: Bei Verwendung von [[https://projects.eclipse.org/projects/tools.oomph|Eclipse Oomph]] kann alternativ auch folgende Oomph-Setup-URI zur Einrichtung verwendet werden: 
 + 
 +  * https://raw.githubusercontent.com/willuhn/hibiscus/master/Hibiscus.setup 
 + 
 +===== Jameica und das Beispiel-Plugin herunterladen und importieren =====
  
   * Lade dir den Quellcode der aktuellsten Version (Nightly Build) von [[http://www.willuhn.de/projects/jameica/?page=download_ext|Jameica]] sowie das [[http://www.willuhn.de/projects/jameica/?page=download_ext|Beispiel-Plugin]] herunter und speichere die ZIP-Archive in einem beliebigen Verzeichnis.    * Lade dir den Quellcode der aktuellsten Version (Nightly Build) von [[http://www.willuhn.de/projects/jameica/?page=download_ext|Jameica]] sowie das [[http://www.willuhn.de/projects/jameica/?page=download_ext|Beispiel-Plugin]] herunter und speichere die ZIP-Archive in einem beliebigen Verzeichnis. 
Zeile 28: Zeile 56:
 {{develop:03.png|}} {{develop:03.png|}}
  
 +Das Bild zeigt noch einen älteren Stand. In der Zwischenzeit hat sich die Namensgebung geändert und das Beispielprojekt heißt jameica.example.
  
-=== Classpath anpassen ===+ 
 +===== Classpath anpassen =====
  
   * Wenn du nicht mit Linux sondern mit Windows oder MacOS arbeitest, muss noch der Classpath zur Datei "swt.jar" für dein Betriebssystem ausgewählt werden. Klicke hierzu mit der rechten Maustaste auf das Projekt "jameica" und wähle "Properties" (ganz unten). Klicke links auf "Java Build Path" und aktiviere anschließend rechts den Reiter "Libraries"   * Wenn du nicht mit Linux sondern mit Windows oder MacOS arbeitest, muss noch der Classpath zur Datei "swt.jar" für dein Betriebssystem ausgewählt werden. Klicke hierzu mit der rechten Maustaste auf das Projekt "jameica" und wähle "Properties" (ganz unten). Klicke links auf "Java Build Path" und aktiviere anschließend rechts den Reiter "Libraries"
Zeile 35: Zeile 65:
 {{develop:04.png|}} {{develop:04.png|}}
  
-  * Wähle die Datei "swt.jar" aus und klicke auf den Button "Edit...". Wechsle in das Verzeichnis "jameica/lib/swt" und suche dort die passende "swt.jar" für dein Betriebssystem aus. +  * Wähle die Datei "swt.jar" aus und klicke auf den Button "Edit...". Wechsle in das Verzeichnis "jameica/lib/swt" und suche dort die passende "swt.jar" für dein Betriebssystem aus. Achte darauf, die Datei "swt.jar" auch unter "Order and Export" wieder zu aktivieren, damit die SWT-Klassen auch in den Plugin-Projekten verfügbar sind
  
 {{develop:05.png|}} {{develop:05.png|}}
Zeile 41: Zeile 71:
  
  
-=== Launch-Konfiguration anlegen ===+===== Launch-Konfiguration anlegen =====
  
 Um Jameica innerhalb des Eclipse-Debuggers zu starten, lege eine neue Launch-Konfiguration über das Hauptmenü "Run»Debug..." an. Sollte dieser Menüpunkt nicht existieren, vergewissere dich, dass die "Debug"-Perspektive aktiviert ist. Öffne diese ggf. manuell über "Window»Open Perspective»Other...". Wähle nun linker Hand die Art der Launch-Konfiguration "Java Application" und drücke den Button "New" um eine neue Konfiguration anzulegen. Gib folgende Eigenschaften ein:  Um Jameica innerhalb des Eclipse-Debuggers zu starten, lege eine neue Launch-Konfiguration über das Hauptmenü "Run»Debug..." an. Sollte dieser Menüpunkt nicht existieren, vergewissere dich, dass die "Debug"-Perspektive aktiviert ist. Öffne diese ggf. manuell über "Window»Open Perspective»Other...". Wähle nun linker Hand die Art der Launch-Konfiguration "Java Application" und drücke den Button "New" um eine neue Konfiguration anzulegen. Gib folgende Eigenschaften ein: 
Zeile 50: Zeile 80:
 | [Arguments] Program arguments           | Linux: -f /home/<username>/jameica.test \\ Win32: -f "C:/Dokumente und Einstellungen/<username>/jameica.test" \\ MacOS: -f /Users/<username>/jameica.test | | [Arguments] Program arguments           | Linux: -f /home/<username>/jameica.test \\ Win32: -f "C:/Dokumente und Einstellungen/<username>/jameica.test" \\ MacOS: -f /Users/<username>/jameica.test |
  
-Mit dem Parameter "-f" kann ein abweichendes Arbeitsverzeichnis für Jameica angegeben werden, um zu vermeiden, dass die Einstellungen deiner produktiven Hibiscus/Jameica-Installation geladen werden. Gib niemals ein Arbeitsverzeichnis an, welches sich innerhalb des Eclipse-Projektes befindet. Jameicas Security-Manager verweigert das Schreiben von Dateien im Programm-Verzeichnis, um Manipulationen durch Plugins zu verhindern. Der Start von Jameica würde in diesem Fall mit einer "SecurityException" fehlschlagen. Zu Testzwecken kannst du einen zusätzlichen Parameter "-p <password>" verwenden, wenn du nicht bei jedem Start im Debugger das Master-Passwort eingeben möchtest. Alle anderen Parameter belassen Sie auf den Original-Einstellungen.+Mit dem Parameter "-f" kann ein abweichendes Arbeitsverzeichnis für Jameica angegeben werden, um zu vermeiden, dass die Einstellungen deiner produktiven Hibiscus/Jameica-Installation geladen werden. Gib niemals ein Arbeitsverzeichnis an, welches sich innerhalb des Eclipse-Projektes befindet. Jameicas Security-Manager verweigert das Schreiben von Dateien im Programm-Verzeichnis, um Manipulationen durch Plugins zu verhindern. Der Start von Jameica würde in diesem Fall mit einer "SecurityException" fehlschlagen. Zu Testzwecken kannst du einen zusätzlichen Parameter "-p <password>" verwenden, wenn du nicht bei jedem Start im Debugger das Master-Passwort eingeben möchtest. Alle anderen Parameter belässt du auf den Original-Einstellungen.
  
 {{develop:06.png|}} {{develop:06.png|}}
Zeile 59: Zeile 89:
  
  
-=== Erster Start ===+===== Erster Start =====
  
 {{develop:08.png|}} {{develop:08.png|}}
Zeile 73: Zeile 103:
  
   jameica.plugin.dir.0=../jameica.example   jameica.plugin.dir.0=../jameica.example
- 
-Als nächstes muss das Beispielprojekt so konfigurriert werden, dass die swt Library bekannt ist. Klicke hierzu mit der rechten Maustaste auf das Projekt "jameica.example" und wähle "Properties" (ganz unten). Klicke links auf "Java Build Path" und aktiviere anschließend rechts den Reiter "Libraries". Drücke den Button "Add JARs ..." und füge einen Verweis auf die swt.jar Datei des Projektes jameica ein, die auch oben für das jameica Projekt konfiguriert wurde. 
  
 Speichere die Datei ab und starte Jameica erneut in Eclipse. Beim Start-Vorgang durchsucht Jameica nun auch das Projekt-Verzeichnis des Beispiel-Plugins und wird im "bin"- Verzeichnis fündig (dort werden ja die Klassen des Plugins hinkompiliert). Du solltest nun ein Jameica-Fenster mit installiertem Beispiel-Plugin sehen.  Speichere die Datei ab und starte Jameica erneut in Eclipse. Beim Start-Vorgang durchsucht Jameica nun auch das Projekt-Verzeichnis des Beispiel-Plugins und wird im "bin"- Verzeichnis fündig (dort werden ja die Klassen des Plugins hinkompiliert). Du solltest nun ein Jameica-Fenster mit installiertem Beispiel-Plugin sehen. 
 +
 +Falls das Plugin-Projekt Compile-Fehler erzeugt, stelle sicher, dass die swt.jar im Jameica-Projekt in den Projekteinstellungen unter "Order & Export" aktiviert ist, damit das Plugin auf die SWT-Klassen zugreifen kann.
 +
  
 {{develop:09.png|}} {{develop:09.png|}}
Zeile 82: Zeile 113:
   * Fertig.   * Fertig.
  
-=== Wie weiter? ===+===== Wie weiter? =====
  
 Du kannst nun im Quellcode beliebig Breakpoints definieren und damit zeilenweise durch den Quellcode steppen oder ein eigenes Plugins nach analogem Aufbau zum Beispiel-Plugin erstellen. Du kannst nun im Quellcode beliebig Breakpoints definieren und damit zeilenweise durch den Quellcode steppen oder ein eigenes Plugins nach analogem Aufbau zum Beispiel-Plugin erstellen.
  
-Du kannst auch eine Release erzeugen, die ausserhalb von Eclipse benutzt werden kann. Klicke hierzu mit der rechten Maustaste auf die Datei "build/build.xml" eines Projektes und wähle "Run»2 Ant Build...". Klicke "Run" um das Erzeugen der Release zu starten. Ist das Script fehlerfrei durchgelaufen, klicke mit der rechten Maustaste im Navigator/Project Explorer auf das Projekt und wähle "Refresh" um die Anzeige zu aktualisieren. Du solltest nun ein zusätzliches Verzeichnis "release" sehen, in dem sich die erzeugte Release befindet. Hinweis: Lösche erstellte Releases bitte wieder, wenn sie nicht mehr benötigt werden. Denn ist das Projekt gleichzeitig auch in "de.willuhn.jameica.system.Config.properties" als Plugin-Verzeichnis registriert, würde Jameica beim nächsten Start nicht nur im "bin"-Verzeichnis das Plugin finden sondern jeweils auch in den Release-Verzeichnissen. Dies kann dazu führen, dass ein Plugin fälschlicherweise mehrfach geladen wird.+Du kannst auch ein Release erzeugen, das ausserhalb von Eclipse benutzt werden kann. Klicke hierzu mit der rechten Maustaste auf die Datei "build/build.xml" eines Projektes und wähle "Run As»Ant Build...". Deaktiviere das Target "all" und wähle stattdessen "fast". Klicke "Run" um das Erzeugen des Release zu starten. Ist das Script fehlerfrei durchgelaufen, klicke mit der rechten Maustaste im Navigator/Project Explorer auf das Projekt und wähle "Refresh" um die Anzeige zu aktualisieren. Du solltest nun ein zusätzliches Verzeichnis "releases" sehen, in dem sich das erzeugte Release befindet. Hinweis: Lösche erstellte Releases bitte wieder, wenn sie nicht mehr benötigt werden. Denn wenn der Eclipse-Projekt-Ordner gleichzeitig auch in "de.willuhn.jameica.system.Config.properties" als Plugin-Verzeichnis registriert ist, würde Jameica beim nächsten Start nicht nur im "bin"-Verzeichnis das Plugin finden sondern zusätzlich auch in den Release-Verzeichnissen. Dies kann dazu führen, dass ein Plugin fälschlicherweise mehrfach geladen wird. 
 + 
 +Aufruf von der Kommandozeile: 
 +Du kannst das Build-Script auch aus der Kommandozeile heraus aufrufen, wenn du [[http://ant.apache.org/|Apache ANT]] installiert hast. Das Build-Script muss hierbei aus dem Ordner "build" heraus aufgerufen werden (der Aufruf von "ant -f build/build.xml fast" wird fehlschlagen). 
 + 
 +  cd build 
 +  ant fast
  
 Hinweis:  Hinweis: 
-Das Skript build.xml geht davon aus, dass der Quellcode aus einem cvs-Repository ausgecheckt wurde und versucht daher auch, den Code zu taggen und einzuchecken. Dazu wird erwartet, dass das Kommandozeilenprogramm cvs verfügbar ist. Nachdem dass bei den meisten nicht der Fall sollte für Testzwecke der Quellcode in build.xml für die Targets cvs und cvstag auskommentiert werden, sonst bricht das Skript mit einer Fehlermeldung ab. Dies gilt sowohl für die build.xml Datei im Projekt jameica und auch im Projekt jameica.example.+Das Skript build.xml geht davon aus, dass der Quellcode aus dem GIT-Repository gecloned wurde und versucht daher per Default (im Target "all"), den Code zu taggen. Dazu wird erwartet, dass das Kommandozeilenprogramm git verfügbar ist und Schreibzugriff auf dem GIT-Repository existiert. Nachdem dass bei den meisten nicht der Fall sollte für Testzwecke das Target "fast" des Build-Scripts ausgeführt werdenDas überspringt das Taggen und erzeugt nur ein lokales Release. 
 + 


Impressum | Datenschutz
develop/eclipse.1290155286.txt.gz · Zuletzt geändert: d.m.Y H:i von mainz