<намеренный фильтр>

<intent-filter android:icon="drawable resource"
               android:label="string resource"
               android:priority="integer" >
    ...
</intent-filter>

Он открывает компоненту возможность получения намерений объявленного типа, отфильтровывая те, которые не имеют смысла для компонента. Большая часть содержимого фильтра описывается его подэлементами <action> , <category> и <data> .

Более подробное обсуждение фильтров см. в разделах «Намерения» и «Фильтры намерений», а также в разделе «Фильтры намерений» в обзоре манифеста приложения.

android:icon

Значок, который представляет родительское действие, службу или приемник широковещательной передачи, когда этот компонент представлен пользователю как обладающий возможностями, описанными фильтром.

Этот атрибут устанавливается как ссылка на ресурс, который можно рисовать, содержащий определение изображения. Значением по умолчанию является значок, заданный атрибутом icon родительского компонента. Если родительский элемент не указывает значок, по умолчанию используется значок, установленный элементом <application> .

Дополнительные сведения о значках фильтров намерений см. в разделе «Значки и метки» в обзоре манифеста приложения.

android:label

Читаемая пользователем метка родительского компонента. Эта метка, а не метка, установленная родительским компонентом, используется, когда компонент представляется пользователю как обладающий возможностями, описанными фильтром.

Метка задается как ссылка на строковый ресурс, чтобы ее можно было локализовать, как и другие строки в пользовательском интерфейсе. Однако для удобства при разработке приложения его также можно задать как необработанную строку.

Значением по умолчанию является метка, установленная родительским компонентом. Если родительский элемент не указывает метку, по умолчанию используется метка, установленная атрибутом label элемента <application> .

Дополнительные сведения о метках фильтра намерений см. в разделе «Значки и метки» обзора манифеста приложения.

android:priority

Приоритет, отдаваемый родительскому компоненту относительно намерений обработки типа, описанного фильтром. Этот атрибут имеет значение как для действий, так и для получателей широковещательных сообщений.

• Он предоставляет информацию о том, насколько действие способно реагировать на намерение, соответствующее фильтру, по сравнению с другими действиями, которые также могут реагировать на намерение. Когда намерение может быть обработано несколькими действиями с разными приоритетами, Android рассматривает только действия с более высокими значениями приоритета в качестве потенциальных целей для намерения.

• Он управляет порядком, в котором приемники широковещательных сообщений выполняются для приема широковещательных сообщений, при этом те, которые имеют более высокие значения приоритета, вызываются раньше тех, которые имеют более низкие значения. Порядок применяется только к синхронным сообщениям. Он игнорируется для асинхронных сообщений.

Используйте этот атрибут только в том случае, если вам нужно установить определенный порядок получения широковещательных сообщений или вы хотите заставить Android отдавать предпочтение одному действию над другими.

Значение представляет собой целое число, например 100 . Более высокие числа имеют более высокий приоритет. Значение по умолчанию — 0 .

В определенных обстоятельствах запрошенный приоритет игнорируется, а значение ограничивается значением 0 . Это происходит, когда:

• Непривилегированное приложение запрашивает любой приоритет >0.
• Привилегированное приложение запрашивает приоритет >0 для ACTION_VIEW , ACTION_SEND , ACTION_SENDTO или ACTION_SEND_MULTIPLE .

Для получения дополнительной информации см. setPriority() .

android:order

Порядок обработки фильтра при совпадении нескольких фильтров.

order отличается от priority тем, что priority применяется ко всем приложениям, а order устраняет неоднозначность нескольких совпадающих фильтров в одном приложении.

Если могут совпадать несколько фильтров, вместо этого используйте направленное намерение.

Значение представляет собой целое число, например 100 . В первую очередь сопоставляются более высокие числа. Значение по умолчанию — 0 .

Этот атрибут был введен на уровне API 28.

android:autoVerify

Необходимо ли Android проверять, соответствует ли файл JSON Digital Asset Links с указанного хоста этому приложению.

Дополнительную информацию см. в разделе «Проверка ссылок на приложения Android» .

Значение по умолчанию — false .

Этот атрибут был введен на уровне API 23.

