Preparando o ambiente de desenvolvimento

1. Apresentação

Neste curso você construirá, passo a passo, o aplicativo didático ToDoList: lista de tarefas em React Native, com Expo e TypeScript, usando a inteligência artificial integrada à IDE para acelerar tarefas — sempre revisando e testando você mesmo.

• React Native + Expo: base para apps Android (e iOS no futuro).
• TypeScript: código mais claro e seguro.
• IA na IDE: chat para dúvidas; modo agente apenas quando você autorizar alterações.

Nesta aula você instala e valida ferramentas no Windows. Na Aula 02 você prepara regras, MCP e prompts para a IA. Na Aula 03 criaremos o projeto Expo do ToDoList. Não é necessário conhecer React Native agora.

2. Pré-requisitos

• Windows 10 ou 11 (ambiente principal desta aula).
• Computador com internet e permissão para instalar programas.
• Noções de arquivos e pastas (criar pasta, navegar).
• Conta para autenticar no assistente de IA escolhido (Cursor ou GitHub para Copilot).
• Celular Android opcional (útil em módulos futuros).

3. Ferramentas do curso

4. Terminal PowerShell

Onde abrir: tecla Windows → digite PowerShell → abra Windows PowerShell ou Terminal (Windows 11).

Comandos básicos

pwd          # mostra a pasta atual
dir          # lista arquivos e pastas
cd NomePasta # entra na pasta
mkdir Nome   # cria pasta (alternativa abaixo)

Esperado: pwd exibe um caminho (ex.: C:\Users\SeuNome). dir lista conteúdo. Erros de “não encontrado” indicam nome de pasta incorreto.

Pasta de trabalho do curso

New-Item -ItemType Directory -Path "$HOME\ProjetosMobile" -Force
Set-Location "$HOME\ProjetosMobile"
pwd

Esperado: última linha mostra algo como C:\Users\SeuNome\ProjetosMobile. Essa pasta armazenará os projetos do curso (ainda não é o aplicativo — o app ToDoList será criado na Aula 03).

Onde criar a pasta de trabalho?

A localização fica a seu critério. Nos exemplos, usamos ProjetosMobile dentro do diretório pessoal do Windows ($HOME\ProjetosMobile). Também é possível criar na raiz de uma unidade, por exemplo C:\ProjetosMobile ou D:\ProjetosMobile, conforme sua organização e permissões.

Alternativa: criando a pasta pelo Explorador de Arquivos do Windows

Se preferir a interface gráfica, você pode fazer a mesma operação sem usar o PowerShell para criar a pasta — escolha um método (terminal ou Explorador), não os dois.

1. Pressione Windows + E para abrir o Explorador de Arquivos.
2. Clique em Este Computador.
3. Escolha a unidade desejada (por exemplo C:).
4. Navegue até onde deseja organizar seus projetos.
5. Clique com o botão direito em uma área vazia.
6. Selecione Novo → Pasta, ou use Ctrl + Shift + N quando disponível.
7. Digite ProjetosMobile e pressione Enter.

Exemplo A — pasta do usuário: C:\Users\SeuUsuario\ProjetosMobile
Exemplo B — raiz do disco: C:\ProjetosMobile
SeuUsuario é ilustrativo; no seu PC aparece o nome do seu perfil.

Conectando o Explorador ao PowerShell

Depois de criar a pasta, abra o terminal e vá até ela com cd (change directory — mudar o diretório de trabalho). Ajuste o caminho ao local que você escolheu:

cd "C:\ProjetosMobile"

Dica: no Explorador, abra a pasta, clique na barra de endereço, copie o caminho completo e use-o entre aspas no comando cd.

5. Instalação do Node.js e npm

1. Acesse nodejs.org e baixe a versão LTS recomendada para Windows.
2. Execute o instalador (aceite licença; mantenha npm e adição ao PATH se oferecidos).
3. Feche e reabra o PowerShell (ou Terminal).

node --version
npm --version

Esperado: duas linhas com números de versão (ex.: v22.x.x e 10.x.x). Não fixe um número específico — LTS muda com o tempo.

