<intent-filter>
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
- 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:
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:
Weitere Informationen finden Sie unter setPriority().
android:orderDie 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>
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[],[],null,["# <intent-filter\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cintent-filter android:icon=\"drawable resource\"\n android:label=\"string resource\"\n android:priority=\"integer\" \u003e\n ...\n \u003c/intent-filter\u003e\n ```\n\ncontained in:\n: [\u003cactivity\u003e](/guide/topics/manifest/activity-element)\n\n [\u003cactivity-alias\u003e](/guide/topics/manifest/activity-alias-element)\n\n [\u003cservice\u003e](/guide/topics/manifest/service-element)\n\n [\u003creceiver\u003e](/guide/topics/manifest/receiver-element)\n\n [\u003cprovider\u003e](/guide/topics/manifest/provider-element)\n\nmust contain:\n: [\u003caction\u003e](/guide/topics/manifest/action-element)\n\ncan contain:\n: [\u003ccategory\u003e](/guide/topics/manifest/category-element)\n\n [\u003cdata\u003e](/guide/topics/manifest/data-element)\n\n [\u003curi-relative-filter-group\u003e](/guide/topics/manifest/uri-relative-filter-group-element)\n\ndescription:\n\n: Specifies the types of intents that an activity, service, or broadcast receiver can respond to. An intent filter declares the capabilities of its parent component: what an activity or service can do and what types of broadcasts a receiver can handle.\u003cbr /\u003e\n\n It opens the component to receiving\n intents of the advertised type while filtering out those that aren't\n meaningful for the component.\n Most of the contents of the filter are described by its subelements:\n\n - [\u003caction\u003e](/guide/topics/manifest/action-element),\n - [\u003ccategory\u003e](/guide/topics/manifest/category-element),\n - [\u003cdata\u003e](/guide/topics/manifest/data-element), and\n - [\u003curi-relative-filter-group\u003e](/guide/topics/manifest/uri-relative-filter-group-element).\n\n \u003cbr /\u003e\n\n\n For a more detailed discussion of filters, see\n [Intents\n and Intent Filters](/guide/components/intents-filters) and the\n [Intent filters](/guide/topics/manifest/manifest-intro#ifs)\n section in the app manifest overview.\n\nattributes:\n:\n\n `android:icon`\n\n : An icon that represents the parent activity, service, or broadcast receiver when that component is presented to the user as having the capability described by the filter.\u003cbr /\u003e\n\n\n This attribute is set as a reference to a drawable resource\n containing the image definition. The default value is the icon set\n by the parent component's `icon` attribute. If the parent\n doesn't specify an icon, the default is the icon set by the\n [\u003capplication\u003e](/guide/topics/manifest/application-element) element.\n\n\n For more information about intent filter icons, see the\n [Icons and labels](/guide/topics/manifest/manifest-intro#iconlabel)\n section in the app manifest overview.\n\n `android:label`\n\n : A user-readable label for the parent component. This label, rather than the one set by the parent component, is used when the component is presented to the user as having the capability described by the filter.\u003cbr /\u003e\n\n\n The label is set as a reference to a string resource so that\n it can be localized like other strings in the user interface.\n However, as a convenience while you're developing the application,\n it can also be set as a raw string.\n\n\n The default value is the label set by the parent component. If the\n parent doesn't specify a label, the default is the label set by the\n [\u003capplication\u003e](/guide/topics/manifest/application-element) element's\n [label](/guide/topics/manifest/application-element#label) attribute.\n\n\n For more information about intent filter labels, see the\n [Icons and labels](/guide/topics/manifest/manifest-intro#iconlabel)\n section in the app manifest overview.\n\n `android:priority`\n : The priority given to the parent component with regard\n to handling intents of the type described by the filter. This attribute has\n meaning for both activities and broadcast receivers.\n\n - It provides information about how able an activity is to respond to an intent that matches the filter, relative to other activities that can also respond to the intent. When an intent can be handled by multiple activities with different priorities, Android considers only those with higher priority values as potential targets for the intent.\n - It controls the order in which broadcast receivers are executed to\n receive broadcast messages, with those having higher priority\n values being called before those having lower values. The order applies only\n to synchronous messages. It's ignored for asynchronous messages.\n\n\n Use this attribute only if you need to impose a specific order in\n which the broadcasts are received or want to force Android to prefer\n one activity over others.\n\n\n The value is an integer, such as `100`. Higher numbers have a\n higher priority. The default value is `0`.\n\n\n In certain circumstances the requested priority is ignored and the value\n is capped to `0`. This occurs when:\n\n - A non-privileged application requests any priority \\\u003e0.\n - A privileged application requests a priority \\\u003e0 for [ACTION_VIEW](/reference/android/content/Intent#ACTION_VIEW), [ACTION_SEND](/reference/android/content/Intent#ACTION_SEND), [ACTION_SENDTO](/reference/android/content/Intent#ACTION_SENDTO) or [ACTION_SEND_MULTIPLE](/reference/android/content/Intent#ACTION_SEND_MULTIPLE).\n\n\n For more information, see [setPriority()](/reference/android/content/IntentFilter#setPriority(int)).\n\n `android:order`\n\n : The order in which the filter is processed when multiple filters match.\n\n `order` differs from `priority` in that `priority` applies\n across apps, while `order` disambiguates multiple matching filters in a single\n app.\n\n When multiple filters can match, use a directed intent instead.\n\n The value is an integer, such as `100`. Higher numbers are matched first.\n The default value is `0`.\n\n This attribute was introduced in API level 28.\n\n `android:autoVerify`\n : Whether Android needs to verify that the Digital Asset Links JSON file from the specified\n host matches this application.\n\nintroduced in:\n: API level 1\n\nsee also:\n: [\u003caction\u003e](/guide/topics/manifest/action-element)\n\n [\u003ccategory\u003e](/guide/topics/manifest/category-element)\n\n [\u003cdata\u003e](/guide/topics/manifest/data-element)\n\n [\u003curi-relative-filter-group\u003e](/guide/topics/manifest/uri-relative-filter-group-element)"]]
