Nutzer zu anderer App weiterleiten

Eine der wichtigsten Funktionen von Android ist die Möglichkeit, den Nutzer basierend auf einer „Aktion“, die er ausführen möchte, zu einer anderen App weiterzuleiten. Wenn Ihre App beispielsweise die Adresse eines Unternehmens enthält, das Sie auf einer Karte anzeigen möchten, müssen Sie in Ihrer App keine Aktivität erstellen, die eine Karte anzeigt. Stattdessen können Sie eine Anfrage zum Aufrufen der Adresse mit einem Intent erstellen. Das Android-System startet dann eine App, die die Adresse auf einer Karte anzeigen kann.

Wie im ersten Kurs Erste App erstellen erläutert, müssen Sie Intents verwenden, um zwischen Aktivitäten in Ihrer eigenen App zu wechseln. In der Regel verwenden Sie dazu einen expliziten Intent, der den genauen Klassennamen der Komponente definiert, die Sie starten möchten. Wenn Sie jedoch eine separate App eine Aktion ausführen lassen möchten, z. B. „Karte ansehen“, müssen Sie einen impliziten Intent verwenden.

In dieser Lektion erfahren Sie, wie Sie einen impliziten Intent für eine bestimmte Aktion erstellen und damit eine Aktivität starten, die die Aktion in einer anderen App ausführt. Sehen Sie sich auch das eingebettete Video an, um zu verstehen, warum es wichtig ist, Laufzeitprüfungen für Ihre impliziten Intents einzubinden.

Impliziten Intent erstellen

Bei impliziten Intents wird nicht der Klassenname der zu startenden Komponente deklariert, sondern eine auszuführende Aktion. Die Aktion gibt an, was Sie tun möchten, z. B. etwas ansehen, bearbeiten, senden oder abrufen.

Intent-Aktionen mit Daten verknüpfen

Intents enthalten oft auch Daten, die mit der Aktion verknüpft sind, z. B. die Adresse, die Sie aufrufen möchten, oder die E‑Mail-Nachricht, die Sie senden möchten. Je nach Intent, den Sie erstellen möchten, können die Daten ein Uri oder einer von mehreren anderen Datentypen sein. Möglicherweise sind für den Intent auch gar keine Daten erforderlich.

Wenn es sich bei Ihren Daten um einen Uri handelt, können Sie die Aktion und die Daten mit einem einfachen Intent()-Konstruktor definieren.

Hier ist ein Beispiel für das Erstellen eines Intents, um einen Anruf zu starten. Dabei werden die Uri-Daten verwendet, um die Telefonnummer anzugeben:

Kotlin

val callIntent: Intent = Uri.parse("tel:5551234").let { number ->
    Intent(Intent.ACTION_DIAL, number)
}

Java

Uri number = Uri.parse("tel:5551234");
Intent callIntent = new Intent(Intent.ACTION_DIAL, number);

Wenn Ihre App diesen Intent durch Aufrufen von startActivity() aufruft, initiiert die Telefon App einen Anruf an die angegebene Telefonnummer.

Hier sind einige weitere Intents und die zugehörigen Paare aus Aktion und Uri-Daten:

Karte ansehen

Kotlin

// Map point based on address
val mapIntent: Intent = Uri.parse(
        "geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California"
).let { location ->
    // Or map point based on latitude/longitude
    // val location: Uri = Uri.parse("geo:37.422219,-122.08364?z=14") // z param is zoom level
    Intent(Intent.ACTION_VIEW, location)
}

Java

// Map point based on address
Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
// Or map point based on latitude/longitude
// Uri location = Uri.parse("geo:37.422219,-122.08364?z=14"); // z param is zoom level
Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

Webseite ansehen

Kotlin

val webIntent: Intent = Uri.parse("https://www.android.com").let { webpage ->
    Intent(Intent.ACTION_VIEW, webpage)
}

Java

Uri webpage = Uri.parse("https://www.android.com");
Intent webIntent = new Intent(Intent.ACTION_VIEW, webpage);

Extras zu einem Intent hinzufügen

Andere Arten von impliziten Intents erfordern „zusätzliche“ Daten, die verschiedene Datentypen wie einen String bereitstellen. Mit den verschiedenen putExtra()-Methoden können Sie ein oder mehrere zusätzliche Datenelemente hinzufügen.

