Android Apps. Mentoring SS 16. Nicolas Lehmann, Sönke Schmidt, Alexander Korzec, Diane Hanke, Toni Draßdo

Transkript

1 Android Apps Mentoring SS 16 Nicolas Lehmann, Sönke Schmidt, Alexander Korzec, Diane Hanke, Toni Draßdo Wichtige Dateien MainActivity.java activity_main.xml AndroidManifest.xml Die Dateien MainActivity.java, activity_main.xml und AndroidManifest.xml bilden den Kern eurer ersten Android App. Während die Datei MainActivity.java die Logik von eurem Programm und die Datei activity_main.xml das Layout enthält, könnt ihr in der AndroidManifest.xml Berechtigungen für eure Applikation festlegen. Kommentare zur Datei MainActivity.java Im Folgenden ist der Quelltext aus der Präsentation nochmal abgebildet mit zusätzlichen Kommentaren. Listing 1: Eingebundene Klassen 1 import android. content. Context; 2 import android. hardware. Sensor; 3 import android. hardware. SensorEvent; 4 import android. hardware. SensorEventListener; 5 import android. hardware. SensorManager; 6 import android. support.v7. app. AppCompatActivity; 7 import android.os. Bundle; 8 import android. view. View; 9 import android. widget. Button; 10 import android. widget. TextView; 11 import java. util. HashMap; 12 import java. util. Map; 13 import java. util. Random; 1

2 Weiter oben seht ihr die Klassen, die wir für unsere MentoringOne Applikation importiert haben. Um Pakete und Klassen zu importieren, verwenden wir das Schlüsselwort import. Zum Beispiel gehört die Klasse Sensor dem Paket android.hardware an. Das Paket mit dem Namen android enthält Android-spezifische Klassen und das Paket mit dem Namen java ist die sogenannte Standartbibliothek. Dort findet ihr zum Beispiel die Klasse Random mit der ihr Objekte erzeugen könnt, die euch Pseudozufallszahlen generieren oder auch die Klasse Map mit der ihr ein assoziatives Array erstellen könnt. Listing 2: Grundlegende Struktur 1 public class MainActivity extends AppCompatActivity implements SensorEventListener 2 { 4 protected void oncreate( Bundle savedinstancestate) 5 { 6 } 8 public void onsensorchanged( SensorEvent event) 9 { 10 } 12 protected void onpause() 13 { 14 } 16 protected void onresume() 17 { 18 } 20 public void onaccuracychanged( Sensor sensor, int accuracy) 21 { 22 } 23 } // eoc Nun seht ihr das Herzstück unserer Applikation, die sogenannte MainActivity Klasse. Diese findet ihr natürlich in der Datei MainActivity.java. Die Klasse MainActivity erbt von der Klasse AppCompatActivity und implementiert das Interface SensorEventListener. Das bedeutet im Endeffekt, dass eure MainActivity Klasse die Methoden onsensorchanged(sensorevent event) onaccuracychanged(sensor sensor, int accuracy) enthalten muss damit. Die Methoden oncreate(bundle savedinstancestate), onpause() und onresume() werden von der Klasse AppCompatActivity vererbt. Die Methode oncreate(bundle savedinstancestate) wird aufgerufen, wenn eure Applikation gestartet wird. Die Methoden onpause() und onresume() werden dann aufgerufen, wenn eure Aktivität nicht mehr sichtbar ist. Interessierte Leute finden unter dem folgenden Link mehr Informationen 2

