Panoramica dell'archiviazione di dati e file

Android utilizza un file system simile a quello basato su disco su altre piattaforme. Il sistema offre diverse opzioni per salvare i dati dell'app:

  • Spazio di archiviazione specifico per l'app: archivia i file destinati esclusivamente all'uso della tua app in directory dedicate all'interno di un volume di archiviazione interno o in directory dedicate diverse all'interno di uno spazio di archiviazione esterno. Utilizza le directory all'interno dello spazio di archiviazione interno per salvare informazioni sensibili a cui altre app non devono accedere.
  • Spazio di archiviazione condiviso: archivia i file che la tua app intende condividere con altre app, inclusi contenuti multimediali, documenti e altri file.
  • Preferenze: memorizza dati privati e primitivi in coppie chiave/valore.
  • Database:archivia i dati strutturati in un database privato utilizzando la stanza libreria di persistenza.

Le caratteristiche di queste opzioni sono riassunte nella seguente tabella:

Tipo di contenuti Metodo di accesso Autorizzazioni richieste Altre app possono accedere? File rimossi durante la disinstallazione dell'app?
File specifici per le app File destinati esclusivamente all'utilizzo dell'app Dalla memoria interna, getFilesDir() o getCacheDir()

Dalla memoria esterna, getExternalFilesDir() o getExternalCacheDir()		 Non necessaria per l'archiviazione interna

Non necessaria per l'archiviazione esterna spazio di archiviazione quando la tua app viene usata su dispositivi con Android 4.4 (livello API 19) o successiva		 No Sì
Media File multimediali condivisibili (immagini, file audio, video) API MediaStore READ_EXTERNAL_STORAGE quando si accede ad altre app file attivi Android 11 (livello API 30) o versioni successive

READ_EXTERNAL_STORAGE oppure WRITE_EXTERNAL_STORAGE quando si accede ad altre app file su Android 10 (livello API 29)

Le autorizzazioni sono necessarie per tutti i file su Android 9 (livello API 28) oppure inferiore		 Sì, anche se l'altra app ha bisogno dell'autorizzazione READ_EXTERNAL_STORAGE No
Documenti e altri file Altri tipi di contenuti condivisibili, inclusi i file scaricati Framework di accesso allo spazio di archiviazione Nessuno Sì, tramite il selettore file di sistema No
Preferenze delle app Coppie chiave-valore Jetpack Raccolta delle preferenze Nessuno No Sì
Database Dati strutturati Libreria di persistenza Room Nessuno No Sì

La soluzione che scegli dipende dalle tue esigenze specifiche:

Quanto spazio richiedono i tuoi dati?
La memoria interna ha uno spazio limitato per i dati specifici dell'app. Utilizza altri tipi di archiviazione se devi salvare una quantità significativa di dati.
Quanto deve essere affidabile l'accesso ai dati?
Se la funzionalità di base dell'app richiede determinati dati, ad esempio durante l'avvio, inseriscili nella directory della memoria interna o in un database. I file specifici dell'app archiviati nello spazio di archiviazione esterno non sono sempre accessibili perché alcuni dispositivi consentono agli utenti di rimuovere un dispositivo fisico corrispondente allo spazio di archiviazione esterno.
Che tipo di dati devi archiviare?
Se hai dati significativi solo per la tua app, utilizza lo spazio di archiviazione specifico per l'app. Per i contenuti multimediali condivisibili, usa lo spazio di archiviazione condiviso per consentire ad altre app accedere ai contenuti. Per i dati strutturati, utilizza le preferenze (per i dati chiave-valore) o un database (per i dati contenenti più di due colonne).
I dati devono essere privati per la tua app?
Quando si archiviano dati sensibili, che non dovrebbero essere accessibili ad altri utilizzare la memoria interna, le preferenze o un database. La memoria interna ha il vantaggio aggiuntivo di nascondere i dati agli utenti.

Categorie di posizioni di archiviazione