Standardmäßig bestimmt das System den für einen Intent erforderlichen MIME-Typ anhand der enthaltenen Uri-Daten. Wenn Sie keinen Uri in den Intent aufnehmen, sollten Sie normalerweise setType() verwenden, um den Datentyp anzugeben, der mit dem Intent verknüpft ist. Durch Festlegen des MIME-Typs wird genauer angegeben, welche Arten von Aktivitäten den Intent erhalten sollen.

Hier sind einige weitere Intents, die zusätzliche Daten enthalten, um die gewünschte Aktion anzugeben:

E‑Mail mit Anhang senden

Kotlin

Intent(Intent.ACTION_SEND).apply {
    // The intent does not have a URI, so declare the "text/plain" MIME type
    type = "text/plain"
    putExtra(Intent.EXTRA_EMAIL, arrayOf("jan@example.com")) // recipients
    putExtra(Intent.EXTRA_SUBJECT, "Email subject")
    putExtra(Intent.EXTRA_TEXT, "Email message text")
    putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment"))
    // You can also attach multiple items by passing an ArrayList of Uris
}

Java

Intent emailIntent = new Intent(Intent.ACTION_SEND);
// The intent does not have a URI, so declare the "text/plain" MIME type
emailIntent.setType(HTTP.PLAIN_TEXT_TYPE);
emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[] {"jan@example.com"}); // recipients
emailIntent.putExtra(Intent.EXTRA_SUBJECT, "Email subject");
emailIntent.putExtra(Intent.EXTRA_TEXT, "Email message text");
emailIntent.putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment"));
// You can also attach multiple items by passing an ArrayList of Uris

Kalendertermin erstellen

Hinweis: Dieser Intent für einen Kalendertermin wird nur ab API-Level 14 unterstützt.

Kotlin

// Event is on January 23, 2021 -- from 7:30 AM to 10:30 AM.
Intent(Intent.ACTION_INSERT, Events.CONTENT_URI).apply {
    val beginTime: Calendar = Calendar.getInstance().apply {
        set(2021, 0, 23, 7, 30)
    }
    val endTime = Calendar.getInstance().apply {
        set(2021, 0, 23, 10, 30)
    }
    putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.timeInMillis)
    putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.timeInMillis)
    putExtra(Events.TITLE, "Ninja class")
    putExtra(Events.EVENT_LOCATION, "Secret dojo")
}

Java

// Event is on January 23, 2021 -- from 7:30 AM to 10:30 AM.
Intent calendarIntent = new Intent(Intent.ACTION_INSERT, Events.CONTENT_URI);
Calendar beginTime = Calendar.getInstance();
beginTime.set(2021, 0, 23, 7, 30);
Calendar endTime = Calendar.getInstance();
endTime.set(2021, 0, 23, 10, 30);
calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.getTimeInMillis());
calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.getTimeInMillis());
calendarIntent.putExtra(Events.TITLE, "Ninja class");
calendarIntent.putExtra(Events.EVENT_LOCATION, "Secret dojo");

