DocumentsUI

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

Hacer que el acceso y los permisos al almacenamiento estén en un módulo aumenta la privacidad y seguridad para los usuarios finales y, al mismo tiempo, permite que los socios de Android personalicen las funciones y la aplicación de temas a través de superposiciones de recursos en el tiempo de ejecución (RRO). El formato de 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 los usuarios ven para las APIs asociadas.

El módulo DocumentsUI controla las siguientes acciones.

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

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

  • Protege el permiso MANAGE_DOCUMENTS con un permiso de firma.

Cómo mostrar el ícono del selector de Files

En Android 10, el módulo DocumentsUI usa is_launcher_enabled para determinar si el ícono de selector de archivos debería aparecer en el panel de apps. En Android 11 o versiones posteriores, el módulo usa el paquete component-override para determinar si el ícono del selector de Files se muestra en el panel lateral de la app.

De forma predeterminada, el ícono está habilitado. Para inhabilitarla, 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 realicen lo siguiente: solicitar 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 del dispositivo tiene el permiso MANAGE_DOCUMENTS.