<intent-filter android:icon="drawable resource"
               android:label="string resource"
               android:priority="integer" >
    ...
</intent-filter>

Он открывает компоненту возможность получения намерений объявленного типа, отфильтровывая те, которые не имеют смысла для компонента. Большая часть содержимого фильтра описывается его подэлементами <action> , <category> и <data> .

Более подробное обсуждение фильтров см. в разделах «Намерения» и «Фильтры намерений», а также в разделе «Фильтры намерений» в обзоре манифеста приложения.

android:icon

Значок, который представляет родительское действие, службу или приемник широковещательной передачи, когда этот компонент представлен пользователю как обладающий возможностями, описанными фильтром.

Этот атрибут устанавливается как ссылка на ресурс, который можно рисовать, содержащий определение изображения. Значением по умолчанию является значок, заданный атрибутом icon родительского компонента. Если родительский элемент не указывает значок, по умолчанию используется значок, установленный элементом <application> .

Дополнительные сведения о значках фильтров намерений см. в разделе «Значки и метки» в обзоре манифеста приложения.

android:label

Читаемая пользователем метка родительского компонента. Эта метка, а не метка, установленная родительским компонентом, используется, когда компонент представляется пользователю как обладающий возможностями, описанными фильтром.

Метка задается как ссылка на строковый ресурс, чтобы ее можно было локализовать, как и другие строки в пользовательском интерфейсе. Однако для удобства при разработке приложения его также можно задать как необработанную строку.

Значением по умолчанию является метка, установленная родительским компонентом. Если родительский элемент не указывает метку, по умолчанию используется метка, установленная атрибутом label элемента <application> .

Дополнительные сведения о метках фильтра намерений см. в разделе «Значки и метки» обзора манифеста приложения.

android:priority

Приоритет, отдаваемый родительскому компоненту относительно намерений обработки типа, описанного фильтром. Этот атрибут имеет значение как для действий, так и для получателей широковещательных сообщений.

• Он предоставляет информацию о том, насколько действие способно реагировать на намерение, соответствующее фильтру, по сравнению с другими действиями, которые также могут реагировать на намерение. Когда намерение может быть обработано несколькими действиями с разными приоритетами, Android рассматривает только действия с более высокими значениями приоритета в качестве потенциальных целей для намерения.

• Он управляет порядком, в котором приемники широковещательных сообщений выполняются для приема широковещательных сообщений, при этом те, которые имеют более высокие значения приоритета, вызываются раньше тех, которые имеют более низкие значения. Порядок применяется только к синхронным сообщениям. Он игнорируется для асинхронных сообщений.

Используйте этот атрибут только в том случае, если вам нужно установить определенный порядок получения широковещательных сообщений или вы хотите заставить Android отдавать предпочтение одному действию над другими.

Значение представляет собой целое число, например 100 . Более высокие числа имеют более высокий приоритет. Значение по умолчанию — 0 .

В определенных обстоятельствах запрошенный приоритет игнорируется, а значение ограничивается значением 0 . Это происходит, когда:

• Непривилегированное приложение запрашивает любой приоритет >0.
• Привилегированное приложение запрашивает приоритет >0 для ACTION_VIEW , ACTION_SEND , ACTION_SENDTO или ACTION_SEND_MULTIPLE .

Для получения дополнительной информации см. setPriority() .

android:order

Порядок обработки фильтра при совпадении нескольких фильтров.

order отличается от priority тем, что priority применяется ко всем приложениям, а order устраняет неоднозначность нескольких совпадающих фильтров в одном приложении.

Если могут совпадать несколько фильтров, вместо этого используйте направленное намерение.

Значение представляет собой целое число, например 100 . В первую очередь сопоставляются более высокие числа. Значение по умолчанию — 0 .

Этот атрибут был введен на уровне API 28.

android:autoVerify

Необходимо ли Android проверять, соответствует ли файл JSON Digital Asset Links с указанного хоста этому приложению.

Дополнительную информацию см. в разделе «Проверка ссылок на приложения Android» .

Значение по умолчанию — false .

Этот атрибут был введен на уровне API 23.