O módulo DocumentsUI controla o acesso a arquivos específicos para componentes que tratam de permissões de documentos (como anexar um arquivo a um e-mail). Este módulo é atualizável, o que significa que pode receber atualizações de funcionalidade fora do ciclo normal de lançamento do Android.
Tornar o acesso de armazenamento e as permissões em um módulo aumenta a privacidade e a segurança dos usuários finais, permitindo que os parceiros Android personalizem os recursos e os temas do aplicativo por meio de sobreposições de recursos de tempo de execução (RROs) . 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 nas APIs associadas.
O módulo DocumentsUI lida com as seguintes ações.
Interage com a estrutura apenas por
@SystemApi
APIs@SystemApi
estáveis (sem uso de API@hide
).Expõe um mecanismo para permitir que os parceiros Android personalizem recursos e temas.
Protege a permissão
MANAGE_DOCUMENTS
usando uma permissão de assinatura.
Exibindo o ícone do iniciador de arquivos
No Android 10, o módulo DocumentsUI usa is_launcher_enabled
para determinar se o ícone do iniciador de arquivos deve ser exibido na gaveta do aplicativo. No Android 11 ou superior, o módulo usa o pacote de component-override
para determinar se o ícone do iniciador de arquivos é exibido na gaveta do aplicativo.
Por padrão, o ícone está habilitado. Para desativá-lo, adicione o seguinte XML a /etc/sysconfig>
.
<?xml version="1.0" encoding="utf-8"?>
<config>
<component-override package="com.google.android.documentsui" >
<component class="com.android.documentsui.LauncherActivity" enabled="false" />
</component-override>
</config>
Solicitando dados do usuário
O módulo DocumentsUI implementa a ação GET_CONTENT
que permite que os aplicativos solicitem acesso a outros dados do usuário.
Formato do módulo
O módulo DocumentsUI ( com.google.android.documentsui
) é entregue como um arquivo APK e está disponível para dispositivos com Android 10 ou superior.
Dependências de módulo
Este 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 aplicativo no dispositivo tenha a permissão MANAGE_DOCUMENTS
.