При создании приложения важно учитывать, с какими другими приложениями на устройстве оно должно взаимодействовать. Если целевой уровень API вашего приложения – 30 (Android 11) или выше, система автоматически делает некоторые приложения видимыми для вашего приложения, но по умолчанию отфильтровывает другие. В этом руководстве описано, как сделать другие приложения видимыми для вашего.
Если ваше приложение предназначено для Android 11 или более поздней версии и должно взаимодействовать с другими приложениями, кроме тех, которые видны автоматически, добавьте элемент <queries> в файл манифеста. В элементе <queries> укажите другие приложения по названию пакета, по сигнатуре намерения или по поставщику, как описано в следующих разделах.
Названия пакетов
Если вы знаете, к каким приложениям хотите обращаться или с какими хотите взаимодействовать (например, к тем, которые интегрированы с вашим приложением или сервисы которых вы используете), укажите названия их пакетов в наборе элементов <package> внутри элемента <queries>:
<manifest package="com.example.game">
<queries>
<package android:name="com.example.store" />
<package android:name="com.example.services" />
</queries>
...
</manifest>
Как взаимодействовать с основным приложением в библиотеке
Если вы разрабатываете библиотеку Android, то можете указать, какие пакеты должны быть видны, добавив элемент <queries> в файл манифеста AAR. Этот элемент <queries> имеет те же функции, что и элемент, который приложения могут объявлять в своих манифестах.
Если библиотека взаимодействует с основным приложением, например использует привязанную службу, добавьте элемент <package>, в котором указано название пакета основного приложения:
<!-- Place inside the <queries> element. --> <package android:name=PACKAGE_NAME />
Добавив эту декларацию, вы сможете проверять, установлено ли основное приложение, и взаимодействовать с ним, например вызывать bindService(). В результате этого взаимодействия приложение для звонков, использующее вашу библиотеку, автоматически становится видимым для основного приложения.
Пакеты, соответствующие сигнатуре фильтра интентов
Вашему приложению может потребоваться запрашивать информацию у набора приложений, предназначенных для определенной цели, или взаимодействовать с ними, но вы можете не знать конкретные названия пакетов, которые нужно включить. В этом случае вы можете перечислить сигнатуры фильтров интентов в элементе <queries>. Ваше приложение сможет находить приложения с совпадающими элементами <intent-filter>.
В примере кода ниже показан элемент <intent>, который позволяет приложению видеть другие установленные приложения, поддерживающие обмен изображениями в формате JPEG:
<manifest package="com.example.game">
<queries>
<intent>
<action android:name="android.intent.action.SEND" />
<data android:mimeType="image/jpeg" />
</intent>
</queries>
...
</manifest>
Для элемента <intent> действует несколько ограничений:
- Необходимо добавить ровно один элемент
<action>. - В элементе
<data>нельзя использовать атрибутыpath,pathPrefix,pathPatternиport. Система будет работать так, как если бы вы установили для каждого атрибута значение подстановочного символа (*). - Нельзя использовать атрибут
mimeGroupэлемента<data>. В элементах
<data>одного элемента<intent>можно использовать каждый из следующих атрибутов не более одного раза:mimeTypeschemehost
Эти атрибуты можно распределить по нескольким элементам
<data>или использовать в одном элементе<data>.
Элемент <intent> поддерживает подстановочный знак (*) в качестве значения для нескольких атрибутов:
- Атрибут
nameэлемента<action>. - Подтип атрибута
mimeTypeэлемента<data>(image/*). - Тип и подтип атрибута
mimeTypeэлемента<data>(*/*). - Атрибут
schemeэлемента<data>. - Атрибут
hostэлемента<data>.
Если в предыдущем списке не указано иное, система не поддерживает сочетание текста и подстановочных знаков, например prefix*.
Пакеты, использующие определенный центр сертификации.
Если вам нужно отправить запрос поставщику контента, но вы не знаете названия пакетов, укажите его в элементе <provider>, как показано в следующем фрагменте кода:
<manifest package="com.example.suite.enterprise"> <queries> <provider android:authorities="com.example.settings.files" /> </queries> ... </manifest>
Вы можете объявить поставщиков в одном элементе <queries>. В элементе <queries> можно объявить один или несколько элементов <provider>. Элемент <provider> может содержать один или несколько разделенных точкой с запятой идентификаторов поставщиков.
Все приложения (не рекомендуется)
В редких случаях приложению может потребоваться запросить информацию обо всех установленных на устройстве приложениях или взаимодействовать с ними независимо от того, какие компоненты они содержат. Чтобы ваше приложение могло видеть все остальные установленные приложения, система предоставляет разрешение QUERY_ALL_PACKAGES.
Вот несколько примеров, когда разрешение QUERY_ALL_PACKAGES может быть уместно:
- Приложения для доступа к специальным возможностям
- Браузеры
- Приложения для управления устройствами
- Приложения для обеспечения безопасности
- Антивирусы
Однако обычно для работы приложения достаточно взаимодействовать с набором автоматически видимых приложений и объявить в файле манифеста другие приложения, к которым вашему приложению нужен доступ. Чтобы не нарушать конфиденциальность пользователей, запрашивайте минимальный уровень доступа, необходимый для работы приложения.
В обновленных правилах Google Play приведены рекомендации для приложений, которым требуется разрешение QUERY_ALL_PACKAGES.