Android Development - Grundfunktionen Programmieren

Stichworte: Activity, Text Widget View Objekt, Intent

Baut auf diesem Artikel auf:

Android Development - User Interface programmieren

Als oft wieder kehrende Grundfunktionen lernen wir wie man eine neue Activity aufruft und über ein Intent an diese Daten überträgt und dort eine Ausgabe über ein View Objekt macht.

Wir haben ein kleines Layout mit einem Textfeld und einem Button. Im Folgenden wollen wir das ganze mit einer zweiten Activity verbinden, die auf die Eingabe reagiert.

Neue Activity aufrufen und anlegen

onClick Event für den Send Button

activity_main.xml

Attribut hinzufügen:

android:onClick="sendMessage"

Bei Klick auf den Button soll die Methode sendMessage aufgerufen werden. Diese fügen wir in der MainActivity Klasse hinzu.

src/MainActivity.java

	/** Called when the user clicks the send button **/
	public void sendMessage(View view) {
		// Do something
	}

Dazu muß noch die View Klasse importiert werden.

import android.view.View;

In Eclipse kann man fehlende Klassen einfach mit

Ctrl + Shift + O (PC)
Cmd + Shift + O (Mac)

Wichtig zu wissen ist das die Methode für onClick folgende Eigenschaften hat:

• public
• void als Rückgabewert hat
• Einen View als einzigen Parameter hat (dieser enthält das View Objekt, das geklickt wurde)

Intent

Wir möchten als Reaktion auf den Klick eine zweite Activity starten. Dafür gibt es die Intents. die Intention eines Intent ist es einzelne Komponenten zu verbinden. Am häufigsten werden sie dazu eingesetzt eine weitere Activity zu starten.

Man kann sich eine Intent quasi als Kabel - eine Verbindung zwischen Komponenten vorstellen, mit denen man beabsichtigt etwas zu tun (Intent, Intention). So gehts:

in sendMessage() erzeugen wir einen Intent.

Intent intent = new Intent(this, DisplayMessageActivity.class);

Der Konstruktor hat zwei Parameter, es sind quasi die Anschlüsse des Intent.

• Parameter 1 ist ein Context (Klasse). Quasi der Startpunkt des Intent. Hier können wir this nehmen (die Activity) weil Activity eine Subklasse von Context ist.
• Parameter 2 ist die Klasse der App Komponente, an die der Intent liefern soll. Quasi der Endpunkt des Kabels. hier ist es die Activity die gestartet werden soll.

Die Klasse DisplayMessageActivity.class gibt es noch nicht. Deshalb meckert Eclipse noch (...cannot be resolved...) Das holen wir gleich nach, aber zuerst erweitern wir die Funktion:

	public void sendMessage(View view) {
		Intent intent = new Intent(this, DisplayMessageActivity.class);
		EditText editText = (EditText) findViewById(R.id.edit_message);
		String message = editText.getText().toString();
		intent.putExtra(EXTRA_MESSAGE, message);
	}

Dazu brauchen wir noch zwei imports:

import android.content.Intent;
import android.widget.EditText;

Mit der putExtra Methode kann der Intent verschiedene Typen von Daten als Key-Value Paare übermitteln. putExtra(key,value) Die Konstante EXTRA_MESSAGE definieren wir gleich.

Mit findViewById können wir das Text-View-Objekt holen und danach die Textnachricht auslesen.

