Quelltext der Seite Tutorials/BlueJ

{{DISPLAYTITLE:Tutorial: Einbinden der Engine in BlueJ}}<!--

-->== Ziel des Tutorials ==

Nach diesem Tutorial hast du BlueJ für die Entwicklung mit der Engine Alpha eingerichtet.


== Voraussetzung: Download ==

Du musst bereits eine Version der Engine Alpha heruntergeladen haben. Falls dies noch nicht der Fall ist, findest du die Engine im [[Download|Download-Bereich]]. Die Datei heißt ungefähr <code>Engine.Alpha.jar</code>.

== Einbinden in BlueJ ==

Es gibt 2 Methoden, die Engine einzubinden. Die eine Methode ermöglicht dauerhaftes Einbinden. Die andere Methode muss bzw. kann für jedes Projekt spezifisch wiederholt werden, was z.B. das Einbinden verschiedener Versionen für unterschiedliche Projekte ermöglicht.


=== Dauerhaftes Einbinden ===

Führe die folgenden Schritte aus, um die Engine dauerhaft in BlueJ einzubinden. So musst du nicht bei jedem neuen Projekt das Einbinden wiederholen:

# Klicke auf ''Werkzeuge &rarr; Einstellungen''.<div class="hm10">[[Datei:tutorial bluej mainwindow.png|200px]]</div>
# Klicke auf ''Bibliotheken &rarr; Hinzufügen'' und wähle dann die Engine aus, die du heruntergeladen hast (<code>Engine.Alpha.jar</code>).<div class="hm10">[[Datei:tutorial bluej libraries.png|200px]]</div>

<div class="hinweisInfo">
Falls du diese Methode verwendet hast, kannst du den folgenden Teil überspringen und direkt zum [[#Test: Hat's funktioniert?|letzten Teil des Tutorials]] springen.
</div>


=== Projektspezifisches Einbinden ===

Führe die folgenden Schritte bei jedem Projekt aus, um die Engine spezifisch in eben dieses Projekt einzubinden:

# Gehe in den Projektordner deines BlueJ-Projekts (erstelle dazu ggf. ein neues, wenn du möchtest)
# Erstelle einen Ordner mit dem Namen <code>+libs</code><div class="hm10">[[Datei:tutorial bluej createfolder.png|200px]]</div>
# Kopiere bzw. speichere die Engine (<code>Engine.Alpha.jar</code>) in <code>+libs</code>.<div class="hm10">[[Datei:tutorial bluej embedjar.png|200px]]</div>


== Test: Hat's funktioniert? ==

Wenn du bis hierhin alles geschafft hast, sollte die Engine in deinem Projekt jetzt funktionieren. Hier kannst du das schnell und einfach testen:


=== Importieren der Engine ===

Um die Engine Alpha in Deine Klassen einzubinden, musst Du nun noch zu Beginn deines Quelltextes (noch vor der Klassendeklaration!) die folgende Zeile schreiben:

<source>
import ea.*;

class MeineKlasse {
    //Rumpf...
}
</source>

Diese Zeile "importiert" alle Funktionen der Engine Alpha in den Quelltext, sodass Du sie verwenden kannst. Dies ist das "ea"-Paket. In (fast) allen Programmiersprachen, werden Funktionen in solchen Pakten (bzw. ''Modulen'') abgelegt. Auch in Java kann die Engine Alpha es so für sich nutzen. Wenn Du
verstehen willst, wie das Paketsystem funktioniert, schau Dir auch die Standard-Java-Pakete (das JDK) einmal an, als Stichwort das Paket <code>java.util</code>.


=== Zurücksetzen der Virtuellen Maschine ===

Nach dem Hinzufügen von neuen Bibliotheken ist es nötig, die Virtuelle Maschine zurückzusetzen. Dies geht über ''Werkzeuge &rarr; Java Virtuelle Maschine zurücksetzen'' bzw. <code>Strg + Umschalt + R</code>.


=== Fehlermeldung: Package does not exist ===

Falls du bei der <code>import</code>-Anweisung die Fehlermeldung <code>package ea does not exist</code> erhältst, hat das Einbinden leider nicht richtig funktioniert. Wiederhole das Einbinden und versuche ggf. die alternative Einbindungsmöglichkeit. Sollte es immernoch Schwierigkeiten geben, melde dich gerne bei uns und [[Feedback|beschreibe dein Problem!]].