¿Qué hace Actualizar Next.js?
Actualiza el proyecto actual a la última versión de Next.js siguiendo las guías de migración oficiales.
Instrucciones
-
Detectar la versión actual: Lee
package.jsonpara identificar la versión actual de Next.js y las dependencias relacionadas (React, React DOM, etc.) -
Obtener la guía de actualización más reciente: Usa WebFetch para obtener la documentación oficial de actualización:
- Codemods: https://nextjs.org/docs/app/building-your-application/upgrading/codemods
- Guías específicas de versión (ajusta la versión según sea necesario):
-
Determinar la ruta de actualización: Basado en la versión actual, identifica qué pasos de migración aplican. Para saltos mayores de versión, actualiza de forma incremental (por ejemplo, 13 → 14 → 15).
-
Ejecutar codemods primero: Next.js proporciona codemods para automatizar cambios disruptivos:
npx @next/codemod@latest <transform> <path>Transformaciones comunes:
next-async-request-api- Actualiza las APIs de Request asíncronas (v15)next-request-geo-ip- Migra las propiedades geo/ip (v15)next-dynamic-access-named-export- Transforma importaciones dinámicas (v15)
-
Actualizar dependencias: Actualiza Next.js y las dependencias pares juntas:
npm install next@latest react@latest react-dom@latest -
Revisar cambios disruptivos: Consulta la guía de actualización para cambios manuales necesarios:
- Cambios en la API (por ejemplo, params asíncronos en v15)
- Cambios de configuración en
next.config.js - Características obsoletas que se eliminan
-
Actualizar tipos TypeScript (si corresponde):
npm install @types/react@latest @types/react-dom@latest -
Probar la actualización:
- Ejecuta
npm run buildpara verificar que no haya errores de compilación - Ejecuta
npm run devy prueba la funcionalidad clave
- Ejecuta