DocumentsUI

El módulo DocumentsUI controla el acceso a archivos específicos para los componentes que administran los permisos de documentos (como adjuntar un archivo a un correo electrónico). Este módulo se puede actualizar, lo que significa que puede recibir actualizaciones de funciones fuera del ciclo de lanzamiento normal de Android.

Convertir el acceso y los permisos de almacenamiento en un módulo aumenta la privacidad y la seguridad para los usuarios finales, al tiempo que permite que los socios de Android personalicen las funciones y los temas de la app a través de superposiciones de recursos en tiempo de ejecución (RRO). El formato del módulo garantiza que todos los dispositivos se envíen con la misma experiencia de DocumentsUI, lo que permite a los desarrolladores saber lo que ven los usuarios para las APIs asociadas.

El módulo DocumentsUI controla las siguientes acciones.

  • Interactúa con el framework solo a través de APIs @SystemApi estables (no se usa la API @hide).

  • Expone un mecanismo para permitir que los socios de Android personalicen las funciones y los temas.

  • Protege el permiso MANAGE_DOCUMENTS con un permiso de firma.

Muestra el ícono de selector de archivos

En Android 10, el módulo DocumentsUI usa is_launcher_enabled para determinar si el ícono de selector de archivos debe mostrarse en el panel de apps. En Android 11 o versiones posteriores, el módulo usa el paquete component-override para determinar si el ícono de selector de archivos se muestra en el panel de apps.

De forma predeterminada, el ícono está habilitado. Para inhabilitarlo, agrega el siguiente XML a /etc/sysconfig.

<?xml version="1.0" encoding="utf-8"?>
<config>
  <component-override package="com.android.documentsui" >
    <component class="com.android.documentsui.LauncherActivity" enabled="false" />
  </component-override>
</config>

Solicita datos del usuario

El módulo DocumentsUI implementa la acción GET_CONTENT que permite que las apps soliciten acceso a otros datos del usuario.

Formato del módulo

El módulo DocumentsUI (com.android.documentsui) se entrega como un archivo APK y está disponible para dispositivos que ejecutan Android 10 o versiones posteriores.

Dependencias del módulo

Este módulo DocumentsUI depende del permiso MANAGE_DOCUMENTS protegido por el permiso de firma. Una clase de permiso adicional garantiza que solo una app en el dispositivo tenga el permiso MANAGE_DOCUMENTS.