| 1. |
Für jede Roboterimplementierung wird im CVS - Modul
JRoboSim - Components ein neues Verzeichnis angelegt.
Dieses sollte die folgende Struktur aufweisen:
JRoboSim
- Components |
Wurzelverzeichnis = Name des CVS Moduls. |
+ -- robots |
Enthält die Roboter für JRoboSim.
Für jede Roboterimplementierung wird ein neues Verzeichnis
unterhalb von robots angelegt. |
+ -- mynewrobot |
Eindeutiger Name für den neuen Roboter |
+ -- build |
Dateien die beim Kompilieren des Roboters
erzeugt werden. Nicht mit ins CVS übertragen! |
+ -- dist |
Enthält die jeweils letzte stabile
Version des Roboters gepackt als *.jar Archiv. (siehe
Punkt 3) |
+ -- src |
Quellcode der Roboterimplementierung. |
+ -- build.xml |
ANT buildfile zum Übersetzen der
Quelldateien und zum Erzeugen der Distribution.
Tipp: Kopiere das buildfile einer vorhandenen
Roboterimplementierung und passe nur Projektnamen und
Pfadangaben an. |
|
| 2. |
Erstellen einer neuen Klasse, die entweder von
de.htwdd.robotic.simulation.plugin.AbstractPlugin abgeleitet
wird, oder das Interface de.htwdd.robotic.simulation.plugin.IPlugin
implementiert. Überschreiben der benötigten Methoden.
Weitere Informationen zum Interface IPlugin und der Basisklasse
AbstractPlugin können der javadoc des Projekts entnommen
werden. |
| 3. |
Packen aller Klassen der Roboterimplementierung und aller
benötigter Ressourcen (Bilder, Textdateien usw.) in ein
JAR-File. In das JAR-File muss außerdem der "Service",
der von diesem Jar bereitgestellt wird definiert werden:
In das Jar-File wird ein Verzeichnis META-INF/services eingefügt.
In diesem Verzeichnis wird eine Textdatei angelegt, die den
Namen des implementierten Interfaces erhält (de.htwdd.robotic.simulation.world.robot.IRobot).
In diese Datei werden alle Klassen dieser Jar-Datei eingetragen,
die dieses Interface implementieren. Daraus folgt, dass auch
mehrere Roboterimplementationen in ein Jar-Archiv gepackt
werden können, es müssen nur alle Implementierungen
in die dazugehörige Textdatei eingetragen werden.
Das Kompilieren und Erzeugen der jar-Datei kann auch automatisch
durch Ausführen des ant - buildfiles durchgeführt
werden.
|
| 4. |
Die fertige Roboterimplementierung wird veröffentlicht,
indem das Jar-Archiv aus JRoboSim - Components/mynewtestrobot/dist
nach JRoboSim - Components/dist/robots kopiert
wird. Dies kann auch automatisch durch Aufruf von JRoboSim
- Components/build.xml erfolgen.
|