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, ou seja, 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, permitindo que os parceiros do Android personalizem os recursos e a aparência do app usando substituições de recursos de tempo de execução (RROs, na sigla em inglês). O formato de módulo garante que todos os dispositivos sejam enviados com a mesma experiência do DocumentsUI, permitindo que os desenvolvedores saibam o que os usuários veem para as 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.

Ícone do app Arquivos na tela de início

No Android 10, o módulo DocumentsUI usa is_launcher_enabled para determinar se o ícone do Acesso rápido aos arquivos deve aparecer no painel de apps. No Android 11 ou versões mais recentes, o módulo usa o pacote component-override para determinar se o ícone do iniciador de arquivos aparece na gaveta de apps.

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