Die Konstante definieren wir in der MainActivity Klasse

 public class MainActivity extends Activity {
	public final static String EXTRA_MESSAGE = "de.webmynet.firstapp.MESSAGE";
 ...

Hinweis: Es ist gut den Package Prefix der App für die intent extras zu nehmen. Das sorgt dafür, daß sie nur einmal vorkommen und nicht mit andern Apps interagieren.

Zweite Activity starten

Überblick:

• Activity aus Main Activity starten
• Activity Klasse anlegen
• Fehlermeldungen für alte Plattformen verhindern
• onCreate Funktion
• Titel der neuen Activity und diese zum Manifest hinzufügen
• Informationen aus dem Intent holen
• Layout der neuen Activity

Wir fügen in sendMessage noch die Zeile:

startActivity(intent); 

ein. In der Methode startActivity() wird der Intend übergeben und das System startet eine Instanz der in Intent definierten Activity.

Mit Eclipse legen wir ganz einfach eine neue Activity an. sie sollte im gleichen Package liegen wie die MainActivity.

New (das Icon) > Android > Android Activity
Blank Activity
Project: FirstApp (oder wie die App heißt)
Activity Name: DisplayMessageActivity (s.o.)
Layout Name: activity_display_message
Title: My message
Hierarchial Parent: de.webmynet.firstapp.MainActivity
Navigation Type: None

Man kann die Datei src/DisplayMessageActivity.java natürlich auch von Hand anlegen. Eclipse legt allerdings schon vorab das Grundgerüst mit imports und einigen Funktionen (onCreate, onCreateOptionsMenu, onOptionsItemSelected() an.

Hinweis: Jede Subklasse von Activity benötigt die Funktion onCreate(). Sie wird beim Start vom System aufgerufen. Darin wird über die Funktion setcontentView() das Layout initialisiert (die xml Datei) und man kann diverse Initialisierungen vornehmen. Eclipse legt von sich aus schon eine Layout-Datei an (activity_display_message.xml) und initialisiert sie:

setContentView(R.layout.activity_display_message);

Das passen wir aber noch an.

Die Funktion onCreateOptionsMenu() brauchen wir nicht und löschen diese.

Die Funktion onOptionsItemSelected() behandelt die Android Zurück-Taste. Diese lassen wir erst mal.

ActionBar

In der onCreate funktion finden wir eine ActionBar Funktion um den Software Zurück-Button (engl. Up Button) zu setzen. Die ActionBar API ist jedoch erst ab Honeycomb (API Level 11) Verfügbar. Deshalb fragen wir vorher die Version ab und setzen ein SuppressLint Tag (siehe Android Development - Referenz ) um Fehlermeldungen von Lint zu verhindern.

        // Show the Up button in the action bar.
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB){
        	getActionBar().setDisplayHomeAsUpEnabled(true);
        }

Titel der neuen Activity

Eclipse macht dies automatisch und legt in der stings.xml die Zeile

<string name="title_activity_display_message">My message</string>

an.

Activity zum Manifest hinzufügen

Auch das hat Eclipse schon erledigt. Man kann im Nachhinein natürlich noch Anpassungen machen. Datei: AndroidManifest.xml

        <activity
            android:name="de.webmynet.firstapp.DisplayMessageActivity"
            android:label="@string/title_activity_display_message"
            android:parentActivityName="de.webmynet.firstapp.MainActivity" >
            <meta-data
                android:name="android.support.PARENT_ACTIVITY"
                android:value="de.webmynet.firstapp.MainActivity" />
        </activity>

Das android:parentActivityName definiert die übergeordnete Seite für die neueren Apis, damit der Up Button richtig funktioniert. Vor Android 4.1 (Api 16) benötigt man das meta-data Element.

Information aus dem Intent holen

Wir können in der neuen Activity mit getIntent() auf den Intent und die enthaltenen Daten Zugreifen. Das machen wir in der onCreate() Funktion:

Intent intent = getIntent();
String message = intent.getStringExtra(MainActivity.EXTRA_MESSAGE);

Nicht vergessen die notwendigen Imports zu machen. (import android.content.Intent; Eclipse: Strg + Shift + O)

Nachricht anzeigen

Um den Text in der neuen Activity darzustellen nehmen wir ein TextView Widget (wieder ein View Objekt) und nutzen die setText() Funktion. Das TextView Objekt hängen mit der setContentView() Funktion als oberstes root-objekt in die Activity.

       // Create the text view object
       TextView textView = new TextView(this);
       textView.setTextSize(40);
       textView.setText(message);

       // Set the Text view as the root activity layout
       setContentView(textView);

Kompletter Programmcode

MainActivity.java

Aus dem Layout Beispiel

package de.webmynet.firstapp;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.Menu;
import android.view.View;
import android.widget.EditText;

public class MainActivity extends Activity {
	public final static String EXTRA_MESSAGE = "de.webmynet.firstapp.MESSAGE";

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
	}

	@Override
	public boolean onCreateOptionsMenu(Menu menu) {
		// Inflate the menu; this adds items to the action bar if it is present.
		getMenuInflater().inflate(R.menu.activity_main, menu);
		return true;
	}
	
	/** Called when the user clicks the send button **/
	public void sendMessage(View view) {
		Intent intent = new Intent(this, DisplayMessageActivity.class);
		EditText editText = (EditText) findViewById(R.id.edit_message);
		String message = editText.getText().toString();
		intent.putExtra(EXTRA_MESSAGE, message);
		startActivity(intent);
	}

}

activity_main.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="horizontal"
    tools:context=".MainActivity" >

	<EditText android:id="@+id/edit_message"
	    android:layout_weight="1"
	    android:layout_width="0dp"
	    android:layout_height="wrap_content"
	    android:hint="@string/edit_message" />
	
	<Button 
	    android:layout_width="wrap_content"
	    android:layout_height="wrap_content"
	    android:text="@string/button_send"
	    android:onClick="sendMessage" />
	
</LinearLayout>

DisplayMessageActivity.java

Ohne die nicht benötigte von Eclipse angelegte onOptionsItemSelected(MenuItem item) Funktion

package de.webmynet.firstapp;

import android.annotation.SuppressLint;
import android.app.Activity;
import android.content.Intent;
import android.os.Build;
import android.os.Bundle;
import android.support.v4.app.NavUtils;
import android.view.MenuItem;
import android.widget.TextView;

public class DisplayMessageActivity extends Activity {

	@SuppressLint("NewApi")
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        // Get the message from the intent
        Intent intent = getIntent();
        String message = intent.getStringExtra(MainActivity.EXTRA_MESSAGE);
        
        // Create the text view object
        TextView textView = new TextView(this);
        textView.setTextSize(40);
        textView.setText(message);
        
        // Set the Text view as the root activity layout
        setContentView(textView);
        
        // Show the Up button in the action bar.
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB){
        	getActionBar().setDisplayHomeAsUpEnabled(true);
        }
    }
}

activity_display_message.xml

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".DisplayMessageActivity" >

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_centerVertical="true"
        android:text="@string/hello_world" />

</RelativeLayout>

strings.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>

    <string name="app_name">First App</string>
    <string name="menu_settings">Settings</string>
    <string name="button_send">Absenden</string>
    <string name="edit_message">Gib was ein</string>
    <string name="hello_world">Hello world!</string>
    <string name="title_activity_display_message">My message</string>

</resources>

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="de.webmynet.firstapp"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="8"
        android:targetSdkVersion="17" />

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="de.webmynet.firstapp.MainActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <activity
            android:name="de.webmynet.firstapp.DisplayMessageActivity"
            android:label="@string/title_activity_display_message"
            android:parentActivityName="de.webmynet.firstapp.MainActivity" >
            <meta-data
                android:name="android.support.PARENT_ACTIVITY"
                android:value="de.webmynet.firstapp.MainActivity" />
        </activity>
    </application>

</manifest>