@@ -3,9 +3,57 @@ Im Folgenden wird eine Möglichkeit beschrieben, das AuD-Paket, Graphviz und Bat
Konkrete Hilfestellung gibt es in den Tutorien.
## 1. AuD-Paket zu Eclipse hinzufügen
Das von Dr. Christian Rössl erstellte AuD-Paket enthält in Vorlesung und Übung verwendete Java-Klassen und andere Utensilien. Es wird mit Vorlesungsfortschritt erweitert und sollte zur Nutzung entsprechend regelmäßig aktualisiert werden.
Es [hier](http://vccourses.cs.uni-magdeburg.de/course/aud16/wikis/home) direkt herunterzuladen. Es gibt weiterhin ein [Git-Repository](http://vccourses.cs.uni-magdeburg.de/course/aud15).
Es [hier](http://vccourses.cs.uni-magdeburg.de/course/aud16/wikis/home) direkt herunterzuladen. Es gibt weiterhin ein [Git-Repository](http://vccourses.cs.uni-magdeburg.de/course/aud16).
Die ZIP-Datei entpacken. Nun den Unterordner `aud` aus dem Dateisystem in den Quellordner (Standard: `src`) des Zielprojektes in Eclipse ziehen und `Copy files and folders` wählen.
Alternativ kann die `aud.jar` als externe Bibliothek in das Java Projekt eingebunden werden (analog zur `batik.jar` weiter unten). Allerdings kann dann nicht direkt der Java-Quelltext der Dateien eingesehen werden, weshalb obere Methode sinnvoller ist.
## 2. Graphviz systemweit installieren
Mit Graphviz lassen sich mit einer [einfachen Eingabesprache](https://en.wikipedia.org/wiki/DOT_(graph_description_language)) Graphen generieren und in verschiedenen Formaten (z. B. PDF, JPG, SVG) zur grafischen Darstellung exportieren.
Executable Packages für entsprechendes System [herunterladen](http://www.graphviz.org/Download..php) und installieren.
Damit das Programm gefunden wird, sollten die Standardpfade und Ordner bei der Installation NICHT verändert werden!
## 3. Batik in Eclipse einbinden
Batik dient zur Manipulation und Darstellung von SVG-Dateien (z. B. von Graphviz generierte Graphen) in Java.
Batik for JRE 1.4+ [herunterladen](http://apache.openmirror.de/xmlgraphics/batik/binaries/batik-bin-1.8.zip).
**Mac OS und Linux**: Zip-Datei im Terminal mit den zwei Befehlen
```bash
cd /path/to/folder/containing/batik-zip-file # entsprechenden Ordner hier ersetzen
jar xvf batik-bin-1.8.zip
```
entpacken.
**Windows**: Zip-Datei gewöhnlich entpacken.
In Eclipse dem Menüpfad `Project -> Properties -> Java Build Path -> Libraries -> Add External JARs` folgen und `batik.jar` im entpackten Ordner `batik-1.8` auswählen.
## 4. JUnit in Eclipse einbinden
Das AuD-Paket enthält Testklassen, zu deren Ausführung die JUnit-Bibliothek notwendig ist. Möglichst einfach lässt sie sich hinzufügen, indem man zum Beispiel `aud.test.DListTest.java` öffnet und in der Quelldatei zur Lösung des Fehlers bei einer `@Test`-Anweisung `Add JUnit 4 library to the build path` wählt.
In Eclipse die Datei `aud/util/SingleStepperDemo.java` öffnen und ausführen. Es sollten keine Kompilierungs- oder Laufzeitfehler auftreten. Ist alles korrekt eingerichtet, öffnen sich zwei Fenster, mit denen sich eine Beispielliste schrittweise visualisieren lässt.
Es handelt es sich hierbei um eine Liste, die ausgehend von der Java-Implementierung im AuD-Paket in das Graphviz-Format transformiert, von dort aus als SVG-Datei gespeichert und diese schließlich von Batik in einem Fenster grafisch dargestellt wird. Mit der Klasse `aud.util.SingleStepper` wird dieser Prozess schrittweise über den Lebenszyklus der Liste wiederholt.
## 6. Sonstiges
Die Zip-Datei entpacken. Nun den Unterodner aud aus dem Dateisystem in den Quellordner (Standard: src) des Zielprojekts in Eclipse ziehen und Copy files and folders wählen.
Falls als Fehler noch `The method 'xy' must override a superclass method` angezeigt wird, kann dies daran liegen, dass das falsche Compiler-Compilance-Level ausgewählt ist (1.5 oder niedriger). In diesem Fall muss unter `Project -> Properties -> Java Compiler` ein Level höher als 1.5 ausgewählt werden.
