DocumentsUI

O módulo DocumentsUI controla o acesso a arquivos específicos para componentes que processam permissões de documentos (como anexar um arquivo a um e-mail). Esse módulo pode ser atualizado, o que significa que ele pode receber atualizações de funcionalidade fora do ciclo normal de lançamento do Android.

Transformar o acesso e as permissões de armazenamento em um módulo aumenta a privacidade e a segurança dos usuários finais, ao mesmo tempo em que permite que os parceiros do Android personalizem os recursos e o tema do app usando sobreposições de recursos de execução (RROs). O formato do módulo garante que todos os dispositivos sejam enviados com a mesma experiência da DocumentsUI, permitindo que os desenvolvedores saibam o que os usuários veem nas APIs associadas.

O módulo DocumentsUI processa as seguintes ações.

  • Interage com o framework apenas por APIs @SystemApi estáveis (sem uso de APIs @hide).

  • Expõe um mecanismo para permitir que os parceiros do Android personalizem recursos e temas.

  • Protege a permissão MANAGE_DOCUMENTS usando uma permissão de assinatura.

Mostrar o ícone na tela de início dos Arquivos

No Android 10, o módulo DocumentsUI usa is_launcher_enabled para determinar se o ícone na tela de início do Files deve aparecer na gaveta de apps. No Android 11 ou mais recente, o módulo usa o pacote component-override para determinar se o ícone na tela de início do Files aparece na gaveta de apps.

Por padrão, o ícone está ativado. Para desativá-lo, adicione o seguinte 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>

Solicitar dados do usuário

O módulo DocumentsUI implementa a ação GET_CONTENT, que permite que os apps solicitem acesso a outros dados do usuário.

Formato do módulo

O módulo DocumentsUI (com.android.documentsui) é fornecido como um arquivo APK e está disponível para dispositivos com o Android 10 ou mais recente.

Dependências do módulo

Esse módulo DocumentsUI depende da permissão MANAGE_DOCUMENTS protegida pela permissão de assinatura. Uma classe de permissão adicional garante que apenas um app no dispositivo tenha a permissão MANAGE_DOCUMENTS.