Управляйте всеми файлами на устройстве хранения

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

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

Запросить доступ ко всем файлам

Приложение может запросить у пользователя доступ ко всем файлам, выполнив следующие действия:

  1. Объявите разрешение MANAGE_EXTERNAL_STORAGE в манифесте.
  2. Используйте действие намерения ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION , чтобы направить пользователей на страницу настроек системы, где они смогут включить следующую опцию для вашего приложения: Разрешить доступ для управления всеми файлами .

Чтобы определить, предоставлено ли вашему приложению разрешение MANAGE_EXTERNAL_STORAGE , вызовите Environment.isExternalStorageManager() .

Операции, разрешенные MANAGE_EXTERNAL_STORAGE

Разрешение MANAGE_EXTERNAL_STORAGE предоставляет следующее:

  • Доступ для чтения и записи ко всем файлам в общем хранилище .

  • Доступ к содержимому таблицы MediaStore.Files .

  • Доступ к корневому каталогу как USB-накопителя (OTG), так и SD-карты.

  • Доступ для записи ко всем внутренним каталогам хранилища, кроме /Android/data/ , /sdcard/Android и большинства подкаталогов /sdcard/Android . Этот доступ включает прямой доступ к пути к файлу .

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

Если у приложения есть разрешение MANAGE_EXTERNAL_STORAGE , оно может получить доступ к этим дополнительным файлам и каталогам, используя API MediaStore или прямые пути к файлам . Однако при использовании Storage Access Framework доступ к файлу или каталогу возможен только без разрешения MANAGE_EXTERNAL_STORAGE .

Вызовите функцию управления хранилищем другого приложения

В Android 12 (уровень API 31) и выше приложения, имеющие как разрешение MANAGE_EXTERNAL_STORAGE , так и разрешение QUERY_ALL_PACKAGES (например, приложения для управления файлами), могут использовать метод getManageSpaceActivityIntent() для отправки пользователей в пользовательское действие по управлению пространством другого приложения.

Метод getManageSpaceActivityIntent() принимает имя пакета и код запроса и возвращает одно из следующих значений:

  • PendingIntent , если приложение с указанным именем пакета определило пользовательское действие «управление пространством». Приложение для управления файлами, вызвавшее метод getManageSpaceActivityIntent() может затем использовать возвращённое намерение для перенаправления пользователей к пользовательскому действию.
  • null , если приложение с указанным именем пакета не определяет действие «управление пространством».

Включить MANAGE_EXTERNAL_STORAGE для тестирования

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

adb shell appops set --uid PACKAGE_NAME MANAGE_EXTERNAL_STORAGE allow

Уведомление Google Play

В этом разделе содержится уведомление для разработчиков, публикующих приложения в Google Play.

Чтобы ограничить широкий доступ к общему хранилищу, магазин Google Play обновил свою политику, которая теперь оценивает приложения, предназначенные для Android 11 (API уровня 30) и выше, и запрашивающие доступ ко всем файлам через разрешение MANAGE_EXTERNAL_STORAGE . Эта политика действует с мая 2021 года.

Если ваше приложение предназначено для Android 11 или более поздней версии и объявляет разрешение MANAGE_EXTERNAL_STORAGE , Android Studio выводит предупреждение lint, показанное на рисунке 1. Это предупреждение напоминает вам о том, что в магазине Google Play есть политика, ограничивающая использование разрешения.

Рисунок 1. Предупреждение Lint в Android Studio, которое напоминает разработчикам о политике Google Play относительно разрешения MANAGE_EXTERNAL_STORAGE .

Запрашивайте разрешение MANAGE_EXTERNAL_STORAGE только в том случае, если ваше приложение не может эффективно использовать более конфиденциальные API, такие как Storage Access Framework или Media Store API . Использование разрешения вашим приложением должно соответствовать разрешенным вариантам использования и быть напрямую связано с его основными функциями. Если ваше приложение включает в себя сценарий использования, аналогичный любому из следующих, вероятно, оно может запросить разрешение MANAGE_EXTERNAL_STORAGE :

  • Файловые менеджеры
  • Резервное копирование и восстановление приложений
  • Антивирусные приложения
  • Приложения для управления документами
  • Поиск файлов на устройстве
  • Шифрование дисков и файлов
  • Миграция данных с устройства на устройство