O que Upgrade Next.js faz?
Atualize o projeto atual para a versão mais recente do Next.js seguindo os guias oficiais de migração.
Instruções
-
Detectar versão atual: Leia o
package.jsonpara identificar a versão atual do Next.js e dependências relacionadas (React, React DOM, etc.) -
Buscar o guia de upgrade mais recente: Use o WebFetch para obter a documentação oficial de upgrade:
- Codemods: https://nextjs.org/docs/app/building-your-application/upgrading/codemods
- Guias específicos por versão (ajuste a versão conforme necessário):
-
Determinar caminho de upgrade: Com base na versão atual, identifique quais etapas de migração se aplicam. Para saltos grandes de versão, faça o upgrade incrementalmente (ex.: 13 → 14 → 15).
-
Executar codemods primeiro: O Next.js fornece codemods para automatizar mudanças críticas:
npx @next/codemod@latest <transform> <path>Transformações comuns:
next-async-request-api- Atualiza APIs de solicitação assíncrona (v15)next-request-geo-ip- Migra propriedades geo/ip (v15)next-dynamic-access-named-export- Transforma imports dinâmicos (v15)
-
Atualizar dependências: Faça o upgrade do Next.js e dependências relacionadas juntos:
npm install next@latest react@latest react-dom@latest -
Revisar mudanças críticas: Verifique no guia de upgrade as alterações manuais necessárias:
- Mudanças na API (ex.: params assíncronos na v15)
- Alterações de configuração no
next.config.js - Funcionalidades obsoletas removidas
-
Atualizar tipos TypeScript (se aplicável):
npm install @types/react@latest @types/react-dom@latest -
Testar o upgrade:
- Execute
npm run buildpara verificar erros de build - Execute
npm run deve teste as funcionalidades principais
- Execute