- 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>
<uri-relative-filter-group>
- descrição:
- Especifica os tipos de intents aos quais uma atividade, um serviço ou um broadcast
receiver pode responder. Um filtro de intent declara as capabilities do
componente pai: o que uma atividade ou um serviço pode fazer e que tipos
de transmissões um receiver pode gerenciar.
Ele abre o componente para receber intents do tipo anunciado e, ao mesmo tempo, filtrar as que não são significativas para o componente. A maior parte do conteúdo do filtro é descrita pelos subelementos:
Para uma discussão mais detalhada sobre filtros, consulte Intents e filtros de intent e a seção Filtros de intent na visão geral do manifesto do app.
- 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 capability descrita pelo filtro.
Esse atributo é 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 será o definido pelo elemento<application>
.Para mais informações sobre ícones de filtro de intent, consulte a seção Ícones e rótulos na visão geral do manifesto do app.
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 capability descrita pelo filtro.
O rótulo é definido como referência a um recurso de string para que possa ser localizado como outras strings da interface do usuário. No entanto, para facilitar o desenvolvimento do app, 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 definido pelo atributo
label
do elemento<application>
.Para mais informações sobre os rótulos de filtros de intent, consulte a seção Ícones e rótulos na visão geral do manifesto do app.
android:priority
- A prioridade dada ao componente pai em relação
ao processamento 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 uma intent que corresponde ao filtro em relação a outras atividades que também podem responder à intent. Quando uma intent pode ser processada por várias atividades com prioridades diferentes, o Android considera 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, com aqueles que têm valores de prioridade mais altos sendo chamados antes dos que têm valores mais baixos. A ordem se aplica apenas a mensagens síncronas. Ela é ignorada nas 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 é 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 app sem privilégios solicita qualquer prioridade maior que 0;
- um app privilegiado solicita uma prioridade maior que 0 para
ACTION_VIEW
,ACTION_SEND
,ACTION_SENDTO
ouACTION_SEND_MULTIPLE
.
Para mais informações, consulte
setPriority()
. android:order
A ordem em que o filtro é processado quando vários filtros são 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 é um número inteiro, como
100
. A correspondência dos números mais altos é feita primeira. O valor padrão é0
.Esse atributo foi aplicado 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 esse app.
Para mais informações, consulte Verificar Links do app Android.
O valor padrão é
false
.Esse atributo foi aplicado no nível 23 da API.
- aplicado no:
- Nível 1 da API
- confira também:
<action>
<category>
<data>
<uri-relative-filter-group>
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 2024-12-02 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-12-02 UTC."],[],[]]