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.

Tornar o acesso e as permissões do armazenamento em um módulo aumenta a privacidade e a segurança para os usuários finais, permitindo que os parceiros Android personalizem os recursos e temas do app usando sobreposições de recursos no ambiente de execução (RROs, na sigla em inglês). O formato do 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 da API @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 da 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 será mostrado na gaveta de apps. No Android 11 ou mais recente, o módulo usa o pacote component-override para determinar se o ícone de inicialização do Files aparece na gaveta de apps.

Por padrão, o ícone fica ativado. Para desativar, adicione o XML a seguir 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 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 versões mais recentes.

Dependências de 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.