- sintaxis:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > ... </intent-filter>
- se incluye en:
<activity>
<activity-alias>
<service>
<receiver>
<provider>
- debe incluir:
<action>
- puede contener:
<category>
<data>
<uri-relative-filter-group>
- descripción:
- Especifica los tipos de intents a los que pueden responder una actividad, un servicio o un receptor de emisión. Un filtro de intents declara las capacidades de su componente superior: lo que una actividad o un servicio pueden hacer y qué tipos de transmisiones puede controlar un receptor.
Abre el componente para recibir intents del tipo anunciado y, a su vez, filtra aquellos que no son significativos para el componente. La mayoría del contenido del filtro se describe en los subelementos:
Para obtener un análisis más detallado de los filtros, consulta Intents y filtros de intents y la sección Filtros de intents en la descripción general del manifiesto de la app.
- atributos:
android:icon
- Es un ícono que representa el receptor de emisión, el servicio o la actividad superior cuando ese componente se presenta al usuario como que tiene la capacidad que se describe en el filtro.
Este atributo se establece como referencia a un recurso de elementos de diseño que contiene la definición de la imagen. El valor predeterminado es el ícono que establece el atributo
icon
del componente superior. Si este no especifica un ícono, el valor predeterminado es el ícono que establece el elemento<application>
.Para obtener más información sobre los íconos de filtros de intents, consulta la sección Íconos y etiquetas en la descripción general del manifiesto de la app.
android:label
- Es una etiqueta legible para el usuario del componente superior. Esta etiqueta, a diferencia de la que establece el componente superior, se usa cuando el componente se presenta al usuario como que tiene la capacidad que se describe en el filtro.
La etiqueta se establece como una referencia a un recurso de cadenas, de manera que pueda localizarse como otras cadenas de la interfaz de usuario. Sin embargo, para tu conveniencia durante el desarrollo de la aplicación, también se puede establecer como cadena sin procesar.
El valor predeterminado es la etiqueta que establece el componente superior. Si este no especifica una, el valor predeterminado es la etiqueta que establece el atributo
label
del elemento<application>
.Para obtener más información sobre las etiquetas de filtros de intents, consulta la sección Íconos y etiquetas en la descripción general del manifiesto de la app.
android:priority
- Es la prioridad que se otorga al componente superior en relación con la administración de intents del tipo que describe el filtro. Este atributo es significativo tanto para las actividades como para los receptores de emisión:
- Brinda información sobre la capacidad de respuesta de una actividad a un intent que coincide con el filtro, en comparación con otras actividades que pueden responder al intent. Cuando se puede manejar un intent mediante varias actividades con diferentes prioridades, Android solo considera aquellas con valores de prioridad más altos como objetivos potenciales para el intent.
Controla el orden en que se ejecutan los receptores de emisión para recibir mensajes de emisión. Los que tienen valores de prioridad más altos se llaman antes que los que tienen valores más bajos. El orden solo se aplica a los mensajes síncronos. Se ignora en el caso de los mensajes asíncronos.
Solo usa este atributo si necesitas imponer un orden específico en el que se reciban las emisiones o si deseas forzar a Android a priorizar una actividad sobre otras.
El valor es un número entero, como
100
. Los números más altos tienen una prioridad más alta. El valor predeterminado es0
.En ciertas circunstancias, se ignora la prioridad solicitada y el valor se limita a
0
, lo que ocurre en los siguientes casos:- Una app sin privilegios solicita cualquier prioridad >0.
- Una app con privilegios solicita una prioridad >0 para
ACTION_VIEW
,ACTION_SEND
,ACTION_SENDTO
oACTION_SEND_MULTIPLE
.
Para obtener más información, consulta
setPriority()
. android:order
Es el orden en que se debe procesar el filtro cuando coinciden varios filtros.
order
difiere depriority
en quepriority
se aplica en todas las apps, mientras queorder
desambigua varios filtros que coinciden en una sola app.Si existe la posibilidad de que varios filtros coincidan, usa un intent dirigido en su lugar.
El valor es un número entero, como
100
. Primero se buscan coincidencias con los números más altos. El valor predeterminado es0
.Este atributo se agregó en el nivel de API 28.
android:autoVerify
- Determina si Android debe verificar que el archivo JSON de Vínculos de recursos digitales del host especificado coincide con esta aplicación.
Para obtener más información, consulta Cómo verificar Android App Links.
El valor predeterminado es
false
.Este atributo se agregó en el nivel de API 23.
- primera inclusión:
- Nivel de API 1
- consulta también:
<action>
<category>
<data>
<uri-relative-filter-group>
<filtro de intents>
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[null,null,["Última actualización: 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)"]]