DocumentsUI

Il modulo DocumentsUI controlla l'accesso a file specifici per i componenti che gestiscono le autorizzazioni dei documenti (ad esempio l'allegazione di un file a un'email). Questo modulo è aggiornabile, il che significa che può ricevere aggiornamenti alle funzionalità al di fuori del normale ciclo di rilascio di Android.

Trasformare l'accesso e le autorizzazioni allo spazio di archiviazione in un modulo rafforza la privacy e sicurezza per gli utenti finali consentendo ai partner Android di personalizzare le funzionalità e i temi dell'app tramite gli overlay delle risorse di runtime (RRO). Il formato del modulo garantisce che tutti i dispositivi vengono forniti con la stessa esperienza di DocumentsUI, consentendo agli sviluppatori di sapere ciò che gli utenti vedono per le API associate.

Il modulo DocumentsUI gestisce le azioni seguenti.

  • Interagisce con il framework solo tramite API @SystemApi stabili (nessun @hide utilizzo dell'API).

  • Mette a disposizione un meccanismo per consentire ai partner Android di personalizzare le funzionalità e il tema.

  • Protegge l'autorizzazione MANAGE_DOCUMENTS utilizzando un'autorizzazione di firma.

Visualizza l'icona di avvio dei file

In Android 10, il modulo DocumentsUI utilizza is_launcher_enabled per determinare se deve essere visualizzata l'icona dell'avvio app File nella barra delle app. In Android 11 o versioni successive, il modulo utilizza il pacchetto component-override per determinare se l'icona del programma di avvio File viene visualizzata nella schermata App.

Per impostazione predefinita, l'icona è attiva. Per disabilitarla, aggiungi il seguente XML /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>

Richiedere i dati utente

Il modulo DocumentsUI implementa l'azione GET_CONTENT che consente alle app di richiedere all'utente l'accesso ad altri dati.

Formato del modulo

Il modulo DocumentsUI (com.android.documentsui) viene fornito come APK ed è disponibile per i dispositivi con Android 10 o superiore.

Dipendenze dei moduli

Questo modulo DocumentsUI dipende dall'autorizzazione MANAGE_DOCUMENTS protetta dall'autorizzazione di firma. Un'altra classe di autorizzazione garantisce che solo un'app sul dispositivo abbia l'autorizzazione MANAGE_DOCUMENTS.