Wenn deine App eine Aktion ausführen kann, die für eine andere App nützlich sein könnte, bereite sie darauf vor, auf Aktionsanfragen zu reagieren, indem du den entsprechenden Intent-Filter in deiner Aktivität angibst.
Wenn Sie beispielsweise eine Social App entwickeln, mit der Nachrichten oder Fotos mit den Freunden des Nutzers geteilt werden können, unterstützen Sie den Intent ACTION_SEND.
Wenn Nutzer dann in einer anderen App eine „Teilen“-Aktion initiieren, wird Ihre App im Auswahldialog (auch als Disambiguierungsdialog bezeichnet) als Option angezeigt, wie in Abbildung 1 dargestellt.
Abbildung 1. Das Dialogfeld für die Auswahl.
Damit andere Apps Ihre Aktivität auf diese Weise starten können, müssen Sie in Ihrer Manifestdatei ein <intent-filter>-Element für das entsprechende <activity>-Element hinzufügen.
Wenn Ihre App auf einem Gerät installiert wird, identifiziert das System Ihre Intent-Filter und fügt die Informationen einem internen Katalog von Intents hinzu, die von allen installierten Apps unterstützt werden.
Wenn eine App startActivity() oder startActivityForResult() mit einem impliziten Intent aufruft, sucht das System nach Aktivitäten, die auf den Intent reagieren können.
Intent-Filter hinzufügen
Damit du genau definieren kannst, welche Intents deine Aktivität verarbeiten kann, solltest du jeden Intent-Filter, den du hinzufügst, so spezifisch wie möglich in Bezug auf die Art der Aktion und die Daten gestalten, die die Aktivität akzeptiert.
Das System sendet einen bestimmten Intent möglicherweise an eine Aktivität, wenn diese Aktivität einen Intent-Filter hat, der die folgenden Kriterien des Intent-Objekts erfüllt:
- Aktion
- Ein String, der die auszuführende Aktion benennt. In der Regel einer der plattformdefinierten Werte, z. B.
ACTION_SENDoderACTION_VIEW.Gib dies in deinem Intent-Filter mit dem Element
<action>an. Der Wert, den Sie in diesem Element angeben, muss der vollständige Stringname für die Aktion sein, nicht die API-Konstante, wie in den Beispielen auf dieser Seite gezeigt. - Daten
- Eine Beschreibung der mit dem Intent verknüpften Daten.
Gib dies in deinem Intent-Filter mit dem Element
<data>an. Mit einem oder mehreren Attributen in diesem Element können Sie den MIME-Typ, ein URI-Präfix, ein URI-Schema oder eine Kombination aus diesen und anderen Elementen angeben, die den akzeptierten Datentyp angeben.Hinweis: Wenn Sie keine Angaben zu den Daten
Urimachen müssen, z. B. wenn Ihre Aktivität andere Arten von „zusätzlichen“ Daten verarbeitet, geben Sie anstelle eines URI nur das Attributandroid:mimeTypean, um den Datentyp zu deklarieren, den Ihre Aktivität verarbeitet, z. B.text/plainoderimage/jpeg. - Kategorie
- Bietet eine zusätzliche Möglichkeit, die Aktivität zu charakterisieren, die den Intent verarbeitet. Dies bezieht sich in der Regel auf die Nutzergeste oder den Ort, von dem aus sie gestartet wird. Das System unterstützt mehrere verschiedene Kategorien, die meisten werden jedoch selten verwendet. Alle impliziten Intents werden jedoch standardmäßig mit
CATEGORY_DEFAULTdefiniert.Gib dies in deinem Intent-Filter mit dem Element
<category>an.
In Ihrem Intent-Filter können Sie angeben, welche Kriterien Ihre Aktivität akzeptiert. Deklarieren Sie dazu jedes Kriterium mit entsprechenden XML-Elementen, die im Element <intent-filter> verschachtelt sind.
Hier ist ein Beispiel für eine Aktivität mit einem Intent-Filter, der den Intent ACTION_SEND verarbeitet, wenn der Datentyp entweder Text oder ein Bild ist:
<activity android:name="ShareActivity"> <intent-filter> <action android:name="android.intent.action.SEND"/> <category android:name="android.intent.category.DEFAULT"/> <data android:mimeType="text/plain"/> <data android:mimeType="image/*"/> </intent-filter> </activity>
Tipp: Wenn das Symbol im Auswahldialogfeld sich vom Standardsymbol deiner Aktivität unterscheiden soll, füge android:icon im Element <intent-filter> hinzu.
Jeder eingehende Intent gibt nur eine Aktion und einen Datentyp an. Es ist jedoch möglich, mehrere Instanzen der Elemente <action>, <category> und <data> in jedem <intent-filter> zu deklarieren.
Wenn sich zwei Paare aus Aktion und Daten in ihrem Verhalten gegenseitig ausschließen, erstelle separate Intent-Filter, um anzugeben, welche Aktionen mit welchen Datentypen zulässig sind.
Angenommen, deine Aktivität verarbeitet sowohl Text als auch Bilder für die Intents ACTION_SEND und ACTION_SENDTO. In diesem Fall müssen Sie zwei separate Intent-Filter für die beiden Aktionen definieren, da ein ACTION_SENDTO-Intent die Daten Uri verwenden muss, um die Adresse des Empfängers mit dem URI-Schema send oder sendto anzugeben. Dies wird im folgenden Beispiel veranschaulicht:
<activity android:name="ShareActivity"> <!-- Filter for sending text; accepts SENDTO action with sms URI schemes --> <intent-filter> <action android:name="android.intent.action.SENDTO"/> <category android:name="android.intent.category.DEFAULT"/> <data android:scheme="sms" /> <data android:scheme="smsto" /> </intent-filter> <!-- Filter for sending text or images; accepts SEND action and text or image data --> <intent-filter> <action android:name="android.intent.action.SEND"/> <category android:name="android.intent.category.DEFAULT"/> <data android:mimeType="image/*"/> <data android:mimeType="text/plain"/> </intent-filter> </activity>
Hinweis: Wenn Sie implizite Intents empfangen möchten, müssen Sie die Kategorie CATEGORY_DEFAULT in den Intent-Filter aufnehmen. Die Methoden startActivity() und startActivityForResult() behandeln alle Intents so, als ob sie die Kategorie CATEGORY_DEFAULT deklariert hätten. Wenn Sie sie nicht im Intent-Filter deklarieren, werden keine impliziten Intents in Ihre Aktivität aufgelöst.
Weitere Informationen zum Senden und Empfangen von ACTION_SEND-Intents, die das Teilen in sozialen Netzwerken ermöglichen, findest du unter Einfache Daten von anderen Apps empfangen.
Weitere nützliche Informationen zur Freigabe von Daten finden Sie unter Einfache Daten freigeben und Dateien freigeben.
Intent in Ihrer Aktivität verarbeiten
Wenn Sie entscheiden möchten, welche Aktion in Ihrer Aktivität ausgeführt werden soll, lesen Sie den Intent, der zum Starten der Aktivität verwendet wird.
Rufen Sie beim Start der Aktivität getIntent() auf, um den Intent abzurufen, der die Aktivität gestartet hat. Das ist jederzeit während des Lebenszyklus der Aktivität möglich, aber im Allgemeinen geschieht dies während früher Callbacks wie onCreate() oder onStart().
Dies wird im folgenden Beispiel veranschaulicht:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.main) val data: Uri? = intent?.data // Figure out what to do based on the intent type if (intent?.type?.startsWith("image/") == true) { // Handle intents with image data } else if (intent?.type == "text/plain") { // Handle intents with text } }
Java
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); // Get the intent that started this activity Intent intent = getIntent(); Uri data = intent.getData(); // Figure out what to do based on the intent type if (intent.getType().indexOf("image/") != -1) { // Handle intents with image data } else if (intent.getType().equals("text/plain")) { // Handle intents with text } }
Ergebnis zurückgeben
Wenn du ein Ergebnis an die Aktivität zurückgeben möchtest, die deine Aktivität aufgerufen hat, rufe setResult() auf, um den Ergebniscode und das Ergebnis-Intent anzugeben. Wenn der Vorgang abgeschlossen ist und der Nutzer zur ursprünglichen Aktivität zurückkehrt, rufen Sie finish() auf, um die Aktivität zu schließen und zu löschen. Dies wird im folgenden Beispiel veranschaulicht:
Kotlin
// Create intent to deliver some kind of result data Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri")).also { result -> setResult(Activity.RESULT_OK, result) } finish()
Java
// Create intent to deliver some kind of result data Intent result = new Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri")); setResult(Activity.RESULT_OK, result); finish();
Sie müssen immer einen Ergebniscode mit dem Ergebnis angeben. In der Regel ist es entweder RESULT_OK oder RESULT_CANCELED. Anschließend können Sie bei Bedarf zusätzliche Daten mit einem Intent bereitstellen.
Hinweis: Das Ergebnis ist standardmäßig auf RESULT_CANCELED festgelegt. Wenn der Nutzer also auf die Zurück-Schaltfläche tippt, bevor er die Aktion abgeschlossen hat und bevor du das Ergebnis festgelegt hast, erhält die ursprüngliche Aktivität das Ergebnis „Abgebrochen“.
Wenn Sie nur eine Ganzzahl zurückgeben müssen, die eine von mehreren Ergebnisoptionen angibt, können Sie den Ergebniscode auf einen beliebigen Wert größer als 0 festlegen. Wenn Sie den Ergebniscode verwenden, um eine Ganzzahl zu liefern, und die Intent nicht einbeziehen müssen, können Sie setResult() aufrufen und nur einen Ergebniscode übergeben:
Kotlin
setResult(RESULT_COLOR_RED) finish()
Java
setResult(RESULT_COLOR_RED); finish();
In diesem Fall gibt es möglicherweise nur eine Handvoll möglicher Ergebnisse, sodass der Ergebniscode eine lokal definierte Ganzzahl (größer als 0) ist. Das funktioniert gut, wenn Sie ein Ergebnis an eine Aktivität in Ihrer eigenen App zurückgeben, da die Aktivität, die das Ergebnis empfängt, auf die öffentliche Konstante verweisen kann, um den Wert des Ergebniscodes zu bestimmen.
Hinweis: Sie müssen nicht prüfen, ob Ihre Aktivität mit startActivity() oder startActivityForResult() gestartet wurde. Rufen Sie einfach setResult() auf, wenn der Intent, der Ihre Aktivität gestartet hat, ein Ergebnis erwarten könnte. Wenn die ursprüngliche Aktivität startActivityForResult() aufgerufen hat, liefert das System das Ergebnis, das Sie für setResult() angeben. Andernfalls wird das Ergebnis ignoriert.