Almacenamiento local en Flutter: SQLite y Hive

El almacenamiento local es guardar datos estructurados dentro del dispositivo del usuario.

SharedPreferences es como un post-it: genial para apuntar un teléfono, terrible para escribir una novela.

Si tu App necesita:

• Guardar miles de registros.
• Hacer búsquedas complejas (ej: “Usuarios mayores de 18 que vivan en Madrid”).
• Relacionar datos (Pedidos que pertenecen a un Cliente).

Necesitas una base de datos. En Flutter podemos elegir entre soluciones relacionales, almacenes clave-valor y bases de datos orientadas a objetos. Vamos a comparar dos enfoques conocidos.

SQLite y bases de datos relacionales

SQLite es el estándar de la industria móvil. Android y iOS lo traen instalado de fábrica. Es una base de datos Relacional (SQL).

En Flutter, usamos el paquete sqflite.

¿Cómo funciona?

Piensa en hojas de cálculo de Excel (Tablas) que se relacionan entre sí. Tienes que definir un esquema estricto (CREATE TABLE…) y escribir consultas en lenguaje SQL.

// Ejemplo conceptual de sqflite
// 1. Escribimos SQL puro (Propenso a errores de sintaxis)
await db.execute(
  'CREATE TABLE Test (id INTEGER PRIMARY KEY, name TEXT, value INTEGER, num REAL)'
);

// 2. Insertamos mapas
await db.insert('Test', {'name': 'mi nombre', 'value': 123});

// 3. Consultamos
List<Map> list = await db.rawQuery('SELECT * FROM Test WHERE value > ?', [100]);

Hive como almacén clave-valor

Hive es un almacén NoSQL clave-valor escrito en Dart. Su API se parece a un Map persistente y resulta cómoda para datos que se consultan por clave.

¿Cómo funciona?

Piensa en una “Caja” (Box). Dentro de la caja puedes meter lo que quieras, asignándole una llave. Es como un Map<String, dynamic> persistente y supervitaminado.

// Ejemplo conceptual de Hive
// 1. Abrimos una caja
var box = await Hive.openBox('testBox');

// 2. Guardamos datos (Parece un Map)
await box.put('name', 'David');
await box.put('friends', ['Ana', 'Juan', 'Pedro']); // Guarda listas directamente

// 3. Leemos
var name = box.get('name');