<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>
<uri-relative-filter-group>

description:

Gibt die Arten von Intents an, auf die ein Aktivitäts-, Dienst- oder Broadcastempfänger reagieren kann. Ein Intent-Filter deklariert die Funktionen seiner übergeordneten Komponente: Was eine Aktivität oder ein Dienst tun kann und welche Arten von Übertragungen ein Empfänger verarbeiten kann.

Dadurch wird die Komponente für den Empfang von Intents des beworbenen Typs geöffnet und solche herausgefiltert, die für die Komponente nicht relevant sind. Der Großteil des Inhalts des Filters wird durch seine Unterelemente beschrieben:

• <action>,
• <category>,
• <data> und
• <uri-relative-filter-group>.

Weitere Informationen zu Filtern finden Sie unter Intents und Intent-Filter und im Abschnitt Intent-Filter in der Übersicht zum App-Manifest.

attributes:

android:icon

Ein Symbol, das die übergeordnete Aktivität, den übergeordneten Dienst oder den übergeordneten Empfänger der Übertragung darstellt, wenn diese Komponente dem Nutzer als über die vom Filter beschriebene Funktion verfügend angezeigt wird.

Dieses Attribut wird als Verweis auf eine Zeichnen-Ressource mit der Bilddefinition festgelegt. Der Standardwert ist das Symbol, das über das icon-Attribut der übergeordneten Komponente festgelegt wurde. Wenn für das übergeordnete Element kein Symbol angegeben ist, wird standardmäßig das Symbol verwendet, das vom <application>-Element festgelegt wurde.

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

android:label

Ein für Nutzer lesbares Label für die übergeordnete Komponente. Dieses Label wird anstelle des von der übergeordneten Komponente festgelegten Labels verwendet, wenn der Nutzer die Komponente als die vom Filter beschriebene Funktion wahrnimmt.

Das Label wird als Referenz auf eine Stringressource festgelegt, damit es wie andere Strings in der Benutzeroberfläche lokalisiert werden kann. Zur Vereinfachung kann es während der Entwicklung der Anwendung jedoch auch als Rohstring festgelegt werden.

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

Weitere Informationen zu Intent-Filterlabels finden Sie im Abschnitt Symbole und Labels in der Übersicht zum App-Manifest.

android:priority

Die Priorität, die der übergeordneten Komponente beim Umgang mit Absichten des vom Filter beschriebenen Typs zugewiesen wird. Dieses Attribut ist sowohl für Aktivitäten als auch für Broadcastempfänger relevant.

• Sie gibt Aufschluss darüber, wie gut eine Aktivität auf einen Intent reagieren kann, der mit dem Filter übereinstimmt, im Vergleich zu anderen Aktivitäten, die ebenfalls auf den Intent reagieren können. Wenn eine Intent-Aktion von mehreren Aktivitäten mit unterschiedlichen Prioritäten verarbeitet werden kann, werden von Android nur diejenigen mit höheren Prioritätswerten als potenzielle Ziele für die Intent-Aktion berücksichtigt.

• Sie steuert die Reihenfolge, in der Broadcastempfänger ausgeführt werden, um Broadcastnachrichten zu empfangen. 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 sie ignoriert.

Verwenden Sie dieses Attribut nur, wenn Sie festlegen möchten, in welcher Reihenfolge die Übertragungen empfangen werden sollen, oder Android dazu zwingen möchten, eine Aktivität anderen vorzuziehen.

Der Wert ist eine Ganzzahl, z. B. 100. Je höher die Zahl, desto höher die Priorität. Der Standardwert ist 0.

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

• Eine nicht privilegierte Anwendung fordert eine beliebige Priorität an, die größer als 0 ist.
• Eine privilegierte Anwendung fordert eine Priorität > 0 für ACTION_VIEW, ACTION_SEND, ACTION_SENDTO oder ACTION_SEND_MULTIPLE an.

Weitere Informationen finden Sie unter setPriority().

android:order

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

order unterscheidet sich von priority dadurch, dass priority geräteübergreifend angewendet wird, während order mehrere übereinstimmende Filter in einer einzelnen App auflöst.

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

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

Dieses Attribut wurde in API-Ebene 28 eingeführt.

android:autoVerify

Ob Android prüfen muss, ob die Digital Asset Links-JSON-Datei vom angegebenen Host mit dieser Anwendung übereinstimmt.

Weitere Informationen finden Sie unter Android-App-Links überprüfen.

Der Standardwert ist false.

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

eingeführt in:

API-Level 1

Weitere Informationen:

<action>
<category>
<data>
<uri-relative-filter-group>