O módulo DocumentsUI controla o acesso a arquivos específicos para componentes que lidam com permissões de documentos (como anexar um arquivo a um email). Este módulo é atualizável, o que significa que pode receber atualizações de funcionalidades fora do ciclo normal de lançamento do Android.
Tornar 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 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 DocumentsUI, permitindo que os desenvolvedores saibam o que os usuários veem para APIs associadas.
O módulo DocumentsUI lida com as ações a seguir.
Interage com a estrutura apenas por meio de APIs
@SystemApi
estáveis (sem uso de API@hide
).Expõe um mecanismo para permitir que parceiros Android personalizem recursos e temas.
Protege a permissão
MANAGE_DOCUMENTS
usando uma permissão de assinatura.
Exibir o ícone do iniciador de arquivos
No Android 10, o módulo DocumentsUI usa is_launcher_enabled
para determinar se o ícone do inicializador de arquivos deve ser exibido na gaveta de aplicativos. No Android 11 ou superior, o módulo usa o pacote component-override
para determinar se o ícone do inicializador de arquivos é exibido na gaveta de aplicativos.
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>
Solicitar 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
) é fornecido como um arquivo APK e está disponível para dispositivos com Android 10 ou superior.
Dependências do 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
.