<intent-filter>

Syntax:

<intent-filter android:icon="drawable resource"
               android:label="string resource"
               android:priority="integer" >
    ...
</intent-filter>

enthalten in:

<activity>
<activity-alias>
<service>
<receiver>
<provider>

muss Folgendes enthalten:

<action>

kann Folgendes enthalten:

<category>
<data>

description:

Gibt die Intent-Typen an, auf die eine Aktivität, ein Dienst oder ein Übertragungsempfänger reagieren kann. Ein Intent-Filter deklariert die Funktionen seiner übergeordneten Komponente, also was eine Aktivität oder ein Dienst tun kann und welche Arten von Broadcasts ein Empfänger verarbeiten kann.

Die Komponente wird für den Empfang von Intents des beworbenen Typs geöffnet. Gleichzeitig werden diejenigen herausgefiltert, die für die Komponente nicht relevant sind. Der Großteil des Filterinhalts wird durch die Unterelemente <action>, <category> und <data> beschrieben.

Eine ausführlichere Beschreibung von Filtern finden Sie unter Intents und Intent-Filter und im Abschnitt Intent-Filter in der Übersicht des App-Manifests.

Attribute:

android:icon

Ein Symbol, das die übergeordnete Aktivität, den übergeordneten Dienst oder den übergeordneten Broadcast-Empfänger darstellt, wenn dem Nutzer diese Komponente mit der vom Filter beschriebenen Funktion angezeigt wird.

Dieses Attribut wird als Verweis auf eine Drawable-Ressource festgelegt, die die Bilddefinition enthält. Der Standardwert ist das Symbol, das mit dem Attribut icon der übergeordneten Komponente festgelegt wird. Wenn im übergeordneten Element kein Symbol angegeben ist, wird als Standard das vom <application>-Element festgelegte Symbol verwendet.

Weitere Informationen zu Symbolen für Intent-Filter finden Sie in der App-Manifest-Übersicht im Abschnitt Symbole und Labels.

android:label

Ein nutzerlesbares Label für die übergeordnete Komponente. Dieses Label wird verwendet, nicht das Label, das von der übergeordneten Komponente festgelegt wird, wenn die Komponente dem Nutzer die durch den Filter beschriebene Funktion zeigt.

Das Label wird als Verweis auf eine Stringressource festgelegt, damit es wie andere Strings in der Benutzeroberfläche lokalisiert werden kann. Der Einfachheit halber kann sie beim Entwickeln der Anwendung auch als Rohstring festgelegt werden.

Der Standardwert ist das Label, das von der übergeordneten Komponente festgelegt wird. Wenn im übergeordneten Element kein Label angegeben ist, wird standardmäßig das Label verwendet, das durch das Attribut label des <application>-Elements festgelegt wird.

Weitere Informationen zu Labels für Intent-Filter finden Sie in der App-Manifest-Übersicht im Abschnitt Symbole und Labels.

android:priority

Die Priorität, die der übergeordneten Komponente in Bezug auf die Verarbeitung von Intents des durch den Filter beschriebenen Typs zugewiesen wird. Dieses Attribut hat sowohl für Aktivitäten als auch für Übertragungsempfänger eine Bedeutung.

• Sie liefert Informationen darüber, wie gut eine Aktivität auf einen Intent reagieren kann, der dem Filter entspricht, im Vergleich zu anderen Aktivitäten, die ebenfalls auf den Intent reagieren können. Wenn ein Intent von mehreren Aktivitäten mit unterschiedlichen Prioritäten verarbeitet werden kann, betrachtet Android nur solche mit einer höheren Priorität als potenzielle Ziele für den Intent.

• Sie steuert die Reihenfolge, in der Broadcast-Empfänger ausgeführt werden, um Broadcast-Nachrichten zu empfangen. Die Empfänger mit höheren Prioritätswerten werden vor denen mit niedrigeren Werten aufgerufen. Die Reihenfolge gilt nur für synchrone Nachrichten. Bei asynchronen Nachrichten wird er ignoriert.

Verwenden Sie dieses Attribut nur, wenn Sie eine bestimmte Reihenfolge festlegen müssen, in der die Broadcasts empfangen werden, oder wenn Android eine bestimmte Aktivität gegenüber anderen bevorzugen soll.

Der Wert ist eine Ganzzahl, z. B. 100. Höhere Zahlen haben eine höhere Priorität. Der Standardwert ist 0.

Unter bestimmten Umständen wird die angeforderte Priorität ignoriert und der Wert wird auf 0 begrenzt. Das passiert in folgenden Fällen:

• Eine nicht privilegierte Anwendung fordert eine beliebige Priorität > 0 an.
• Eine privilegierte Anwendung fordert für ACTION_VIEW, ACTION_SEND, ACTION_SENDTO oder ACTION_SEND_MULTIPLE eine Priorität >0 an.

Weitere Informationen findest du unter setPriority().

android:order

Die Reihenfolge, in der der Filter verarbeitet wird, wenn mehrere Filter übereinstimmen.

order unterscheidet sich von priority insofern, als priority auf alle Apps angewendet wird, während order mehrere übereinstimmende Filter in einer einzelnen App voneinander unterscheidet.

Wenn mehrere Filter übereinstimmen können, verwenden Sie stattdessen einen gerichteten Intent.

Der Wert ist eine Ganzzahl, z. B. 100. Höhere Zahlen werden zuerst abgeglichen. Der Standardwert ist 0.

Dieses Attribut wurde mit API-Level 28 eingeführt.

android:autoVerify

Gibt an, ob Android überprüfen muss, ob die Digital Asset Links-JSON-Datei vom angegebenen Host mit dieser App übereinstimmt.

Weitere Informationen finden Sie unter Android-App-Links bestätigen.

Der Standardwert ist false.

Dieses Attribut wurde mit API-Level 23 eingeführt.

eingeführt in:

API-Level 1

Siehe auch:

<action>
<category>
<data>