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.
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.