- 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>
- 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>
et<data>
.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 est0
.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
ouACTION_SEND_MULTIPLE
.
Pour en savoir plus, consultez
setPriority()
. android:order
Ordre dans lequel le filtre est traité lorsque plusieurs filtres correspondent.
order
diffère depriority
dans la mesure oùpriority
s'applique à toutes les applications, tandis queorder
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 est0
.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>
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/08/20 (UTC).
[]
[]
{
"last_modified": "Dernière mise à jour le 2024/08/20 (UTC).",
"state": ""
}