- sintaxe:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > . . . </intent-filter>
- contido em:
<activity>
<activity-alias>
<service>
<receiver>
<provider>
- 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 receptoras
do tipo anunciado e filtra as que não são
significativas 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 uma referência a um recurso drawable que contém a definição da 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 vai 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 é 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 vai 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 é dada ao componente pai em relação
ao gerenciamento das 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 uma intent que corresponde ao filtro, em relação a outras atividades que também podem responder à intent. Quando uma intent puder ser gerenciada por várias atividades com prioridades diferentes, o Android vai considerar apenas aquelas com valores de prioridade mais altos como possíveis destinos para a 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 apenas 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.
A
order
é diferente dapriority
, já que apriority
se aplica entre apps, enquanto aorder
faz a desambiguação de vários filtros correspondentes em um único app.Quando houver correspondência a vários filtros, use uma intent direcionada.
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 no nível 28 da API.
android:autoVerify
- Caso o Android precise verificar se o arquivo JSON do Digital Asset Links do host especificado corresponde a este aplicativo.
Consulte: Verificar Links do app Android
O valor padrão é
false
.Esse atributo foi introduzido no nível 23 da API.
- Implementação:
- Nível 1 da API
- veja também:
<action>
<category>
<data>
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2022-10-12 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Não contém as informações de que eu preciso"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Muito complicado / etapas demais"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Desatualizado"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problema na tradução"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problema com as amostras / o código"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Outro"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Fácil de entender"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Meu problema foi resolvido"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Outro"
}]