Android offre due tipi di posizioni di archiviazione fisica: spazio di archiviazione interno e spazio di archiviazione esterno. Sulla maggior parte dei dispositivi, la memoria interna è di dimensioni inferiori a quelle esterne archiviazione. Tuttavia, la memoria interna è sempre disponibile su tutti i dispositivi, una posizione più affidabile in cui inserire i dati da cui dipende la tua app.

I volumi rimovibili, come una scheda SD, vengono visualizzati nel file system come parte dell'archiviazione esterna. Android rappresenta questi dispositivi utilizzando un percorso, ad esempio/sdcard.

Per impostazione predefinita, le app vengono archiviate nella memoria interna. Tuttavia, se le dimensioni dell'APK sono molto grandi, puoi indicare una preferenza nel file manifest dell'app per installarla sullo spazio di archiviazione esterno:

<manifest ...
  android:installLocation="preferExternal">
  ...
</manifest>

Autorizzazioni e accesso allo spazio di archiviazione esterno

Android definisce le seguenti autorizzazioni relative allo spazio di archiviazione: READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE, e MANAGE_EXTERNAL_STORAGE.

Nelle versioni precedenti di Android, le app dovevano dichiarare Autorizzazione di READ_EXTERNAL_STORAGE per accedere a file al di fuori specifici dell'app sulla memoria esterna. Inoltre, le app dovevano dichiarare l'autorizzazione WRITE_EXTERNAL_STORAGE per scrivere su qualsiasi file al di fuori della directory specifica dell'app.

Le versioni più recenti di Android si basano più sullo scopo di un file che sulla sua posizione per determinare la capacità di un'app di accedere e scrivere in un determinato file. In particolare, se la tua app ha come target Android 11 (livello API 30) o versioni successive, l'autorizzazioneWRITE_EXTERNAL_STORAGE non ha alcun effetto sull'accesso dell'app allo spazio di archiviazione. Questo modello di archiviazione basato sullo scopo migliora la privacy dell'utente perché alle app viene concesso l'accesso solo alle aree del file system del dispositivo che effettivamente utilizzano.

Android 11 introduce l'autorizzazione MANAGE_EXTERNAL_STORAGE, che fornisce accesso in scrittura ai file esterni alla directory specifica dell'app e a MediaStore. Per approfondire questa autorizzazione e scoprire perché la maggior parte delle app non deve dichiararla per soddisfare i propri casi d'uso, consulta la guida su come gestire tutti i file su un dispositivo di archiviazione.

Archiviazione con ambito

Per offrire agli utenti un maggiore controllo sui propri file e limitare il disordine, per impostazione predefinita alle app destinate ad Android 10 (livello API 29) e versioni successive viene concesso l'accesso limitato allo spazio di archiviazione esterno, o archiviazione con ambito. Queste app hanno accesso soltanto ai specifiche delle app su dispositivi di archiviazione esterni, nonché tipi specifici di supporti creato dall'app.

Utilizza l'archiviazione con ambito, a meno che la tua app non abbia bisogno di accedere a un file archiviato all'esterno di una directory specifica dell'app e all'esterno di una directory di cui MediaStore Le API possono accedere. Se archivi file specifici delle app su dispositivi di archiviazione esterni, puoi: semplifica l'adozione dell'archiviazione con ambito posizionando questi file in un specifica per un'app su server spazio di archiviazione. In questo modo, la tua app mantiene l'accesso a questi file quando lo spazio di archiviazione limitato è attivo.

Per preparare la tua app all'archiviazione con ambito, consulta i casi d'uso relativi allo spazio di archiviazione e alle best practice. Se la tua app ha un altro caso d'uso non coperto dallo spazio di archiviazione limitato, invia una richiesta di funzionalità. Puoi disattivare temporaneamente l'utilizzo dello spazio di archiviazione con ambito.

Visualizzare i file su un dispositivo

Per visualizzare i file memorizzati su un dispositivo, utilizza Device File Explorer di Android Studio.

Risorse aggiuntive

Per ulteriori informazioni sull'archiviazione dei dati, consulta le risorse seguenti.

Video