Большинство приложений, которым требуется доступ к общему хранилищу, могут использовать рекомендации по обмену медиафайлами и файлами, не относящимися к медиафайлам . Однако некоторые приложения имеют основной сценарий использования, требующий широкого доступа к файлам на устройстве, но не могут эффективно использовать конфиденциальные рекомендации по хранению данных. Для таких ситуаций Android предоставляет специальный доступ к приложениям, называемый доступом ко всем файлам .
Например, основной сценарий использования антивирусного приложения может предполагать регулярное сканирование множества файлов в разных каталогах. Если такое сканирование требует многократного взаимодействия пользователя с каталогами с помощью системного средства выбора файлов, это создаёт неудобства для пользователя. Другие сценарии использования, такие как файловые менеджеры, приложения для резервного копирования и восстановления данных, а также приложения для управления документами, требуют аналогичных решений.
Запросить доступ ко всем файлам
Приложение может запросить у пользователя доступ ко всем файлам, выполнив следующие действия:
- Объявите разрешение
MANAGE_EXTERNAL_STORAGE
в манифесте. - Используйте действие намерения
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 есть политика, ограничивающая использование разрешения.
MANAGE_EXTERNAL_STORAGE
. Запрашивайте разрешение MANAGE_EXTERNAL_STORAGE
только в том случае, если ваше приложение не может эффективно использовать более конфиденциальные API, такие как Storage Access Framework или Media Store API . Использование разрешения вашим приложением должно соответствовать разрешенным вариантам использования и быть напрямую связано с его основными функциями. Если ваше приложение включает в себя сценарий использования, аналогичный любому из следующих, вероятно, оно может запросить разрешение MANAGE_EXTERNAL_STORAGE
:
- Файловые менеджеры
- Резервное копирование и восстановление приложений
- Антивирусные приложения
- Приложения для управления документами
- Поиск файлов на устройстве
- Шифрование дисков и файлов
- Миграция данных с устройства на устройство