Einrichtung Entwicklerstation

Diese Seite beschreibt die Einrichtung des Entwicklerarbeitsplatzes. Grundsätzlich ist dies eine Möglichkeit von vielen anderen, eine Arbeitsumgebung einzurichten. Manche Schritte und Programme sind obligatorisch , andere können durch vergleichbare Komponenten substituiert werden (z.B. Windows - Linux, Eclipse - IntelliJ) und sind optional . Weitere haben sich die Benutzung einiger Tools und Einstellungen als nützlich erwiesen, sie stellen Empfehlungen dar. Hiermit soll die Integration neuer Teammitgleider erleichtert und die Einarbeitungszeit bei Weiterentwicklung des Projekts verkürzt werden.

Obligatorische Einstellungen

Die folgende Installationsanleitung setzt eine lauffähige Installation des Betriebssystems Windows XP voraus. Betriebsystemspezifisch notwendige Software (z.B. Anti-Viren-Programm) wird nicht aufgeführt.

Installation des JDK 1.6

  1. Download des SDK (nicht lediglich die JRE) von Sun
  2. Standardmäßige Installation ohne Veränderung der Vorgabewerte.
  3. Anlegen der System-Umgebungsvariable JAVA_HOME
  4. Erweitern der System-Umgebungsvariable PATH um %JAVA_HOME%\bin

Installation von Maven2

  1. Download von ASF
  2. Entpacken von Maven 2.0.9 nach c:\programme\maven\2.0.9
  3. Anlegen der System-Umgebungsvariable MAVEN_HOME
  4. Erweitern der System-Umgebungsvariable PATH um %MAVEN_HOME%\bin
  5. Die Umgebungsvariable MAVEN_OPTS muss auf "-Xmx1024m" gesetzt werden.
  6. Die Buildumgebung soll die Projektdoku automatisch erstellen, was die Erstellung der JavaDoc-Seiten beinhaltet. Damit die JavaDoc maximalen Nutzen bietet, soll sie auf jeder Seite das Klassendiagramm der aktuellen Klasse (mit Umgebungsklassen) in graphischer Form enthalten. Dieses Diagramm wird von GraphViz erstellt, eine Anwendung, die installiert werden muss, um später mvn:site aufrufen zu können.
    1. Installieren von GraphViz nach c:\programme\graphviz\<version> (Achtung: die Version wieder als extra Unterverzeichnis anlegen, der gesamte Pfad darf keine Leerzeichen enthalten. It's JAVA.).
    2. Anlegen der System-Umgebungsvariable GRAPHVIZ_HOME, die auf die Installation zeigt.
    3. Hinzufügen von %GRAPHVIZ_HOME%\bin zu PATH.
  7. Während $ mvn site durchgeführt wird, muss ein Zugang zum Repository bestehen um z.B. die Change Log Reports zu erstellen. Unter Windows muss dafür zusätzlich ein SVN-Client installiert werden, z.B. von CollabNet.

Installieren von Apache Axis2

  1. Apache Axis2 wird als Standard Binary Distribution herunter geladen und in ein beliebiges Verzeichnis (z.B. C:\Programme\Axis2\1.4.1) entpackt. Praktisch ist es auch hier, der Version ein eigenes Verzeichnis zu spendieren.
  2. Anlegen der System-Umgebungsvariable AXIS2_HOME.
  3. Erweitern der System-Umgebungsvariable PATH um %AXIS2_HOME%\bin.
  4. Anpassen der Konfiguration %AXIS2_HOME%\conf\axis2.xml:
    • password ändern, damit niemand unbemerkt einen ungewünschten Webservice in unseren Container deployen kann.
    • hotupdate auf true ändern, damit der Container während der Entwicklung neue Klassen automatisch erkennt.

Optionale Einstellungen

Die Beschreibung in diesem Abschnitt bezieht sich generell auf die Verwendung der Eclipse IDE und die damit verbundenen Eclipse-spezifischen Einstellungen.

Eclipse einrichten

  1. Entpacken von Eclipse 4.3 EE nach C:\programme\eclipse.
  2. Einstellung der Zeichenkodierung UTF-8 in Eclipse (General -> Workspace).
  3. Alle Code-Convention-Konfigurationen importieren.
  4. Eclipse-Plugins AnyEdit und Checkstyle installieren.

Mylyn

„Mylyn extends the Eclipse SDK with sophisticated mechanisms for keeping track of tasks. A task is any unit of work that you want to recall or share with others, such as a user-reported bug or a note to yourself about improving a feature.“
Quelle: IBM

Damit Mylyn aus der Eclipse-Entwicklungsumgebung heraus funktioniert, haben wir bereits einen Connector heruntergeladen und installiert, der die lokal installierte Entwicklungsumgebung an ein Task Repository anbinden kann. Wir werden in unserem Projekt den Bugzilla-Connector verwenden, es gibt aber noch einige andere, zum Beispiel den kommerziellen JIRA-Connector.

Die Vorgehensweise, um euer Eclipse an das Task Repository anzudocken, das wir schon alle mit einem Webbrowser ausgiebig getestet haben, ist im Folgenden dargestellt.

  1. Zunächst startet man Eclipse.
  2. Nun klickt man mit rechter Maustaste auf das gewünschte Projekt und es erscheint ein Kontextmenü; hier kommt man über New > Other > Task zum Dialog für das Erstellen von neuen Aufgaben (siehe Abbildung).
  3. Soll eine neue Aufgabe angelegt werden, so muss in dem erscheinenden Dialog der Punkt „Tasks“ ausgewählt und anschließend der Button „Next“ betätigt werden(siehe folgende Abbildung).
  4. Um ein bestehendes entferntes Task Repository an die eigene Entwicklungsumgebung anzubinden, wird daraufhin der Button „Add Task Repository“ betätigt (siehe Abbildung).
  5. Nachdem Bugzilla als einziger verfügbarer Connector ausgewählt wird, müssen die Adresse des Servers und die Zugangsdaten zum Task Repository eingegeben werden (siehe Abbildung).
  6. Um die Eingaben auf Richtigkeit zu überprüfen, kann vor der Beendigung des Dialogs der Button „Validate Settings“ betätigt werden.
  7. Nachdem das entfernte Task Repository angebunden ist, können Aufgaben und Bugs direkt aus der lokalen Eclipse-Installation angelegt und verwaltet werden.

Nützliche Links: Mylyn 2.0, Part 1: Integrated task management und Mylyn FAQ - Eclipse Wiki

Empfehlungen

Nach oben