﻿Sphero Tutorial Installation
############################

Dieses Archiv enthält die Klassen "BallRollenActivity.java" und "SensorDatenActivity.java". Diese können jeweils in einem Android Projekt eingebunden werden. Die folgenden Schritte zur Installation werden auch in der Getting Started Anleitung (englisch) von Orbotix beschrieben (https://github.com/orbotix/Sphero-Android-SDK)

1) Erstellen des Android Projektes in Eclipse:
Um die Klassen in einem Android Projekt in Eclipse einzubinden und auszuführen ist es zunächst notwendig das Android SDK (http://developer.android.com/sdk/index.html) und das ADT Plugin für Eclipse (http://developer.android.com/tools/sdk/eclipse-adt.html) zu installieren. Dann kann ein neues Android Projekt erstellt werden. (Hinweis: Das Sphero Android SDK benötigt mindestens Android in der Version 2.2)

2) Einbinden des Sphero Android SDK:
Das Sphero Android SDK (https://github.com/orbotix/Sphero-Android-SDK) herunterladen und von den entpackten Daten den Ordner "libs" in den vorher erstellten Projektordner kopieren. Daraufhin wird in den Projekteigenschaften, unter "Java Build Path" die "RoboLibrary.jar" aus dem kopierten "libs" Ordner referenziert.
Die "RoboUILibrary" wird von Orbotix als eigener Projektordner bereitgestellt, der über die Import Funktion von Eclipse in den Workspace aufgenommen wird. In den Projekteigenschaften der "RoboUILibrary" wird, wie zuvor im Android Projekt, die "RoboLibrary.jar" zum "Java Build Path" hinzugefügt. In den Projekteigenschaften des Android Projektes kann daraufhin, unter dem Menupunkt "Android", das "RoboUILibrary" Projekt referenziert werden. 
Damit stehen die Funktionen der Sphero Android API zur Verfügung.

3) Einbinden der Beispielklassen:
Zuletzt kann nun die vorhandene Activity Klasse des Android Projektes durch den Inhalt der "BallRollenActivity.java", bzw. "SensorDatenActivity.java" Klasse ersetzt werden.

Für die Ausgabe der Daten des SensorDaten Beispiels auf der GUI ist es noch notwendig einige "Textviews" (acc_x,acc_y,acc_z gyr_x,gyr_y, gyr_z, sowie pitchValue, rollValue, yawValue) in der Datei "res/layout/main.xml" anzulegen. Dorthin werden die ausgelesenen Daten zur Laufzeit geschrieben.


