<filtre-intent>

Syntaxe :

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

contenu dans :

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

doit contenir :

<action>

peut contenir :

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

description :

Précise les types d'intents auxquels une activité, un service ou un broadcast receiver peut répondre. Un filtre d'intent précise les caractéristiques de son composant parent, c'est-à-dire ce qu'une activité ou un service peut faire et les types de broadcasts qu'un receiver peut traiter.

Il permet au composant de recevoir des intents du type annoncé, tout en filtrant ceux qui ne sont pas pertinents pour le composant. La plupart du contenu du filtre est décrit par ses sous-éléments:

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

Pour une présentation plus détaillée des filtres, consultez les sections Intents et filtres d'intents, ainsi que la section Filtres d'intent dans la présentation du fichier manifeste d'application.

Attributs :

android:icon

Icône représentant l'activité, le service ou le broadcast receiver parent lorsque ce composant est présenté à l'utilisateur comme ayant la caractéristique décrite par le filtre.

Cet attribut est défini comme référence à une ressource drawable contenant la définition de l'image. La valeur par défaut est l'icône définie par l'attribut icon du composant parent. Si le composant parent ne définit pas d'icône, la valeur par défaut est celle définie par l'élément <application>.

Pour en savoir plus sur les icônes de filtre d'intent, consultez la section Icônes et libellés dans la présentation du fichier manifeste de l'application.

android:label

Libellé lisible pour le composant parent. Ce libellé, plutôt que celui défini par le composant parent, est utilisé lorsque le composant est présenté à l'utilisateur comme ayant la caractéristique décrite par le filtre.

Le libellé est défini comme une référence à une ressource de chaîne, de sorte qu'il puisse être localisé comme les autres chaînes de l'interface utilisateur. Toutefois, lorsque vous développez l'application, vous pouvez également le définir comme une chaîne brute.

La valeur par défaut est le libellé défini par le composant parent. Si le composant parent ne définit pas de libellé, la valeur par défaut est celle définie par l'attribut label de l'élément <application>.

Pour en savoir plus sur les libellés de filtre d'intent, consultez la section Icônes et libellés dans la présentation du fichier manifeste de l'application.

android:priority

Priorité accordée au composant parent pour gérer les intents du type décrit par le filtre. Cet attribut est pertinent pour les activités et les broadcast receivers.

• Il fournit des informations sur la capacité d'une activité à répondre à un intent correspondant au filtre, par rapport aux autres activités qui peuvent également répondre à l'intent. Lorsqu'un intent peut être géré par plusieurs activités avec des priorités différentes, Android ne prend en compte que celles ayant des valeurs de priorité plus élevées comme cibles potentielles de l'intent.

• Il contrôle l'ordre d'exécution des broadcast receivers pour recevoir les annonces. Ceux ayant des valeurs de priorité plus élevées sont appelés avant ceux dont les valeurs sont inférieures. L'ordre ne s'applique qu'aux messages synchrones. Il est ignoré pour les messages asynchrones.

N'utilisez cet attribut que si vous devez imposer un ordre spécifique de réception des broadcasts ou forcer Android à privilégier une activité plutôt qu'une autre.

Cette valeur doit être un entier (par exemple, 100). Plus le nombre est élevé, plus sa priorité est élevée. La valeur par défaut est 0.

Dans certains cas, la priorité demandée est ignorée, et la valeur est limitée à 0. Cela se produit si :

• une application non privilégiée requiert une priorité supérieure à 0 ;
• une application privilégiée requiert une priorité supérieure à 0 pour ACTION_VIEW, ACTION_SEND, ACTION_SENDTO ou ACTION_SEND_MULTIPLE.

Pour en savoir plus, consultez setPriority().

android:order

Ordre dans lequel le filtre est traité lorsque plusieurs filtres correspondent.

order diffère de priority dans la mesure où priority s'applique à toutes les applications, tandis que order fait la distinction entre plusieurs filtres correspondants dans une seule application.

Si plusieurs filtres peuvent correspondre, utilisez plutôt un intent orienté.

La valeur doit être un entier (par exemple, 100). Les nombres les plus élevés sont mis en correspondance en premier. La valeur par défaut est 0.

Cet attribut a été introduit dans le niveau d'API 28.

android:autoVerify

Indique si Android doit vérifier que le fichier JSON Digital Asset Links de l'hôte spécifié correspond à cette application.

Pour en savoir plus, consultez Valider les liens d'application Android.

La valeur par défaut est false.

Cet attribut a été introduit dans le niveau d'API 23.

Première apparition :

Niveau d'API 1

Voir aussi :

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