Hinweis: Es ist wichtig, dass Sie Ihre Intent so genau wie möglich definieren. Wenn Sie beispielsweise ein Bild mit dem Intent ACTION_VIEW anzeigen möchten, sollten Sie den MIME-Typ image/* angeben. Dadurch wird verhindert, dass Apps, die andere Datentypen „anzeigen“ können (z. B. eine Karten-App), durch den Intent ausgelöst werden.

Aktivität mit dem Intent starten

Nachdem Sie die Intent erstellt und die zusätzlichen Informationen festgelegt haben, rufen Sie startActivity() auf, um sie an das System zu senden:

Kotlin

startActivity(intent)

Java

startActivity(intent);

Situationen verarbeiten, in denen keine App einen Intent empfangen kann

Viele Intents werden zwar erfolgreich von einer anderen App verarbeitet, die auf dem Gerät installiert ist, z. B. einer Telefon-, E‑Mail- oder Kalender-App, aber deine App sollte auf die Situation vorbereitet sein, dass keine Aktivität den Intent deiner App verarbeiten kann. Wenn Sie einen Intent aufrufen, sollten Sie darauf vorbereitet sein, eine ActivityNotFoundException abzufangen. Diese tritt auf, wenn es keine andere Aktivität gibt, die den Intent Ihrer App verarbeiten kann:

Kotlin

try {
    startActivity(intent)
} catch (e: ActivityNotFoundException) {
    // Define what your app should do if no activity can handle the intent.
}

Java

try {
    startActivity(intent);
} catch (ActivityNotFoundException e) {
    // Define what your app should do if no activity can handle the intent.
}

Nachdem Sie diese Ausnahme abgefangen haben, entscheiden Sie, was Ihre App als Nächstes tun soll. Der nächste Schritt hängt von den spezifischen Merkmalen des Intents ab, den Sie aufrufen wollten. Wenn du beispielsweise eine bestimmte App kennst, die den Intent verarbeiten kann, stelle dem Nutzer einen Link zum Herunterladen der App zur Verfügung. Weitere Informationen zum Verlinken auf dein Produkt bei Google Play

Dialogfeld zur Mehrdeutigkeitsauflösung

Wenn das System mehr als eine Aktivität identifiziert, die den Intent verarbeiten kann, wird ein Dialogfeld angezeigt (manchmal auch als „Dialogfeld zur Mehrdeutigkeitsauflösung“ bezeichnet), in dem der Nutzer auswählen kann, welche App verwendet werden soll (siehe Abbildung 1). Wenn es nur eine Aktivität gibt, die den Intent verarbeitet, wird sie sofort gestartet.

Unten auf dem Bildschirm wird ein Bereich angezeigt. In diesem Bereich werden die verschiedenen Apps aufgeführt, die den Intent verarbeiten können.

Abbildung 1. Beispiel für das Auswahldialogfeld, das angezeigt wird, wenn mehr als eine App einen Intent verarbeiten kann.

Vollständiges Beispiel

Hier ist ein vollständiges Beispiel, das zeigt, wie Sie einen Intent zum Aufrufen einer Karte erstellen, prüfen, ob eine App zum Verarbeiten des Intents vorhanden ist, und diese dann starten:

Kotlin

// Build the intent.
val location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California")
val mapIntent = Intent(Intent.ACTION_VIEW, location)

// Try to invoke the intent.
try {
    startActivity(mapIntent)
} catch (e: ActivityNotFoundException) {
    // Define what your app should do if no activity can handle the intent.
}

Java

// Build the intent.
Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);

// Try to invoke the intent.
try {
    startActivity(mapIntent);
} catch (ActivityNotFoundException e) {
    // Define what your app should do if no activity can handle the intent.
}

App-Auswahl anzeigen

Abbildung 2: Ein Dialogfeld zur Auswahl.

Wenn du eine Aktivität startest, indem du dein Intent-Objekt an startActivity() übergibst, und mehr als eine App auf den Intent reagiert, kann der Nutzer auswählen, welche App standardmäßig verwendet werden soll. Dazu muss er ein Kästchen unten im Dialogfeld aktivieren (siehe Abbildung 1). Das ist nützlich, wenn eine Aktion ausgeführt wird, für die der Nutzer in der Regel immer dieselbe App verwenden möchte, z. B. beim Öffnen einer Webseite (Nutzer verwenden wahrscheinlich nur einen Webbrowser) oder beim Aufnehmen eines Fotos (Nutzer bevorzugen wahrscheinlich eine Kamera).

Wenn die auszuführende Aktion jedoch von mehreren Apps verarbeitet werden kann und der Nutzer jedes Mal eine andere App bevorzugen könnte, z. B. eine „Teilen“-Aktion, für die Nutzer möglicherweise mehrere Apps haben, über die sie ein Element teilen können, solltet ihr explizit ein Auswahldialogfeld anzeigen, wie in Abbildung 2 dargestellt. Im Auswahldialogfeld muss der Nutzer jedes Mal auswählen, welche App für die Aktion verwendet werden soll. Er kann keine Standard-App für die Aktion auswählen.

Wenn Sie die Auswahl anzeigen möchten, erstellen Sie mit createChooser() ein Intent-Objekt und übergeben Sie es an startActivity(). Beispiel:

Kotlin

val intent = Intent(Intent.ACTION_SEND)

// Create intent to show chooser
val chooser = Intent.createChooser(intent, /* title */ null)

// Try to invoke the intent.
try {
    startActivity(chooser)
} catch (e: ActivityNotFoundException) {
    // Define what your app should do if no activity can handle the intent.
}

Java

Intent intent = new Intent(Intent.ACTION_SEND);

// Create intent to show chooser
Intent chooser = Intent.createChooser(intent, /* title */ null);

// Try to invoke the intent.
try {
    startActivity(chooser);
} catch (ActivityNotFoundException e) {
    // Define what your app should do if no activity can handle the intent.
}

Daraufhin wird ein Dialogfeld mit einer Liste von Apps angezeigt, die auf den Intent reagieren, der an die Methode createChooser() übergeben wurde. Der Parameter title kann angegeben werden, wenn die Aktion nicht ACTION_SEND oder ACTION_SEND_MULTIPLE ist.