Se falhar: veja a seção Problemas comuns.

6. Instalação do Git

1. Baixe em git-scm.com/downloads/win.
2. Instale com opções padrão (Git no PATH).
3. Reabra o terminal e execute:

git --version

Esperado: git version 2.x.x.

Conceitos locais: repositório guarda o histórico do projeto; commit registra um snapshot das alterações.

Git e GitHub não são a mesma coisa

Git é a ferramenta instalada no computador para controlar versões dos arquivos. GitHub (github.com) é um serviço online para hospedar repositórios Git, compartilhar código, colaborar e manter cópia remota do trabalho.

Uma conta GitHub pode ser útil para:

• Guardar cópia remota do projeto.
• Compartilhar código-fonte e histórico de alterações.
• Colaborar com outras pessoas.
• Consultar exemplos de projetos.
• Acessar o GitHub Copilot, se for sua opção de IA (caminho B).

Importante: não é necessário ter conta GitHub para instalar e usar Git localmente. Para o Copilot, será necessário autenticar com conta GitHub elegível. No futuro, disponibilizaremos exemplos do ToDoList em repositório público vinculado à Academia PHR Software. Nesta aula não é obrigatório criar repositório remoto.

7. Instalação da IDE (escolha um caminho)

Caminho A — Cursor

1. Baixe e instale em cursor.com.
2. Crie ou acesse uma conta quando solicitado.
3. Menu File → Open Folder (ou equivalente) → selecione ProjetosMobile.
4. Localize: explorador de arquivos, editor central, terminal integrado (geralmente Ctrl+`) e painel de chat.
5. Selecione um modelo disponível na sua conta; nomes e botões variam conforme a versão.
6. Use o chat para perguntas; use recursos de agente somente quando quiser que arquivos sejam alterados — e revise cada mudança.

Caminho B — VS Code + GitHub Copilot

1. Instale o Visual Studio Code.
2. Crie ou acesse conta GitHub se ainda não tiver.
3. Siga Configurar Copilot no VS Code e habilite Copilot (incluindo Copilot Free, se elegível).
4. Abra o chat Copilot e identifique o modo agente, se disponível na sua versão.
5. File → Open Folder → pasta ProjetosMobile.

Conhecendo o chat, os modos de trabalho e os modelos de IA

• IDE: onde o código é desenvolvido e as pastas do projeto são abertas.
• Chat: interface para conversar com a IA.
• Modelo: mecanismo de IA selecionado para responder ou executar a tarefa.
• Modo de trabalho: define se a IA só orienta ou também pode agir no projeto (conforme permissões).

Toque ou clique na imagem para ampliar.

Cursor (referência principal)

Os nomes exatos podem variar conforme a versão — confira na documentação oficial do Cursor. Fluxo sugerido:

1. Abra o Cursor e a pasta ProjetosMobile.
2. Localize e abra o painel de chat (atalho comum: Ctrl+L ou ícone de chat — pode mudar).
3. Identifique o seletor de modo e o seletor de modelo no painel.
4. Escolha um modelo disponível no seu plano (automático ou opção gratuita).
5. Envie uma pergunta simples; leia a resposta antes de pedir alterações em arquivos.

Modos (conforme a versão instalada):

• Ask (ou equivalente “perguntar”): foco em perguntas, explicações e análise, sem pedir modificações diretas no projeto. Recomendado para o primeiro contato.
• Agent: orientado a executar tarefas; pode analisar arquivos, propor alterações e rodar ferramentas, conforme permissões. Acompanhe e revise cada passo.
• Plan / Planning (se aparecer): ajuda a estruturar um plano antes de implementar — útil para tarefas maiores. Se sua versão usar outro nome, procure a opção que descreve planejamento antes de editar código.

Escolhendo o modelo: você pode ver seleção automática, modelos específicos ou limites de uso. Para o primeiro exercício, prefira automático ou uma opção incluída no plano gratuito — não é necessário o modelo mais avançado.

VS Code + GitHub Copilot

Abra o painel Copilot Chat, identifique modos disponíveis (podem diferir do Cursor), selecione modelo quando houver, faça perguntas sobre o projeto e localize recursos de agente, se existirem. Verifique limites do plano em GitHub Copilot — plans.

Primeiro exercício no chat (modo pergunta)

Use o modo de perguntas (Ask ou equivalente). Envie:

Explique de maneira simples a diferença entre Node.js, npm, Git e Expo, considerando que estou iniciando o desenvolvimento de aplicativos React Native.

Leia a resposta e faça uma pergunta complementar. Não é necessário modificar arquivos neste exercício. O prompt de diagnóstico do ambiente permanece na seção 9.

8. Planos gratuitos e pagos

A IDE e o modelo de IA são coisas diferentes. O curso prioriza começar no plano gratuito, quando possível. Assinaturas pagas são opcionais.

• Chat e agente podem consumir cotas ou créditos.
• Confira limites, renovação automática e cobrança antes de contratar.
• Consulte sempre páginas oficiais: Cursor — pricing, GitHub Copilot — plans.
• Não fixamos preço do Cursor aqui (pode variar entre páginas e regiões).
• Referência Copilot Pro: cerca de US$ 10/mês (outubro de 2026), sujeito a alteração — confirme no site GitHub.

Opcional — como contratar plano pago

Entre apenas no site oficial do provedor, compare planos, leia valores e condições, cancele renovação automática se não desejar continuidade, e confirme a cobrança conscientemente. Não use revendedores não oficiais nem “contas compartilhadas”.

9. Primeiro prompt de IA

Envie no chat da IDE (não no agente, neste primeiro contato). Cole o texto abaixo, substituindo nada — execute você mesmo os comandos que a IA sugerir.

Estou começando a aprender desenvolvimento mobile com React Native, Expo e TypeScript em um computador Windows.

Sou iniciante.

Oriente-me a verificar se Node.js, npm e Git estão funcionando corretamente.

Apresente os comandos para PowerShell, explique o resultado esperado e ajude a interpretar possíveis erros.

Não instale nada, não execute comandos e não altere arquivos sem minha autorização.

Ao final, apresente um checklist do ambiente.

Conversa vs. agente: no chat, a IA orienta; no agente, ela pode editar arquivos e rodar comandos. Nesta aula, você digita no terminal e confere. Autorize agente só quando entender o que será alterado.

10. Problemas comuns

• “node” não reconhecido / Git não reconhecido: reinstale marcando PATH; reinicie o terminal; reinicie o PC se necessário.
• npm.ps1 bloqueado no PowerShell: teste diagnóstico npm.cmd --version. Não desative antivírus nem políticas globais sem orientação. Peça ajuda à IA com a mensagem exata (sem senhas).
• PATH incorreto: confirme instalação LTS do Node; abra novo terminal.
• Chat indisponível: verifique login, internet e status do serviço.
• Limite gratuito: confira plano em pricing oficial; aguarde renovação de cota ou reduza uso de agente.
• Pasta não encontrada: rode pwd e recrie ProjetosMobile com os comandos da seção 4.
• Permissão negada: evite instalar em pastas protegidas; use sua pasta de usuário.

11. Exercício final

12. Checklist de conclusão

Marque mentalmente ou no caderno — o site não salva progresso nesta fase.

• PowerShell ou Terminal abre e responde a comandos
• Pasta ProjetosMobile criada
• Node.js verificado (node --version)
• npm verificado (npm --version)
• Git verificado (git --version)
• IDE instalada e pasta ProjetosMobile aberta
• Conta de IA autenticada (Cursor ou GitHub/Copilot)
• Primeiro prompt de verificação enviado e interpretado

Próximo passo: quando todos os itens estiverem OK, siga para a Aula 02 — Preparando a IA. O projeto Expo (ToDoList) vem na Aula 03.

13. Referências

• Documentação Expo
• Node.js
• Documentação Git
• Cursor
• VS Code — documentação
• GitHub Copilot