Upgrade SDK 53 Expo - chrisfalla/Frontend_La_Brujula_Llanera GitHub Wiki

📦 Guía Completa para Actualizar Expo SDK 52 → 53

Esta guía te permitirá actualizar de forma segura y automática tu proyecto Expo (con expo-dev-client) de SDK 52 a SDK 53. Está pensada para que tu equipo no tenga que repetir los pasos manualmente.

🧩 Requisitos Previos

Antes de comenzar, asegúrate de tener:

Node.js >= 18
npm o yarn actualizado
Git configurado
Tener el proyecto funcionando con SDK 52

✅ Paso 1: Verifica tu versión actual

npx expo doctor

✅ Paso 2: Actualiza Expo SDK a 53

npx expo install --fix
npx expo upgrade 53.0.0

Esto actualizará expo, react-native, expo-modules, y otras dependencias principales.

✅ Paso 3: Elimina la caché (obligatorio)

npx expo start --dev-client --clear

✅ Paso 4: Configura expo-dev-client

Instala expo-dev-client si no lo tenías:

npx expo install expo-dev-client

Crea una build para Android con EAS:

eas build -p android --profile development

Después de crearla, instala la APK o usa eas device para enviarla a tus testers.

✅ Paso 5: Crea un esquema de URI (recomendado)

Edita app.json o app.config.js:

{
  "expo": {
    "scheme": "brujula",
    "name": "La Brujula Llanera",
    "...": "..."
  }
}

Esto evitará errores como:

"The /android project does not contain any URI schemes"

✅ Paso 6: Comando de inicio para desarrollo

npx expo start --dev-client

Opcional: para que tu equipo use tunnel (recomendado para red local):

npx expo start --dev-client --tunnel

Si falla por error EPERM en Windows, ejecuta la terminal como Administrador.

✅ Paso 7: Scripts recomendados para tu package.json

Agrega estos scripts para automatizar comandos:

{
  "scripts": {
    "start": "expo start --dev-client",
    "start:tunnel": "expo start --dev-client --tunnel",
    "clear": "expo start --dev-client --clear",
    "build:dev": "eas build -p android --profile development",
    "upgrade": "expo upgrade 53.0.0 && expo install --fix",
    "doctor": "expo doctor"
  }
}

Tu equipo solo deberá ejecutar:

npm run upgrade
npm run clear
npm run build:dev

✅ Paso 8: Instala dependencias faltantes (si las usas)

npx expo install react-native-screens react-native-safe-area-context
npx expo install react-native-gesture-handler react-native-reanimated
npx expo install react-native-maps
npx expo install expo-location
npx expo install expo-status-bar

✅ Paso 9: Limpieza de módulos (opcional pero útil)

Para Unix/macOS:

rm -rf node_modules
rm -rf .expo
rm package-lock.json
npm install

Para Windows:

rmdir /s /q node_modules
rmdir /s /q .expo
del package-lock.json
npm install

✅ Extras: Reinicio completo de proyecto

npm run clear
npm run start

📘 Notas adicionales

expo-dev-client permite usar librerías nativas no soportadas por Expo Go.
eas build requiere tener el proyecto vinculado con una cuenta de Expo.
Puedes usar .bat o .sh para automatizar todo en un solo archivo, si lo deseas.

🧠 Palabras Clave

SDK: versión del entorno de desarrollo de Expo.
Dev Client: cliente nativo personalizado para usar librerías con código nativo.
Tunnel: método para exponer tu servidor local a internet.
EAS Build: herramienta oficial de Expo para compilar apps nativas.
URI Scheme: protocolo personalizado que permite abrir tu app desde enlaces.

👥 Uso para tu equipo

Para que tu equipo tenga todo listo, deben ejecutar:

git pull
npm install
npm run upgrade
npm run clear
npm run build:dev

Y luego abrir la app instalada en el dispositivo. Listo para programar.