<filtro-intent>

sintassi:

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

contenuto in:

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

deve contenere:

<action>

può contenere:

<category>
<data>

description:

Specifica i tipi di intent che un'attività, un servizio o un annuncio il destinatario può rispondere. Un filtro per intent dichiara le funzionalità dei suoi componente principale: cosa può fare un'attività o un servizio e quali tipi di trasmissioni che un ricevitore può gestire.

Apre il componente alla ricezione intent del tipo pubblicizzato, filtrando quelli che non significativo per il componente. La maggior parte dei contenuti del filtro sono descritti tramite <action>, <category> e <data> sottoelementi.

Per una discussione più dettagliata sui filtri, consulta Intenzioni e i filtri per intent e Filtri per intent nella panoramica del file manifest dell'app.

attributi:

android:icon

Un'icona che rappresenta l'attività, il servizio o la trasmissione principale destinatario quando il componente viene presentato all'utente come avente descritta dal filtro.

Questo attributo è impostato come riferimento a una risorsa disegnabile contenente la definizione dell'immagine. Il valore predefinito è l'icona impostata dall'attributo icon del componente principale. Se il publisher principale non specifica un'icona, l'impostazione predefinita è l'icona impostata Elemento <application>.

Per saperne di più sulle icone dei filtri per intent, consulta Icone ed etichette nella panoramica del file manifest dell'app.

android:label

Un'etichetta leggibile per il componente principale. Questa etichetta, invece di quella impostata dal componente principale viene utilizzata quando il componente viene presentato per l'utente in quanto avente la funzionalità descritta dal filtro.

L'etichetta è impostata come riferimento a una risorsa stringa, in modo che può essere localizzata come altre stringhe nell'interfaccia utente. Tuttavia, per comodità durante lo sviluppo dell'applicazione, può anche essere impostato come stringa non elaborata.

Il valore predefinito è l'etichetta impostata dal componente principale. Se principale non specifica un'etichetta, l'impostazione predefinita è l'etichetta impostata dalla Di <application> elemento Attributo label.

Per saperne di più sulle etichette dei filtri per intent, consulta Icone ed etichette nella panoramica del file manifest dell'app.

android:priority

La priorità data al componente principale in relazione per la gestione degli intent del tipo descritto dal filtro. Questo attributo ha sia per le attività che per i broadcast receiver.

• Fornisce informazioni sulla capacità di un'attività di rispondere un intent che corrisponde al filtro, rispetto ad altre attività che possono rispondono all'intento. Quando un intent può essere gestito da più attività con priorità diverse, Android prende in considerazione solo quelle con valori con priorità più elevata come potenziali target per l'intento.

• Controlla l'ordine in cui i broadcast receiver vengono eseguiti ricevono annunci, mentre quelli con priorità più alta chiamati prima di quelli con valori più bassi. L'ordine si applica solo ai messaggi sincroni. Viene ignorato per i messaggi asincroni.

Utilizza questo attributo solo se devi imporre un ordine specifico in quali gli annunci vengono ricevuti o che vogliono obbligare Android a preferire un'attività rispetto alle altre.

Il valore è un numero intero, ad esempio 100. I numeri più alti hanno un una priorità più elevata. Il valore predefinito è 0.

In determinate circostanze, la priorità richiesta viene ignorata e il valore è limitato a 0. Ciò si verifica quando:

• Un'applicazione senza privilegi richiede una priorità maggiore di 0.
• Un'applicazione con privilegi richiede una priorità >0 per ACTION_VIEW, ACTION_SEND, ACTION_SENDTO o ACTION_SEND_MULTIPLE.

Per ulteriori informazioni, vedi setPriority().

android:order

L'ordine in cui viene elaborato il filtro quando più filtri corrispondono.

order è diverso da priority in quanto si applicano priority tra le app, mentre order distingue più filtri corrispondenti in un singolo dell'app.

Quando più filtri possono corrispondere, utilizza invece un intent diretto.

Il valore è un numero intero, ad esempio 100. I numeri più alti vengono abbinati per primi. Il valore predefinito è 0.

Questo attributo è stato introdotto nel livello API 28.

android:autoVerify

Se Android deve verificare che il file JSON Digital Asset Links dell'elemento specificato corrisponde a questa applicazione.

Per ulteriori informazioni, vedi Verifica i link per app Android.

Il valore predefinito è false.

Questo attributo è stato introdotto nel livello API 23.

introdotto in:

Livello API 1

vedi anche:

<action>
<category>
<data>