- sintaxe:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > . . . </intent-filter>
- contida em:
<activity>
<activity-alias>
<service>
<receiver>
- precisa conter:
<action>
- pode conter:
<category>
<data>
- descrição:
- Especifica os tipos de intents aos quais uma atividade, um serviço ou um broadcast receiver pode responder. Um filtro de intents declara os recursos do componente pai: o que uma atividade ou serviço pode fazer e que tipos de transmissões um receiver pode gerenciar. Ele abre o componente para intents receptores do tipo anunciado e filtra os que não são significativos para o componente.
A maior parte do conteúdo do filtro é descrita pelos subelementos
<action>
,<category>
e<data>
.Para uma discussão mais detalhada sobre filtros, consulte o documento Intents e filtros de intents e a seção Filtros de intents na introdução.
- atributos:
android:icon
- Um ícone que representa a atividade mãe, o serviço ou o broadcast receiver quando esse componente é apresentado ao usuário como tendo a capacidade descrita pelo filtro.
Esse atributo precisa ser definido como referência a um recurso drawable que contém a definição de imagem. O valor padrão é o ícone definido pelo atributo
icon
do componente pai. Se o pai não especificar um ícone, o padrão será o ícone definido pelo elemento<application>
.Para saber mais sobre os ícones de filtros de intents, consulte Ícones e rótulos na introdução.
android:label
- Rótulo legível pelo usuário para o componente pai. Em vez do definido pelo componente pai, esse rótulo é usado quando o componente é apresentado ao usuário como tendo a capacidade descrita pelo filtro.
O rótulo será definido como referência a um recurso de string, para que possa ser localizado como outras strings na interface do usuário. No entanto, para facilitar o desenvolvimento do aplicativo, ele também pode ser definido como uma string bruta.
O valor padrão é o rótulo definido pelo componente pai. Se o pai não especificar um rótulo, o padrão será o rótulo definido pelo atributo
label
do elemento<application>
.Para saber mais sobre os rótulos de filtros de intents, consulte Ícones e rótulos na introdução.
android:priority
- A prioridade que será dada ao componente pai em relação ao gerenciamento de intents do tipo descrito pelo filtro. Esse atributo tem significado para as atividades e os broadcast receivers:
- Ele fornece informações sobre como uma atividade pode responder a um intent que corresponde ao filtro, em relação a outras atividades que também podem responder ao intent. Quando um intent puder ser gerenciado por várias atividades com prioridades diferentes, o Android considerará somente aquelas com valores de prioridade mais altos como possíveis destinos para o intent.
Ele controla a ordem em que os broadcast receivers são executados para receber mensagens de transmissão. Aqueles com valores de prioridade mais altos são chamados antes dos que têm valores mais baixos. A ordem se aplica somente a mensagens síncronas. Ela é ignorada para mensagens assíncronas.
Use esse atributo apenas se você realmente precisar impor uma ordem específica em que as transmissões são recebidas ou se quiser forçar o Android a preferir uma atividade em detrimento de outras.
O valor precisa ser um número inteiro, como "
100
". Números maiores têm prioridade mais alta. O valor padrão é 0.Em determinadas circunstâncias, a prioridade solicitada é ignorada, e o valor é limitado a
0
. Isso ocorre quando:- um aplicativo sem privilégios solicita qualquer prioridade >0;
- um aplicativo privilegiado solicita uma prioridade >0 para
ACTION_VIEW
,ACTION_SEND
,ACTION_SENDTO
ouACTION_SEND_MULTIPLE
.
Consulte também
setPriority()
. android:order
- A ordem em que o filtro será processado quando vários filtros forem correspondentes.
order
é diferente depriority
, já quepriority
se aplica entre apps, enquanto faz a desambiguação de vários filtros correspondentes em um único app.Quando vários filtros puderem ser correspondentes, use um intent direcionado.
O valor precisa ser um número inteiro, como "
100
". Números maiores são correspondidos primeiro. O valor padrão é0
.Esse atributo foi introduzido na API de nível 28.
- primeira aparição:
- API de nível 1
- veja também:
<action>
<category>
<data>
Content and code samples on this page are subject to the licenses described in the Content License. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2019-12-27 UTC.