KappS Base de conocimiento · Preguntas frecuentes

Política de MANAGE_EXTERNAL_STORAGE (acceso a todos los archivos) en Google Play

Preguntas frecuentes Permisos y API

1. Qué es realmente la política. Google Play trata el acceso a todos los archivos como un acceso especial de app de alto riesgo. "Google Play restringe el uso de permisos de alto riesgo o sensibles, incluido el acceso especial de app llamado acceso a todos los archivos. Esto solo se aplica a las apps que tienen como target Android 11 (nivel de API 30) y declaran el permiso MANAGE_EXTERNAL_STORAGE, que se añade en Android 11. Además, esta política no afecta al uso del permiso READ_EXTERNAL_STORAGE". (https://support.google.com/googleplay/android-developer/answer/10467955)

2. Si no la necesitas, debes quitarla del manifiesto. Esta es la corrección más habitual para un rechazo de revisión relacionado con permisos: "If your app does not require access to the MANAGE_EXTERNAL_STORAGE permission, you must remove it from your app's manifest in order to successfully meet the policy review requirements. Details on policy-compliant alternative implementations are also enumerated below." (https://support.google.com/googleplay/android-developer/answer/10467955)

3. Si realmente lo necesitas, la declaración es obligatoria, y omitirla es en sí mismo una infracción. "Si tu app cumple los requisitos de política para el uso aceptable o es elegible para una excepción, deberás declararlo, junto con cualquier otro permiso de alto riesgo, mediante el Formulario de declaración de permisos en Play Console". Y: "Las apps que no cumplan los requisitos de política o no envíen un Formulario de declaración de permisos podrán ser retiradas de Google Play". (https://support.google.com/googleplay/android-developer/answer/10467955)

4. El criterio es "no existe una alternativa efectiva", no "es conveniente". "Solo debes acceder al permiso de acceso a todos los archivos cuando tu app no pueda aprovechar de forma efectiva las buenas prácticas más respetuosas con la privacidad, como el Storage Access Framework o la API de MediaStore. Ten en cuenta que tu app no debe declarar permisos que no necesita o no usa." (https://support.google.com/googleplay/android-developer/answer/10467955)

5. La funcionalidad principal la define Google, y debe ser visible en tu ficha de la tienda. "Además, el uso que la app hace del permiso debe encajar en los usos permitidos y estar directamente vinculado a la funcionalidad principal de la app. La funcionalidad principal se define como el propósito principal de la app. Sin esta funcionalidad principal, la app está "rota" o queda inutilizable. La funcionalidad principal, así como cualquier función esencial que la componga, debe documentarse y promocionarse de forma destacada en la descripción de la app". "Cuando la funcionalidad principal de una app requiere el permiso de acceso a todos los archivos, el desarrollador debe completar el Formulario de declaración de permisos y obtener la aprobación de Google Play". (https://support.google.com/googleplay/android-developer/answer/10467955)

6. La lista de usos permitidos y su asterisco. «Para las apps que solicitan acceso al permiso de acceso a todos los archivos, el uso previsto y permitido incluye gestores de archivos, apps de copia de seguridad y restauración, apps antivirus y apps de gestión de documentos». La tabla de la política añade: gestión de archivos («el propósito principal de la app implica el acceso, la edición y la gestión (incluido el mantenimiento) de archivos y carpetas fuera de su espacio de almacenamiento específico»), copia de seguridad y restauración («la app debe necesitar acceder automáticamente a varios directorios fuera de su espacio de almacenamiento específico con fines de copia de seguridad y restauración»), antivirus («el propósito principal de la app es analizar el dispositivo y ofrecer al usuario funciones de seguridad antivirus»), gestión de documentos («apps que deben localizar, acceder y editar tipos de archivo compatibles fuera de su almacenamiento específico o compartido»), búsqueda en el dispositivo, cifrado y bloqueo de discos y carpetas, y migración de dispositivos o transferencia entre teléfonos. Cada fila lleva la nota al pie «* Sujeto a revisión y aprobación de Google Play», y «las apps a las que se concede acceso a este permiso no pueden ampliar su uso a fines no divulgados o no válidos». (https://support.google.com/googleplay/android-developer/answer/10467955)

7. Qué consigue una excepción temporal. "Google Play puede conceder una excepción temporal a las apps que no cumplan los usos permitidos designados anteriormente cuando: el uso del permiso habilita la funcionalidad principal de la app; actualmente no existe un método alternativo para proporcionar la funcionalidad principal, o el uso de alternativas respetuosas con la privacidad (por ejemplo, MediaStore API o Storage Access Framework) tiene un impacto sustancialmente negativo en las funciones críticas de la app vinculadas a la funcionalidad principal; y el impacto en la privacidad del usuario se mitiga con buenas prácticas de seguridad y privacidad". La condición final es responsabilidad tuya: "El desarrollador debe justificar en su declaración de Console por qué Storage Access Framework o MediaStore API no son suficientes para el propósito de su app". (https://support.google.com/googleplay/android-developer/answer/10467955)

8. Casos de uso que Google ya ha descartado. "A continuación se muestra una lista de casos de uso comunes que no podrán solicitar el permiso MANAGE_EXTERNAL_STORAGE: acceso a archivos multimedia (consulta las alternativas a continuación); cualquier actividad de selección de archivos en la que el usuario elija archivos individuales manualmente (consulta las alternativas a continuación)." Ten en cuenta que la lista es solo ilustrativa: "Esta lista no es exhaustiva. Para obtener orientación detallada, consulta la documentación sobre acceso a todos los archivos y las buenas prácticas de almacenamiento con alcance para desarrolladores." (https://support.google.com/googleplay/android-developer/answer/10467955)

9. Los dos reemplazos, y por qué suelen bastar. Para contenido multimedia, "con la API MediaStore, las apps pueden aportar y acceder a contenido multimedia disponible en un volumen de almacenamiento externo sin necesidad del permiso de acceso a todos los archivos. Con la API MediaStore, los usuarios pueden recuperar y actualizar fácilmente los archivos multimedia. Estos archivos permanecen en el volumen de almacenamiento externo del dispositivo del usuario, incluso después de desinstalar la app". Para los archivos que elige el usuario, "los desarrolladores deberían considerar el uso de Storage Access Framework como la opción respetuosa con la privacidad para acceder a archivos en el almacenamiento compartido. Este framework admite la gran mayoría de los casos de uso para que las apps logren toda una gama de funcionalidades". SAF es además el único de los tres que no necesita ningún permiso en tiempo de ejecución: "como el usuario participa en la selección de los archivos o directorios a los que tu app puede acceder, este mecanismo no requiere ningún permiso del sistema, y se refuerzan el control del usuario y la privacidad". (https://support.google.com/googleplay/android-developer/answer/10467955 / https://developer.android.com/training/data-storage/shared/documents-files)

10. Cómo se solicita el permiso y qué desbloquea realmente. «Una app puede solicitar al usuario acceso a todos los archivos haciendo lo siguiente: declarar el permiso MANAGE_EXTERNAL_STORAGE en el manifiesto. Usar la acción de intent ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION para dirigir a los usuarios a una página de ajustes del sistema... Para determinar si tu app tiene concedido el permiso MANAGE_EXTERNAL_STORAGE, llama a Environment.isExternalStorageManager()». Una vez concedido, otorga «acceso de lectura y escritura a todos los archivos del almacenamiento compartido» (y «el directorio /sdcard/Android/media forma parte del almacenamiento compartido»), «acceso al contenido de la tabla MediaStore.Files», «acceso al directorio raíz tanto de la unidad USB on-the-go (OTG) como de la tarjeta SD» y «acceso de escritura a todos los directorios de almacenamiento interno excepto /Android/data/, /sdcard/Android y la mayoría de los subdirectorios de /sdcard/Android». Aun así no llega a otras apps: «las apps a las que se concede este permiso siguen sin poder acceder a los directorios específicos que pertenecen a otras apps, porque estos directorios aparecen como subdirectorios de Android/data/ en un volumen de almacenamiento». (https://developer.android.com/training/data-storage/manage-all-files)

11. No confundas los dos mecanismos. Tener el permiso restringe lo que SAF puede ver en lugar de ampliarlo: «Sin embargo, cuando usas el Storage Access Framework, solo puedes acceder a un archivo o directorio si puedes hacerlo sin tener el permiso MANAGE_EXTERNAL_STORAGE». Así que un permiso declarado «por si acaso» puede degradar una ruta que ya funcionaba. En Android 12 (API 31) y versiones posteriores, las apps que tienen tanto MANAGE_EXTERNAL_STORAGE como QUERY_ALL_PACKAGES (los administradores de archivos) pueden usar getManageSpaceActivityIntent() para llevar al usuario a la actividad de gestión de espacio personalizada de otra app. (https://developer.android.com/training/data-storage/manage-all-files)

12. La migración en sí: requestLegacyExternalStorage muere en el momento en que tu app apunta a Android 11. «Las apps que se ejecutan en Android 11 pero apuntan a Android 10 (nivel de API 29) todavía pueden solicitar el atributo requestLegacyExternalStorage... Después de que actualices tu app para apuntar a Android 11, el sistema ignora el flag requestLegacyExternalStorage». Así que haz el trabajo en orden: «Si tu app usa el modelo de almacenamiento heredado y antes apuntaba a Android 10 o inferior, es posible que estés guardando datos en un directorio al que tu app no podrá acceder cuando se active el modelo de almacenamiento con alcance. Antes de apuntar a Android 11, migra los datos a un directorio compatible con el almacenamiento con alcance». Otros dos cambios mecánicos: «A partir de Android 11, las apps no pueden crear su propio directorio específico en el almacenamiento externo. Para acceder al directorio que el sistema proporciona para tu app, llama a getExternalFilesDirs()». Y para probar, desmarca el comportamiento de almacenamiento con alcance según el flag de compatibilidad por app: «DEFAULT_SCOPED_STORAGE (habilitado para todas las apps de forma predeterminada)» y «FORCE_ENABLE_SCOPED_STORAGE (deshabilitado para todas las apps de forma predeterminada)». (https://developer.android.com/about/versions/11/privacy/storage)

13. Conservar el permiso después de cambiar su uso es el error caro. "Si cambias cómo usa tu app estos permisos restringidos, debes volver a enviar el formulario con información actualizada y precisa. Los usos engañosos y no declarados de estos permisos pueden provocar la suspensión de tu app o el cierre de tu cuenta de desarrollador". En la práctica, esto significa volver a presentar la declaración cada vez que una nueva función empiece a acceder a archivos de forma amplia; y para las apps cuyo uso del almacenamiento es corriente (documentos que el usuario eligió, fotos, exportaciones), la vía más económica sigue siendo quitar MANAGE_EXTERNAL_STORAGE del manifiesto y distribuir MediaStore + SAF + el selector de fotos. (https://support.google.com/googleplay/android-developer/answer/10467955)