El Proyecto | Sobre nosotros | Contribuir | Donaciones | Licencia

HOME

En esta sección, aprenderemos cómo manejar el almacenamiento de archivos en Flutter. El almacenamiento de archivos es crucial para muchas aplicaciones que necesitan guardar datos de manera persistente. Exploraremos cómo leer y escribir archivos en el sistema de archivos local del dispositivo.

Conceptos Clave

Directorio de Aplicación: El lugar donde la aplicación puede almacenar archivos.
Paquete path_provider: Un paquete de Flutter que proporciona una forma fácil de acceder a los directorios comunes del sistema de archivos.
Operaciones de Archivo: Leer, escribir, eliminar y listar archivos.

Configuración Inicial

Para trabajar con archivos en Flutter, primero necesitamos agregar el paquete path_provider a nuestro proyecto. Este paquete nos ayuda a localizar los directorios donde podemos almacenar archivos.

Paso 1: Agregar Dependencia

Abre el archivo pubspec.yaml y agrega la dependencia path_provider:

dependencies:
  flutter:
    sdk: flutter
  path_provider: ^2.0.2

Luego, ejecuta flutter pub get para instalar el paquete.

Paso 2: Importar el Paquete

Importa el paquete path_provider en tu archivo Dart:

import 'package:path_provider/path_provider.dart';
import 'dart:io';

Escribir en un Archivo

Para escribir datos en un archivo, primero necesitamos obtener el directorio donde queremos guardar el archivo y luego escribir los datos.

Ejemplo: Guardar Texto en un Archivo

Future<String> get _localPath async {
  final directory = await getApplicationDocumentsDirectory();
  return directory.path;
}

Future<File> get _localFile async {
  final path = await _localPath;
  return File('$path/demo.txt');
}

Future<File> writeContent(String content) async {
  final file = await _localFile;
  return file.writeAsString(content);
}

Explicación

Obtener el Directorio: getApplicationDocumentsDirectory() obtiene el directorio donde la aplicación puede almacenar archivos.
Crear el Archivo: File('$path/demo.txt') crea una referencia al archivo demo.txt en el directorio obtenido.
Escribir en el Archivo: file.writeAsString(content) escribe el contenido en el archivo.

Leer desde un Archivo

Para leer datos de un archivo, necesitamos abrir el archivo y leer su contenido.

Ejemplo: Leer Texto desde un Archivo

Future<String> readContent() async {
  try {
    final file = await _localFile;
    String contents = await file.readAsString();
    return contents;
  } catch (e) {
    return 'Error al leer el archivo: $e';
  }
}

Explicación

Abrir el Archivo: await _localFile obtiene la referencia al archivo.
Leer el Contenido: file.readAsString() lee el contenido del archivo como una cadena de texto.
Manejo de Errores: Si ocurre un error al leer el archivo, se captura y se devuelve un mensaje de error.

Ejercicio Práctico

Ejercicio 1: Guardar y Leer Notas

Crea una aplicación simple que permita al usuario escribir notas y guardarlas en un archivo. Luego, permite al usuario leer las notas guardadas.

Pasos

Crear la Interfaz de Usuario: Un TextField para escribir la nota y un RaisedButton para guardar la nota.
Guardar la Nota: Usa la función writeContent para guardar la nota en un archivo.
Leer la Nota: Usa la función readContent para leer la nota del archivo y mostrarla en la pantalla.

Solución

import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart';
import 'dart:io';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: NoteApp(),
    );
  }
}

class NoteApp extends StatefulWidget {
  @override
  _NoteAppState createState() => _NoteAppState();
}

class _NoteAppState extends State<NoteApp> {
  final TextEditingController _controller = TextEditingController();
  String _note = '';

  Future<String> get _localPath async {
    final directory = await getApplicationDocumentsDirectory();
    return directory.path;
  }

  Future<File> get _localFile async {
    final path = await _localPath;
    return File('$path/note.txt');
  }

  Future<File> writeContent(String content) async {
    final file = await _localFile;
    return file.writeAsString(content);
  }

  Future<String> readContent() async {
    try {
      final file = await _localFile;
      String contents = await file.readAsString();
      return contents;
    } catch (e) {
      return 'Error al leer el archivo: $e';
    }
  }

  void _saveNote() {
    writeContent(_controller.text);
  }

  void _loadNote() async {
    String note = await readContent();
    setState(() {
      _note = note;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Notas'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            TextField(
              controller: _controller,
              decoration: InputDecoration(labelText: 'Escribe tu nota'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _saveNote,
              child: Text('Guardar Nota'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _loadNote,
              child: Text('Cargar Nota'),
            ),
            SizedBox(height: 20),
            Text(_note),
          ],
        ),
      ),
    );
  }
}

Explicación

Interfaz de Usuario: Un TextField para escribir la nota y dos ElevatedButton para guardar y cargar la nota.
Guardar la Nota: La función _saveNote llama a writeContent para guardar el texto del TextField en un archivo.
Leer la Nota: La función _loadNote llama a readContent para leer el contenido del archivo y lo muestra en la pantalla.

Conclusión

En esta sección, hemos aprendido cómo manejar el almacenamiento de archivos en Flutter utilizando el paquete path_provider. Hemos cubierto cómo escribir y leer archivos, y hemos implementado una aplicación práctica para guardar y leer notas. Estos conceptos son fundamentales para cualquier aplicación que necesite almacenar datos de manera persistente. En la siguiente sección, exploraremos cómo trabajar con bases de datos locales utilizando SQLite.

Almacenamiento de Archivos

Conceptos Clave

Configuración Inicial

Paso 1: Agregar Dependencia

Paso 2: Importar el Paquete

Escribir en un Archivo

Ejemplo: Guardar Texto en un Archivo

Explicación

Leer desde un Archivo

Ejemplo: Leer Texto desde un Archivo

Explicación

Ejercicio Práctico

Ejercicio 1: Guardar y Leer Notas

Pasos

Solución

Explicación

Conclusión

Curso de Desarrollo con Flutter

Módulo 1: Introducción a Flutter

Módulo 2: Conceptos Básicos de Programación en Dart

Módulo 3: Widgets en Flutter

Módulo 4: Gestión de Estado

Módulo 5: Navegación y Enrutamiento

Módulo 6: Redes y APIs

Módulo 7: Persistencia y Almacenamiento

Módulo 8: Conceptos Avanzados de Flutter

Módulo 9: Pruebas y Depuración

Módulo 10: Despliegue y Mantenimiento

Módulo 11: Flutter para Web y Escritorio