Debugging

Spätestens wenn du das erste Event in deinem Projekt erstellt hast, solltest du darüber nachdenken dein Projekt zu testen. Hierzu benötigst du ein Gerät auf dem World of Adventures installiert ist.

Starte die World of Adventures-App auf deinem Gerät und öffne die Optionen. Aktiviere dort die Einstellung "Entwicklermodus" und bestätige anschließend mit "ja". Im Hauptmenü der App erscheint nun der neue Menüpunkt "Debug".

Das Debugging-Menu in der App

Im Debugging-Menü siehst du eine Übersicht über alle zum Debugging übertragenen Dateien. Außerdem kannst du hier Debugging-Cheats aufrufen.

Übertragen von Dateien

Dateien lassen sich auf zwei verschiedene Arten zwischen IDE und App übertragen: Die einfachere Variante überträgt die Dateien über das Internet. Stelle hierzu sicher, dass du in der App und der IDE mit dem selben Benutzerkonto eingeloggt bist. Stelle außerdem sicher, dass in der IDE unter Testen → Verbindungsart die Verbindungsart Internet ausgewählt ist und, dass der Entwicklermodus in der App -wie oben beschrieben- aktiviert ist. Anschließend kannst du dein Projekt unter Testen → Gerät synchronisieren oder mit dem Tastaturkürzel F8 an die App übertragen.

Die zweite Möglichkeit zur Datenübertragung funktioniert per USB-Kabel und die Android Debugging Bridge (adb). Wähle hierzu in der IDE Testen → Verbindungsart die Verbindungsart USB-Kabel und folge den Anweisungen. Da für diese Verbindung die Android Debugging Bridge installiert und per Kommandozeile gestartet werden muss, ist es normalerweise einfacher, die Dateiübertragung über das Internet zu wählen. Hat man jedoch keine funktionierende Internetverbindung zur Verfügung, bietet die Verbindung per USB-Kabel eine mögliche Alternative.

Dateien testen

Die übertragenen Dateien können in der App unter "Debug" angesehen und getestet werden. Außerdem erscheinen übertragene Events und Gebiete ganz normal auf der Karte und können dort genutzt werden.

Für die unterschiedlichen Dateiarten stehen außerdem jeweils eigene Debugging-Tools bereit. So können beispielsweise Gegenstände zum Inventar hinzugefügt werden und Quests angenommmen, aufgelöst oder auf bestimmte Stati gesetzt werden.

Einzelschritt-Debugging & Variablen-Monitor

Speziell für Events stehen außerdem ein Schritt-für-Schritt-Debugger und ein Variablen-Monitor bereit.

Für den Schritt-für-Schritt-Debugger lassen sich im Event-Graphen durch Rechtsklick auf eine Aktion Haltepunkte setzen, an denen die Event-Ausführung angehalten wird. Die Ausführung des Events lässt sich dann per Testen→Schritt darüber (F11) bis zur nächsten Aktion oder durch Testen→Weiter ausführen (F12) bis zum nächsten Haltepunkt fortsetzen.

Der Variablen-Monitor kann über das Debugging-Menü in der unteren Menüleiste der IDE aufgerufen werden. Hier lassen sich mithilfe des "+"-Buttons Variablen definieren, deren aktueller Wert während der Eventausführung in Echtzeit angezeigt und aktualisiert wird. Durch Doppelklick auf den Wert einer Variable, lässt sich dieser auch direkt aus der IDE heraus editieren.