- syntax:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > ... </intent-filter>
- contenuti in:
<activity>
<activity-alias>
<service>
<receiver>
<provider>
- Deve contenere:
<action>
- può contenere:
<category>
<data>
<uri-relative-filter-group>
- description:
- Specifica i tipi di intent a cui può rispondere un'attività, un servizio o un ricevitore di trasmissione. Un filtro per intent dichiara le funzionalità del suo componente principale: cosa può fare un'attività o un servizio e quali tipi di trasmissioni può gestire un ricevitore.
Il componente viene aperto per ricevere intent del tipo pubblicizzato, escludendo quelli non significativi per il componente. La maggior parte dei contenuti del filtro è descritta dai relativi elementi secondari:
Per una discussione più dettagliata sui filtri, consulta la sezione Intent e filtri per intent e la sezione Filtri per intent nella panoramica del manifest dell'app.
- attributes:
android:icon
- Un'icona che rappresenta l'attività, il servizio o il ricevitore di trasmissione principale quando questo componente viene presentato all'utente come dotato della funzionalità descritta dal filtro.
Questo attributo viene impostato come riferimento a una risorsa drawable contenente la definizione dell'immagine. Il valore predefinito è l'icona impostata dall'attributo
icon
del componente principale. Se l'elemento principale non specifica un'icona, il valore predefinito è l'icona impostata dall'elemento<application>
.Per saperne di più sulle icone dei filtri di intent, consulta la sezione Icone ed etichette nella panoramica del file manifest dell'app.
android:label
- Un'etichetta leggibile dall'utente per il componente principale. Questa etichetta, anziché quella impostata dal componente principale, viene utilizzata quando il componente viene presentato all'utente come dotato della funzionalità descritta dal filtro.
L'etichetta viene impostata come riferimento a una risorsa stringa in modo che possa essere localizzata come le altre stringhe nell'interfaccia utente. Tuttavia, per praticità durante lo sviluppo dell'applicazione, puoi impostarlo anche come stringa non elaborata.
Il valore predefinito è l'etichetta impostata dal componente principale. Se l'elemento primario non specifica un'etichetta, il valore predefinito è l'etichetta impostata dall'attributo
label
dell'elemento<application>
.Per saperne di più sulle etichette dei filtri di intent, consulta la sezione Icone ed etichette nella panoramica del file manifest dell'app.
android:priority
- La priorità assegnata al componente principale per quanto riguarda la gestione degli intent del tipo descritto dal filtro. Questo attributo ha un significato sia per le attività sia per i ricevitori di trasmissione.
- Fornisce informazioni sulla capacità di un'attività di rispondere a un intento corrispondente al filtro rispetto ad altre attività che possono anche rispondere all'intento. Quando un'intent può essere gestita da più attività con priorità diverse, Android considera come potenziali target per l'intent solo quelle con valori di priorità più elevati.
Controlla l'ordine in cui vengono eseguiti i ricevitori di trasmissione per ricevere i messaggi di trasmissione, con quelli che hanno valori di priorità più elevati che vengono 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 cui vengono ricevute le trasmissioni o se vuoi forzare Android a preferire un'attività rispetto alle altre.
Il valore è un numero intero, ad esempio
100
. I numeri più elevati hanno una priorità maggiore. Il valore predefinito è0
.In alcuni casi, la priorità richiesta viene ignorata e il valore viene limitato a
0
. Ciò si verifica quando:- Un'applicazione non privilegiata richiede una priorità maggiore o uguale a 0.
- Un'applicazione privilegiata richiede una priorità > 0 per
ACTION_VIEW
,ACTION_SEND
,ACTION_SENDTO
oACTION_SEND_MULTIPLE
.
Per ulteriori informazioni, vedi
setPriority()
. android:order
L'ordine in cui viene elaborato il filtro quando più filtri corrispondono.
order
è diverso dapriority
in quantopriority
si applica su più app, mentreorder
risolve i dubbi relativi a più filtri di corrispondenza in un'unica app.Quando più filtri possono corrispondere, utilizza un'intenzione diretta.
Il valore è un numero intero, ad esempio
100
. I numeri più alti vengono associati 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'host specificato corrisponda a questa applicazione.
Per ulteriori informazioni, consulta Verificare Android App Links.
Il valore predefinito è
false
.Questo attributo è stato introdotto nel livello API 23.
- introdotto in:
- Livello API 1
- Vedi anche:
<action>
<category>
<data>
<uri-relative-filter-group>
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2024-12-21 UTC.
[null,null,["Ultimo aggiornamento 2024-12-21 UTC."],[],[]]