3 Mit den Methoden onsensorchanged(sensorevent event) und onaccuracychanged(sensor sensor, int accuracy) könnt ihr auf Ereignisse von euren Sensoren reagieren. Ein Anwendungsbeispiel wird noch später ist eine sogenannte Annotation und ist für uns nicht weiter von Interesse. Listing 3: Einige Attribute 1 public class MainActivity extends AppCompatActivity implements SensorEventListener 2 { 4 // Felder 5 Map <Integer, String > m = new HashMap <Integer, String >(); // für Text 6 SensorManager snsmgr = null; // für Sensor 7 Sensor sns = null; // für Sensor } Zu sehen sind einige Attribute von unserer MainActivity Klasse. Mit dem assoziativen Array m vom Typen <Integer, String> können wir Strings einen Wert w { 2 31,..., } zuweisen. Für weiterführende Informationen siehe auch Eine Erklärung zum Zweierkomplement (wieso w aus dieser Menge kommt) findet man unter Die Objekte SensorManager snsmgr und Sensor sns brauchen wir später bei oncreate(bundle savedinstancestate). Listing 4: Initialisierung 2 protected void oncreate( Bundle savedinstancestate) 3 { 4 super. oncreate( savedinstancestate); 5 setcontentview(r. layout. activity_main); 6 snsmgr = ( SensorManager) getsystemservice( Context. SENSOR_SERVICE); 7 sns = snsmgr. getdefaultsensor( Sensor. TYPE_ACCELEROMETER); 8 this. snsmgr. registerlistener(this,sns, SensorManager. SENSOR_DELAY_NORMAL); 9 m.put(1, "Nico ist großartig!"); m.put(2, "Anja ist toll!"); 10 m. put(3, " HAlex ist theoretisch ganz gut!"); m. put(4, " Sönke ist spitze!"); 11 m. put(5, " Diane ist bald Lehrerin."); m. put(6, " Toni ist ein Rockstar."); 12 Button btn = ( Button) findviewbyid(r.id. btn1); // Erzeuge Knopf Ref. 13 final TextView tv = ( TextView) findviewbyid(r.id. txtv1); // Erzeuge Textview Ref. 14 btn. setonclicklistener( new View. OnClickListener() 15 { 17 public void onclick( View v) // v ist Referenz auf den Button 18 { 19 Random rnd = new Random(); 20 int random = rnd. nextint(6) +1; // random number between 0 and 5 3

4 21 tv. settext(m. get( random)); // setze Text neu in Textview 22 } 23 } 24 ); 25 } Erst jetzt kommt unser eigentliches Programm. Hier beschreiben wir, wie genau wir unsere Applikation initialisieren. Die Methode oncreate nimmt als Argument ein Objekt vom Typ Bundle. Mit diesem Objekt können zwischen verschiedenen Android Aktivitäten Daten übertragen werden. Für uns ist dies nicht weiter interessant. Mit dem Schlüsselwort super wird die Konstruktor-Methode der Oberklasse AppCompatActivity aufgerufen. Mit der Methode setcontentview(int view) lassen wir die Android Magie frei und initialisieren unsere view, damit erstmal ein schönes Fenster erscheint. Anschließend bereiten wir mit den nächsten drei Zeilen die Nutzung des Beschleunigungssensors vor. Das bedeutet bis jetzt haben wir eigentlich nur die grundlegendsten Sachen vorbereitet. In den darauf folgenden Zeilen generieren wir einige Datensätze und fügen sie in das assoziative Array m ein. Danach erstellen wir unser erstes Objekt, welches man tatsächlich anfassen kann, nämlich einen Button mit dem Bezeichner btn. Beim Button definieren wir mit setonclicklistener(new View.OnClickListener() das Verhalten bei verschiedenen Ereignissen. Was danach folgt ist eine sogenannte anonyme innere Klasse. Mit diesem Sprachkonstrukt vereinigen wir die Klassendeklaration und Objekterzeugung. Das erzeugte Objekt definiert mit onclick(view v) dann, was beim Drücken des Buttons btn passieren soll. In diesem Fall wird der String, welcher von der TextView tv anzeigt wird, aktualisiert mit einem String aus der Map m. Die Auswahl erfolgt zufällig über eine Pseudozufallszahl, die vom Objekt Random rnd generiert wird. Die Klasse Random findet man im Paket java.util. Listing 5: Nutzung des Beschleunigungsensors 2 public void onsensorchanged( SensorEvent event) { 4 // der Sensor aus ankommendem Event 5 Sensor sns2 = event. sensor; 6 // ist der Sensortyp, der, den wir suchen? 7 if( sns2. gettype() == Sensor. TYPE_ACCELEROMETER) 8 { 9 float x = event. values[0]; 10 float y = event. values[1]; 11 float z = event. values[2]; 12 final TextView tv = ( TextView) findviewbyid(r.id. txtv1); 13 tv. setx(tv. getx()-x); 14 } 15 } Dieser Quelltextabschnitt mit der Methode onsensorchanged(sensorevent event) beschreibt die Nutzung von Sensoren in unserer Applikation. Das Argument SensorEvent event enthält alle Informationen zu allen verfügbaren Sensoren. Das Attribut event.sensor vom Objekt event gibt uns an, welcher Sensor das Aufrufen der Methode onsensorchange(sensorevent event) verursacht hat. Ist es der Beschleunigungssensor, 4

5 dann lassen wir uns die genauen Veränderung in der Beschleunigung des Smartphones geben und verschieben die Position der Textview tv abhängig von der Änderung der Beschleunigung in Bezug zur x-koordinate. Listing 6: Sensor schlafen legen 2 protected void onpause() 3 { 4 super. onpause(); 5 this. snsmgr. unregisterlistener( this); 6 } 9 protected void onresume() 10 { 11 super. onresume(); 12 // starte Sensor 13 this. snsmgr. registerlistener(this,sns, SensorManager. SENSOR_DELAY_NORMAL); 14 } 17 public void onaccuracychanged( Sensor sensor, int accuracy) 18 { 19 } Das Problem, welches wir nun haben, ist, dass die Textview tv sich auch dann bewegt, wenn unsere Applikation nicht mehr im Vordergrund läuft. Um diesen Zustand zu beheben, verwenden wir die Methoden onpause() und onresume(). Im Grunde genommen rufen wir dort mit dem Schlüsselwort super die zugehörigen Methoden der Oberklasse AppCompatActivity auf und sorgen dafür, dass der Beschleunigungssensor schlafen gelegt wird. Dafür deregistrieren wir den Listener für Sensor sns, den wir in der Methode oncreate(bundle savedinstancestate) erstellt haben, wenn unsere Applikation nicht mehr im Vordergrund läuft. Wird unsere Applikation aufgeweckt, dann registrieren wir wieder unseren Listener für Sensor sns. Kommentare zur Datei activity_main.xml 1 <TextView Listing 7: Informationen zum Layout 2 android: layout_width=" wrap_content" 3 android: layout_height=" wrap_content" 4 android:id="@+id/ txtv1" 5 android: text=" Willkommen!" 6 android: textsize="24dp" 7 android: layout_above="@+id/ btn1" 8 android: layout_centerhorizontal=" true" 9 android: layout_marginbottom="83dp" /> 11 <Button 12 android: layout_width=" wrap_content" 13 android: layout_height=" wrap_content" 5

6 14 android: text=" Click me!" 15 btn1" 16 android: layout_centervertical=" true" 17 android: layout_centerhorizontal=" true" 18 android: clickable=" true" /> Dieser Teil enthält Informationen zum Layout von Objekten wie z.b Buttons oder TextViews. Wichtig ist, dass ihr nicht vergisst die verschiedenen Objekte über ihre IDs anzusprechen. Kommentare zur Datei AndroidManifest.xml Listing 8: Bildschirmausrichtung festlegen (Portrait) 1 <activity android: name=". MainActivity" android: screenorientation=" portrait"> 2 <intent - filter > 3 <action android: name=" android. intent. action. MAIN" /> 4 <category android: name=" android. intent. category. LAUNCHER" /> 5 </intent -filter > 6 </ activity > Mit dieser Datei könnt ihr verschiedenste Konfigurationen, wie z.b die Festlegung eurer minimum SDK version oder das allgemeine Layout eurer Applikation, vornehmen. Hier könnt ihr auch Berechtigungen für eure Applikationen anfordern, was zum Beispiel beim Absetzen von http requests notwendig ist. Listing 9: Anfordern von Berechtigungen 1 <uses - permission android: name=" android. permission. INTERNET" /> Weiterführende Informationen zu der Datei AndroidManifest.xml findet ihr unter dem folgenden Link Wie genau die Datei AndroidManifest.xml aussehen kann, seht ihr unter dem folgenden Link Eine umfangreiche Einführung in XML findet ihr unter 6