Как задекларировать необходимость доступа к списку пакетов

При создании приложения важно учитывать, с какими другими приложениями на устройстве оно должно взаимодействовать. Если целевой уровень 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> можно использовать каждый из следующих атрибутов не более одного раза:

    • mimeType
    • scheme
    • host

    Эти атрибуты можно распределить по нескольким элементам <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.