<intent-filter>

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:

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

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 ou ACTION_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 da priority, já que a priority se aplica entre apps, enquanto a order 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>