Xamarin.Essentials: Asistentes del sistema de archivos

  • Artículo

La clase FileSystem contiene una serie de aplicaciones auxiliares para buscar la caché y los directorios de datos de la aplicación y abrir archivos dentro del paquete de aplicación.

Primeros pasos

Para empezar a usar esta API, lea la guía de introducción para Xamarin.Essentials con el fin de asegurarse de que la biblioteca está correctamente instalada y configurada en los proyectos.

Uso de aplicaciones auxiliares de sistema de archivos

Agregue una referencia a Xamarin.Essentials en la clase:

using Xamarin.Essentials;

Para obtener el directorio de la aplicación para almacenar datos en caché. Los datos en caché se pueden usar para cualquier dato que se tenga que conservar más tiempo que los temporales, pero no deben ser datos necesarios para que el funcionamiento sea correcto, ya que el sistema operativo es el que determina el momento en el que se borra el almacén.

var cacheDir = FileSystem.CacheDirectory;

Para obtener el directorio de nivel superior de la aplicación para todos los archivos que no son archivos de datos de usuario. Se realiza una copia de seguridad de estos archivos con el marco de sincronización del sistema operativo. Vea Detalles de implementación de la plataforma a continuación.

var mainDir = FileSystem.AppDataDirectory;

Si quiere abrir un archivo que se haya incluido en el paquete de aplicación, puede usar el método OpenAppPackageFileAsync para leer el contenido. En el ejemplo siguiente, se ha agregado un archivo denominado mybundledfile.txt a cada plataforma. Consulte la sección de detalles de implementación de la plataforma para obtener más información.

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

Detalles de implementación de la plataforma

  • CacheDirectory: devuelve el CacheDir del contexto actual.
  • AppDataDirectory: devuelve el FilesDir del contexto actual y se realiza una copia de seguridad mediante Copia de seguridad automática a partir de la API 23 y versiones posteriores.

Agregue un archivo a la carpeta Activos del proyecto de Android y marque la acción de compilación como AndroidAsset para usarla con OpenAppPackageFileAsync.

API

Encuentre más vídeos de Xamarin en Channel 9 y YouTube.