Xamarin.Essentials: Helper del file system

La classe FileSystem contiene una serie di helper per trovare le directory della cache e dei dati dell'applicazione e per aprire i file all'interno del pacchetto dell'app.

Operazioni preliminari

Per iniziare a usare questa API, leggere la guida introduttiva per Xamarin.Essentials assicurarsi che la libreria sia installata e configurata correttamente nei progetti.

Uso di File System Helpers

Aggiungere un riferimento a Xamarin.Essentials nella classe :

using Xamarin.Essentials;

Per ottenere la directory dell'applicazione in cui archiviare i dati della cache. I dati della cache sono utilizzabili per tutti i dati che è necessario conservare per un periodo più lungo dei dati temporanei, ma non devono essere dati necessari per il corretto funzionamento, perché è il sistema operativo a determinare quando questa risorsa di archiviazione viene cancellata.

var cacheDir = FileSystem.CacheDirectory;

Per ottenere la directory principale dell'applicazione per tutti i file che non sono file di dati utente. Il backup di questi file viene eseguito con il framework di sincronizzazione del sistema operativo. Vedere più avanti Informazioni di implementazione specifiche della piattaforma.

var mainDir = FileSystem.AppDataDirectory;

Se si vuole aprire un file in bundle nel pacchetto dell'applicazione, è possibile usare il OpenAppPackageFileAsync metodo per leggere il contenuto. Nell'esempio seguente è stato aggiunto un file denominato mybundledfile.txt a ogni piattaforma. Per informazioni dettagliate, vedere la sezione relativa alle specifiche dell'implementazione della piattaforma.

 var fileName = "mybundledfile.txt";
 using (var stream = await FileSystem.OpenAppPackageFileAsync(fileName))
 {
    using (var reader = new StreamReader(stream))
    {
        var fileContents = await reader.ReadToEndAsync();
    }
 }

Informazioni di implementazione specifiche della piattaforma

Android

• CacheDirectory: restituisce l'elemento CacheDir del contesto corrente.
• AppDataDirectory: restituisce l'elemento FilesDir del contesto corrente e il backup viene eseguito usando il backup automatico a partire dall'API 23 e versioni successive.

Aggiungere i file nella cartella Assets del progetto Android e contrassegnare l'azione di compilazione come AndroidAsset per usarla con OpenAppPackageFileAsync.

iOS

• CacheDirectory: restituisce la directory Library/Caches.
• AppDataDirectory: restituisce la directory Library di cui viene eseguito un backup da iTunes e iCloud.

Importante

Nel simulatore iOS, l'ID applicazione (che fa parte del nome della directory) cambia in ogni compilazione in modo da dover recuperare l'ID corretto ogni volta che si compila l'applicazione per il simulatore.

Aggiungere i file nella cartella Resources del progetto iOS e contrassegnare l'azione di compilazione come BundledResource per usarla con OpenAppPackageFileAsync.

UWP

• CacheDirectory: restituisce la directory LocalCacheFolder.
• AppDataDirectory: restituisce la directory LocalFolder di cui viene eseguito un backup nel cloud.

Aggiungere i file nella radice del progetto UWP e contrassegnare l'azione di compilazione come Content per usarla con OpenAppPackageFileAsync.

API

• Codice sorgente di File System Helpers
• Documentazione dell'API File System

Video correlato

Altri video di Xamarin sono disponibili su Channel 9 e YouTube.