IU de documentos

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). Este módulo es actualizable, lo que significa que puede recibir actualizaciones de funciones fuera del ciclo normal de lanzamientos de Android.

Si conviertes el acceso y los permisos de almacenamiento en un módulo, se aumenta la privacidad y la seguridad de los usuarios finales, a la vez que permites que los socios de Android personalicen las funciones y los temas de la app a través de superposiciones de recursos de 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.

Mostrar ícono de selector de archivos

En Android 10, el módulo DocumentsUI usa is_launcher_enabled para determinar si el ícono del selector de Files debe mostrarse en el panel lateral de la app. 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 lateral de apps.

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 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 de DocumentsUI depende del permiso MANAGE_DOCUMENTS protegido por el permiso de firma. Una clase de permiso adicional garantiza que solo una app del dispositivo tenga el permiso MANAGE_DOCUMENTS.