Vinícios: Vamos colocar para funcionar o código do Freelando! O primeiro passo é criar uma aplicação nova no Vite.
Mônica: Estou ansiosa para aprender como. Afinal, também nunca usei o Vite.
Criação de aplicação no Vite
Vinícios: Na documentação do Vite existem algumas opções para estruturar o projeto. Mas, como usamos o npm na versão anterior do projeto, vamos seguir com esse gerenciador para ter o mínimo de impacto e controlar a migração.
Vamos copiar o comando sugerido para estruturação com npm e abrir o terminal e acessar a área de trabalho com o seguinte comando:
Depois, pedimos com o comando ll para listar o que já temos nessa área de trabalho, porque já temos uma pasta chamado "freelando" do nosso projeto atual.
Vamos criar uma pasta chamada "freelando-vite" no mesmo local para controlar essa migração. Para isso, colamos o comando que havíamos copiado da documentação:
Aparece o prompt para escrever o nome do projeto, onde colocamos freelando-vite.
Project name: freelando-vite
Depois, nos pergunta qual o framework e traz várias opções que podem ser selecionadas com as setas direcionais. Vamos escolher a terceira opção que é o React.
Select a framework: React
Também nos pergunta se queremos usar JavaScript, TypeScript e variantes. Escolhemos JavaScript, pois é o que temos no outro projeto.
Select a variant: JavaScript
Teoricamente, já foram gerados os arquivos necessários. Foi muito rápido.
Scaffolding project in /Users/vinny/Desktop/freelando-vite…
Done
Para testar, devemos navegar e acessar a pasta criada que é o freelando-vite:
Em seguida, vamos rodar um npm install para instalar todas as dependências necessárias.
added 83 packages and audited 84 packages in 7s
9 packages are looking for funding
run npm fund for details
found 0 vulnerabilities
Mônica: Foi a interface de terminal, mas amigável que já vi. Muito bonita. Parabéns, ao pessoal do Vite.
Vinícios: Já instalamos a dependência. Diferentemente do Create React App que iniciamos a aplicação com o comando npm start, agora devemos usar o npm run dev para iniciar a aplicação no Vite.
VITE v4 2.1 ready in 522ms
O endereço em que está disponível é localhost na porta 5173.
Vamos copiar essa URL e colar no navegador para conferir o que vai aparecer.
Mônica: Legal que não foi só o comando que mudou. Geralmente, quando usamos o React o endereço é localhost na porta 3000 ou 8080.
É a primeira vez que encontro uma aplicação automaticamente em uma porta diferente.
Vinícios: Deve ser para evitar esse tipo de conflito com outras aplicações. Afinal, o Vite veio depois e todas essas portas foram usadas antes.
No navegador, o Vite trouxe uma aplicação que parece um pouco com o que o Create React App traz. Porém, com os logotipos do Vite e React lado a lado ao centro de uma tela branca. O logotipo do React gira assim como na aplicação com o Create React App. Logo abaixo, temos um contador em que podemos clicar.
Mais em baixo, um texto em inglês que informa que se você editar o src/App.jsx e salvar, você vai fazer o hot reload. Ou seja, vai atualizar automaticamente a página.
Mas, não queremos seguir com essa página. Queremos pegar o código que já existe, isto é, trazer toda a base de código para o Vite. Vamos fazer isso?
Migração do projeto para o Vite
Mônica: Vamos aprender como fazer essa migração de um projeto que já existe para inserir em uma nova tecnologia.
Vinícios: Existem várias formas de fazer essa migração. Como não temos tantos arquivos, podemos fazer uma cópia manual e experimentar na pasta "freelando-vite". Ou seja, colocar tudo para funcionar antes de fato jogar para o GitHub.
Para isso, paramos o npm run dev com "Ctrl + C" no terminal. Vamos digitar o comando code seguido de espaço e ponto para abrir o VSCode na pasta atual que é o "freelando-vite".
Claro que também poderíamos abrir o programa manualmente. Vamos deixar a janela do VSCode com o projeto "freelando-vite" do lado esquerdo da tela.
Agora, vamos abrir do lado direito da tela outro VSCode com a base de códigos atual. Para isso, damos cd .. para voltar na pasta.
Depois, colocamos cd freelando para acessar a pasta "freelando", onde temos a base de códigos atual.
Por fim, usamos o code . novamente para abrir outra janela do VSCode com o projeto "Freelando", mas vamos deixá-la do lado direito da tela.
A estratégia que vamos utilizar vai ser copy and paste (copiar e colar) mesmo. Vamos copiar toda a parte de código que desenvolvemos na aplicação do "freelando" e jogar para o "freelando-vite".
Repare que as estruturas são parecidas. Ambas têm uma pasta chamada "public" e outra "src". A sigla "src" vem de source que é o código-fonte.
Agora, vamos selecionar múltiplas pastas da pasta "src" do "freelando" e dar "Ctrl + C" no Windows ou "Command + C" no Mac para copiar:
- pasta "componentes"
- pasta "contexto"
- pasta "paginas"
- pasta "router"
- arquivo
App.js.
Vamos dar "Ctrl + V" para colar dentro da pasta "src" no VSCode com o "freelando-vite" do lado esquerdo. Repare que esse copy and paste entre VSCode funciona bem.
Mônica: Note o quão minimalista é o Vite. Temos vários arquivos .js no Create React App que não mexemos, mas que vêm automaticamente quando criamos o projeto. No Vite, não precisamos apagá-los manualmente, pois nem são criados.
Vinícios: Outra diferença importante é a entrada na nossa aplicação no Create React App é um arquivo index.js. Enquanto no Vite, é o arquivo main.jsx.
Por que a extensão JSX? No Create React App, um arquivo .js que tem um componente React, ou seja, que tem código JSX lá dentro, funciona normalmente. Mas, não no Vite.
No Vite, se temos um arquivo que tem código JSX, precisamos explicitamente colocar a extensão .jsx.
Mônica: São mais regras, mas isso não é necessariamente ruim. Podem evitar erros e problemas.
Vinícios: Exato. Além de ajudar o Vite a saber como tratar o arquivo, o que fazer com o que tem ali dentro.
Agora que já copiamos as pastas, podemos minimizar o projeto antigo e maximar o atual com o Vite para começar as alterações.
Alterações no projeto
Vinícios: Primeiro, vamos deletar o arquivo App.jsx e a pasta "assets" que trazem os logotipos e assets do Vite. Ambos estão dentro da pasta "src".
Em seguida, ainda em "src", vamos renomear o arquivo App.js para App.jsx. Repare que o arquivo main.jsx, importa o App de ./App, ou seja, a partir da pasta atual e omite a extensão do app.
main.jsx:
import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App'
import './index.css'
// código omitido…
Também existe um arquivo index.css na pasta raiz que podemos deletar.
Agora, vamos maximizar o terminal novamente e acessar a pasta "freelando-vite". Para isso, voltamos um nível com cd .. e acessamos cd freelando-vite/.
Em seguida, vamos rodar um npm run dev. Será que a inicialização da aplicação vai funcionar?
[vite] Internal server error: Failed to resolve import "/index.css" from "src/main.jsx". Does the file exist?
O primeiro erro foi que importamos o index.css que não existe mais no arquivo main.jsx. Vamos apagar essa importação na linha 4 do "src/main.jsx" e salvar.
Perceba como o Vite foi amigável ao avisar que importamos um arquivo não encontrado e explicar detalhadamente onde estava o erro.
[vite] Internal server error: Failed to resolve import "react-router-dom" from "src/App.jsx". Does the file exist?
Outro erro listado é na importação do RouterProvider do react-router-dom. Ainda não temos essa dependência instalada. Esse não é um arquivo, mas, sim, um pacote do npm.
Vamos precisar reinstalar todos os pacotes adicionais que instalamos no Freelando anteriormente. Para isso, vamos parar e minimizar o terminal.
Voltamos no VSCode do projeto antigo para pegar todas as dependências que devemos instalar. Vamos copiar das dependencies do arquivo package.json para o terminal.
package.json:
"dependencies": {
"@emotion/react": "^11.10.5",
"@emotion/styles": "^11.10.5",
"@testing-library/jest-dom": "^5.16.5",
"@testing-library/react": "^13.4.0",
"@testing-library/user-event": "^13.5.0",
"react": "^18.2.0",
"react-dom": "^18.2.0",
"react-grid-system": "^8.1.8",
"react-router-dom": "^6.8.1",
"react-scripts": "^5.0.1",
"web-vitals": "^2.1.4"
}
Mônica: É exatamente para isso que funciona o arquivo package.json. Se alguém ficar perdido, está listado tudo que foi preciso instalar. É uma recapitulação do que fizemos.
Quando demos npm install para instalar o Vite, foi instalado somente o que ele precisa e não o que estávamos usando no Freelando.
Vinícios: No terminal, escrevemos npm install.
O npm consegue instalar vários pacotes de uma vez só.
Por isso, após um espaço, vamos colar o nome de todos os pacotes de separados por espaços: @emotion/react, @emotion/styled, react-grid-system e react-router-dom
Não vamos trazer nenhum @testing-library, porque ainda não temos teste de nenhum tipo no Freelando. As dependências do react e react-dom já estão instaladas. Por fim, react-scripts e web-vitals são do Create React App e não precisam ser instaladas.
npm install @emotion/react @emotion/styled react-grid-system react-router-dom
found 0 vulnearabilities
Com isso, instalamos as dependências que precisamos para nos livrar do erro que estava acontecendo.
Vamos digitar tentar inicializar novamente a aplicação:
VITE v4 2.1 ready in 276 ms
Teoricamente funcionou, porque não apareceu nenhum erro no terminal. Os retornos voltaram a ficar verdes e foi informado que está ouvindo na localhost pela porta 5173.
Voltamos ao navegador, onde temos o rodapé do Freelando em roxo já que ainda não desenvolvemos uma página inicial.
Senão me engano, podemos acrescentar cadastro ao final da URL para acessar a página de cadastro.
http://localhost:5173/cadastro
Vamos clicar com o botão direito e escolher "Inspect Element" (ou "F12") para abrir o inspecionador de elementos do navegador.
Com a aplicação rodando sem erros, estamos prontos para começar a testar para saber se tudo funcionou. Dessa forma, podemos atualizar o GitHub no próximo vídeo.