Que fait Mise à niveau de Next.js ?
Met à jour le projet actuel vers la dernière version de Next.js en suivant les guides de migration officiels.
Instructions
-
Détecter la version actuelle : Lisez
package.jsonpour identifier la version actuelle de Next.js et les dépendances associées (React, React DOM, etc.) -
Récupérer le dernier guide de mise à niveau : Utilisez WebFetch pour obtenir la documentation officielle de mise à niveau :
- Codemods : https://nextjs.org/docs/app/building-your-application/upgrading/codemods
- Guides par version (ajustez la version selon les besoins) :
-
Déterminer le chemin de mise à niveau : En fonction de la version actuelle, identifiez les étapes de migration applicables. Pour les sauts de version majeurs, effectuez la mise à niveau de manière progressive (par ex., 13 → 14 → 15).
-
Exécuter les codemods en premier : Next.js fournit des codemods pour automatiser les changements cassants :
npx @next/codemod@latest <transform> <path>Transformations courantes :
next-async-request-api- Met à jour les API de requête asynchrones (v15)next-request-geo-ip- Migre les propriétés geo/ip (v15)next-dynamic-access-named-export- Transforme les imports dynamiques (v15)
-
Mettre à jour les dépendances : Mettez à niveau Next.js et ses dépendances associées ensemble :
npm install next@latest react@latest react-dom@latest -
Examiner les changements cassants : Consultez le guide de mise à niveau pour les modifications manuelles nécessaires :
- Changements d'API (par ex., params asynchrones dans v15)
- Modifications de configuration dans
next.config.js - Fonctionnalités dépréciées supprimées
-
Mettre à jour les types TypeScript (le cas échéant) :
npm install @types/react@latest @types/react-dom@latest -
Tester la mise à niveau :
- Exécutez
npm run buildpour vérifier les erreurs de build - Exécutez
npm run devet testez les fonctionnalités clés
- Exécutez