Clase 04 · Módulo 06
Guardar datos en el teléfono
Guardar datos en el teléfono
Qué logras en esta clase
Eliges dónde guardar cada dato que debe sobrevivir al cierre de la app y reconoces cuándo algo quedó en el lugar equivocado.
- Conoces las cuatro opciones que ofrece Expo.
- Sabes qué va cifrado y qué no.
- Distingues cuándo basta clave-valor y cuándo necesitas una base de datos local.
02
Memoria y disco
La memoria se borra al cerrar la app. Lo que debe seguir ahí mañana va al disco.
03
Los cuatro cajones
Según la guía de Expo, al 18-11-2026:
| Opción | Para qué | Cifrado |
|---|---|---|
expo-secure-store | Secretos pequeños: tokens, claves | Sí |
| AsyncStorage | Datos chicos no sensibles | No |
expo-sqlite | Base de datos local | No por defecto |
expo-file-system | Archivos, subidas y descargas | No indicado |
Las cuatro pueden convivir en la misma app. Lo normal es usar dos o tres.
04
Tres preguntas para elegir
- ¿Es un secreto? Un token de sesión o una clave van siempre al almacenamiento cifrado.
- ¿Es un archivo? Fotos, audios y documentos van al sistema de archivos.
- ¿Son muchos registros que vas a filtrar u ordenar? Entonces es una base de datos local.
Si las tres respuestas son «no», es un dato chico y simple: clave-valor.
05
El camino de cada dato
Clave-valor significa que guardas un texto bajo un nombre y lo recuperas por ese nombre, como una libreta con etiquetas. No hay tablas ni búsquedas.
06
AsyncStorage: simple y sin cifrar
Es el almacenamiento clave-valor más usado en React Native. Guarda texto; un objeto se convierte antes a texto con JSON.stringify y se recupera con JSON.parse.
await AsyncStorage.setItem('tema', 'oscuro')
const tema = await AsyncStorage.getItem('tema')Es asíncrono: cada lectura devuelve una promesa (módulo 4). Sirve para preferencias, el store persistido de la clase 2 y la caché de consultas de la clase 5.
07
Error: el token en AsyncStorage
Es un error frecuente en tutoriales antiguos, porque era lo más corto de escribir. Si lo ves en el código, pide el cambio antes de seguir.
08
SecureStore: el cajón con llave
expo-secure-store guarda pares clave-valor cifrados usando el almacén seguro del propio sistema. Viene incluido en Expo Go.
- Tres funciones:
setItemAsync,getItemAsyncydeleteItemAsync. - Los nombres de clave solo admiten letras, números, punto, guion y guion bajo.
- Si la clave no existe, la lectura devuelve
null.
Aquí se guarda la sesión del usuario, que verás en el módulo 8.
09
Límites reales de SecureStore
- Solo valores pequeños. Expo advierte que valores grandes pueden ser rechazados en iOS. El detalle está en la referencia oficial: compruébalo antes de guardar algo largo.
- Android: los datos se borran al desinstalar la app.
- iOS: pueden sobrevivir a una reinstalación, pero no está garantizado.
10
Pedir huella o código para leer un valor
La opción requireAuthentication exige biometría o el código del teléfono para acceder al valor. En Android, el SDK 58 suma requireConfirmation para ajustar esa confirmación.
Si el usuario cancela, la lectura lanza un error: no es un dato dañado, es un «no» del usuario, y la app debe tratarlo así.
11
Ni todo secreto ni todo abierto
Si es un secreto, va cifrado. Si no es secreto, no gastes SecureStore en él.
12
SQLite: una base de datos dentro del teléfono
expo-sqlite te da una base de datos SQLite, un archivo en el teléfono que se consulta con SQL (el lenguaje de consultas que verás con Supabase en el módulo 7). Lo guardado persiste entre reinicios de la app.
npx expo install expo-sqliteViene incluido en Expo Go. Tiene tablas, filtros, orden y transacciones, todo sin conexión y sin servidor.
13
Clave-valor o base de datos local
| Necesidad | Clave-valor | SQLite |
|---|---|---|
| Guardar 5 preferencias | Sí | Sobra |
| 2.000 registros con búsqueda | Lento y frágil | Sí |
| Filtrar por fecha o estado | A mano | Con una consulta |
| Cola de cambios por enviar | Posible | Mejor |
| Costo de mantenerlo | Bajo | Medio |
Si te descubres guardando una lista larga como un solo texto y recorriéndola completa para buscar, ya necesitas SQLite.
14
Lo mínimo para leer código con SQLite
openDatabaseAsyncabre la base.runAsyncejecuta un cambio y recibe los valores aparte, como parámetros.getAllAsyncygetFirstAsyncdevuelven filas.execAsyncejecuta varias sentencias de una vez, sin parámetros.
15
La estructura también cambia: migraciones
Cada teléfono tiene su propio archivo de base, creado con la versión de la app que tenía ese día. Al actualizar la app, la estructura debe ponerse al día sin borrar datos.
El patrón de la documentación usa el componente SQLiteProvider con una función onInit que, al abrir la base:
- Lee el número de versión guardado (
PRAGMA user_version). - Aplica solo los cambios que le faltan a ese teléfono.
- Deja anotada la versión nueva.
16
Cifrado: opcional y fácil de creer activado
La base no viene cifrada. Existe soporte de SQLCipher (cifrado para SQLite), que se activa en la configuración de la app y exige un build nuevo; no funciona en Expo Go.
17
Tutoriales viejos: libSQL ya no está
El SDK 58 eliminó el soporte de libSQL dentro de expo-sqlite. Las guías que sincronizan esta base con Turso usando syncLibSQL o useLibSQL quedaron desactualizadas.
18
Archivos: fotos, audios y documentos
expo-file-system da acceso al sistema de archivos de la app y permite subir y descargar desde una dirección web.
Una foto convertida a texto dentro de SQLite o AsyncStorage vuelve lento todo lo demás.
19
Otras opciones de clave-valor
| Opción | Ventaja | Costo |
|---|---|---|
| AsyncStorage | Estándar, mucha documentación | Solo asíncrono |
expo-sqlite/kv-store | Misma forma de uso, suma lectura síncrona | Depende de expo-sqlite |
| MMKV | Alternativa rápida de la comunidad | Requiere development build |
El almacén clave-valor de expo-sqlite sigue la interfaz de AsyncStorage: según la documentación, basta cambiar la importación. Útil si ya usas SQLite y quieres una sola dependencia.
20
Lo que el disco no resuelve
- No es un respaldo. Teléfono perdido o app desinstalada: datos perdidos.
- No sincroniza. Lo guardado en un teléfono no aparece en otro.
- El usuario puede borrarlo desde los ajustes del sistema.
- Envejece con la app. Datos guardados por una versión anterior pueden tener otra forma.
Todo lo que importa conservar termina en el servidor. El teléfono guarda copias, preferencias y pendientes.
21
Guardar menos es mejor
Cada dato guardado es algo que hay que migrar, borrar al cerrar sesión y proteger.
- Al cerrar sesión se limpia lo del usuario: sesión, caché y borradores.
- Los datos personales se guardan solo si la función los necesita (módulo 13).
22
Cómo pedírselo a Claude Code
Dile el tipo de dato y la exigencia, no la librería a ciegas.
Con esa descripción, la elección se justifica sola y puedes revisar si la respuesta de Claude coincide con las tres preguntas.
23
Lo que te llevas
- Secretos pequeños:
expo-secure-store. Nunca en AsyncStorage. - Datos chicos no sensibles: clave-valor.
- Muchos registros que se filtran:
expo-sqlite, con migraciones. - Archivos al disco; en la base solo su ruta.
- El teléfono no es respaldo: lo valioso vive en el servidor.
24
Hazlo ahora
En 10 minutos, con tu tabla de la clase 1:
- Toma cada dato que marcaste como persistido.
- Pásalo por las tres preguntas y anota su cajón.
- Agrega una columna: ¿cuándo se borra?
- Marca con una señal los que son secretos y verifica que ninguno quedó en clave-valor.
Si algún dato cayó en SQLite, anota qué búsquedas o filtros necesita: será la base de su tabla local.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026