A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Il modulo DocumentsUI controlla l'accesso a file specifici per i componenti che gestiscono le autorizzazioni dei documenti (ad esempio l'allegato 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.
Se inserisci le autorizzazioni e l'accesso allo spazio di archiviazione in un modulo, aumenti la privacy e la sicurezza per gli utenti finali e consenti ai partner Android di personalizzare le funzionalità e il tema dell'app tramite gli overlay delle risorse di runtime. Il formato del modulo garantisce che tutti i dispositivi vengano forniti con la stessa esperienza DocumentsUI, consentendo agli sviluppatori di sapere cosa vedono gli utenti per le API associate.
Il modulo DocumentsUI gestisce le seguenti azioni.
Interagisce con il framework solo tramite API @SystemApi stabili (nessun utilizzo di API @hide).
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.
Mostra l'icona di Avvio app File
In Android 10, il modulo DocumentsUI utilizza is_launcher_enabled per determinare se deve essere visualizzata l'icona dell'avvio app File nella schermata 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 disattivarla, aggiungi il seguente XML a
/etc/sysconfig.
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 file APK ed è disponibile per i dispositivi con Android 10 o versioni successive.
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.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-27 UTC."],[],[],null,["# DocumentsUI\n\n| **Important:** Starting in Android 12, file browsing through DocumentsUI is disabled.\n\nThe DocumentsUI module controls access to specific files for components that\nhandle document permissions (such as attaching a file to an email). This module\nis updatable, meaning it can receive updates to functionality outside of the\nnormal Android release cycle.\n\nMaking storage access and permissions into a module increases privacy and\nsecurity for end users while allowing Android partners to customize the features\nand theming of the app through [runtime resource overlays\n(RROs)](/docs/core/architecture/rros). The module format ensures that all\ndevices ship with the same DocumentsUI experience, enabling developers to know\nwhat users see for associated APIs.\n\nThe DocumentsUI module handles the following actions.\n\n- Interacts with the framework only through stable `@SystemApi` APIs (no\n `@hide` API usage).\n\n- Exposes a mechanism for enabling Android partners to customize features and\n theming.\n\n- Protects the `MANAGE_DOCUMENTS` permission using a signature permission.\n\nDisplay Files launcher icon\n---------------------------\n\nIn Android 10, the DocumentsUI module uses `is_launcher_enabled` to determine if\nthe Files launcher icon should display in the app drawer. In Android\n11 or higher, the module uses the `component-override`\npackage to determine if the Files launcher icon displays in the app drawer.\n\nBy default, the icon is enabled. To disable it, add the following XML to\n`/etc/sysconfig`. \n\n \u003c?xml version=\"1.0\" encoding=\"utf-8\"?\u003e\n \u003cconfig\u003e\n \u003ccomponent-override package=\"com.android.documentsui\" \u003e\n \u003ccomponent class=\"com.android.documentsui.LauncherActivity\" enabled=\"false\" /\u003e\n \u003c/component-override\u003e\n \u003c/config\u003e\n\nRequest user data\n-----------------\n\nThe DocumentsUI module implements the `GET_CONTENT` action that enables apps to\nrequest access to other data from the user.\n\nModule format\n-------------\n\nThe DocumentsUI module (`com.android.documentsui`) is delivered as an\nAPK file and is available for devices running Android\n10 or higher.\n\nModule dependencies\n-------------------\n\nThis DocumentsUI module depends on the `MANAGE_DOCUMENTS` permission protected\nby the signature permission; an additional permission class ensures that only\none app on the device has the `MANAGE_DOCUMENTS` permission."]]
