macos.pt.md

Instruções de configuração

Você encontrará abaixo as instruções para configurar seu computador para o curso de desenvolvimento web Le Wagon.

Por favor leia-os com atenção e execute todos os comandos na seguinte ordem.

Se você tiver dúvidas, não hesite em pedir ajuda a um professor 🙋

Você também pode dar uma olhada em nossas cheatsheets para soluções e dicas de problemas comuns ✔️

Vamos começar 🚀

Zoom

Para poder interagir quando não estivermos na mesma sala física, usaremos o Zoom, uma ferramenta de videoconferência.

⚠️ Se você já possui o Zoom instalado, certifique-se de que a versão seja pelo menos 5.6.

Acesse zoom.us/download.

Em Cliente Zoom clique no botão Baixar.

Abra o arquivo que você acabou de baixar para instalar o aplicativo.

Abra o aplicativo Zoom.

Se você tiver um Mac com Apple Silicon, você será solicitado a instalar o Rosetta. Clique em Instalar e digite seu nome de usuário e senha para permitir que a instalação continue.


Se você já possui uma conta Zoom, faça login usando suas credenciais.

Caso contrário, clique no link Cadastre-se gratuitamente:

Você será redirecionado ao site do Zoom para preencher um formulário.

Quando terminar, volte para o aplicativo Zoom e faça login usando suas credenciais.

Você deverá então ver uma tela como esta:

Agora você pode fechar o aplicativo Zoom.

Conta GitHub

Você se inscreveu no GitHub? Caso contrário, faça isso imediatamente.

👉 Carregue uma imagem e coloque seu nome corretamente em sua conta GitHub. Isso é importante porque usaremos um painel interno com seu avatar. Faça isso agora, antes de continuar com este guia.

👉 Ative a Autenticação em Duas Etapas (2FA). O GitHub enviará mensagens de texto com um código quando você tentar fazer login. Isso é importante para a segurança e em breve será necessário para contribuir com código no GitHub.

Uma observação sobre como encerrar aplicativos em um Mac

Clicar na pequena cruz vermelha no canto superior esquerdo da janela do aplicativo em um Mac não o encerra, apenas fecha uma janela ativa. Para sair do aplicativo de verdade pressione Cmd + Q quando o aplicativo estiver ativo ou navegue até APP_NAME -> Quit na barra de menu.

Durante esta configuração, você será solicitado a sair e reabrir os aplicativos várias vezes. Certifique-se de fazer isso corretamente 🙏

Ferramentas de linha de comando

Abra um novo terminal, copie e cole o seguinte comando e pressione Enter:

xcode-select --install

Se você receber a mensagem a seguir, basta pular esta etapa e ir para a próxima.

# ferramentas de linha de comando já estão instaladas, use "Atualização de Software" para instalar atualizações

Caso contrário, abrirá uma janela perguntando se deseja instalar algum software: clique em “Instalar” e aguarde.

✔️ Se você vir a mensagem "O software foi instalado", tudo bem 👍

❌ Se o comando xcode-select --install falhar, tente novamente: às vezes os servidores Apple ficam sobrecarregados.

❌ Se você vir a mensagem "O Xcode não está disponível no servidor de atualização de software", será necessário atualizar o catálogo de atualização de software:

sudo softwareupdate --clear-catalog

Feito isso, você pode tentar instalar novamente.

Homebrew

Homebrew é um gerenciador de pacotes: é um software usado para instalar outros softwares a partir da linha de comando. Vamos instalá-lo!

Abra um terminal e execute:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Isso solicitará sua confirmação (pressione Enter) e sua senha da conta de usuário do macOS (aquela que você usa para fazer login quando você reinicia seu Macbook).

⚠️ Quando você digita sua senha, nada aparecerá na tela, isso é normal. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione Enter.

⚠️ Se você vir este aviso 👇, execute os dois comandos na seção Próximas etapas para adicionar o Homebrew ao seu PATH:

# ⚠️ Execute esses comandos apenas se você viu este aviso ☝
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Se você já tem o Homebrew, ele lhe dirá, tudo bem, vá em frente.

Em seguida, instale algum software útil:

brew update

Se você receber um erro /usr/local deve ser gravável, basta executar isto:

sudo chown -R $USER:admin /usr/local

brew update

Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez).

brew upgrade git || brew install git

brew upgrade gh || brew install gh

brew upgrade wget || brew install wget

brew upgrade imagemagick || brew install imagemagick

brew upgrade jq || brew install jq

brew upgrade openssl || brew install openssl

Visual Studio Code

Instalação

Vamos instalar o editor de texto Visual Studio Code.

Copie (Cmd + C) o comando abaixo e cole-o em seu terminal (Cmd + V):

brew install --cask visual-studio-code

Em seguida, inicie o VS Code executando o seguinte comando em seu terminal:

code

✔️ Se uma janela do VS Code acabou de abrir, você está pronto 👍

❌ Caso contrário, por favor entre em contato com um professor

Extensões do VS Code

Instalação

Vamos instalar algumas extensões úteis no VS Code.

Copie e cole os seguintes comandos em seu terminal:

code --install-extension ms-vscode.sublime-keybindings
code --install-extension emmanuelbeziat.vscode-great-icons
code --install-extension github.github-vscode-theme
code --install-extension MS-vsliveshare.vsliveshare
code --install-extension rebornix.ruby
code --install-extension dbaeumer.vscode-eslint
code --install-extension Rubymaniac.vscode-paste-and-indent
code --install-extension alexcvzz.vscode-sqlite
code --install-extension anteprimorac.html-end-tag-labels

Aqui está uma lista das extensões que você está instalando:

• Sublime Text Keymap and Settings Importer
• VSCode Great Icons
• Live Share
• Ruby
• ESLint
• Paste and Indent
• SQLite

Configuração do Live Share

Visual Studio Live Share é uma extensão do VS Code que permite compartilhar o código em seu editor de texto para depuração e programação em pares: vamos configurá-lo acima!

Inicie o VS Code em seu terminal digitando code e pressionando Enter.

Clique na pequena seta na parte inferior da barra esquerda 👇

• Clique no botão "Compartilhar" e depois em "GitHub (faça login usando a conta GitHub)".
• Um pop-up aparece solicitando que você faça login no GitHub: clique em “Permitir”.
• Você é redirecionado para uma página do GitHub em seu navegador solicitando autorização do Visual Studio Code: clique em "Continuar" e depois em "Autorizar github".
• O VS Code pode exibir pop-ups adicionais: feche-os clicando em "OK".

É isso, você está pronto para continuar!

Tema do Terminal macOS

Inicie um terminal, clique em Terminal > Preferências e defina o tema "Pro" como perfil padrão.

Na guia Janela, defina também seu Tamanho da janela para Colunas: 200, Linhas: 50

Saia e reinicie seu terminal: agora ele deve ter um belo fundo preto, mais agradável aos olhos.

Oh-My-Zsh

Vamos instalar o plugin zsh Oh My Zsh.

Em um terminal execute o seguinte comando:

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Se for perguntado "Deseja alterar seu shell padrão para zsh?", pressione Y

No final seu terminal deverá ficar assim:

✔️ Se isso acontecer, você pode continuar 👍

❌ Caso contrário, por favor entre em contato com um professor

CLI do GitHub

CLI é o acrônimo de Interface de linha de comando.

Nesta seção, usaremos GitHub CLI para interagir com o GitHub diretamente do terminal.

Ele já deve estar instalado no seu computador a partir dos comandos anteriores.

Primeiro, para fazer login, copie e cole o seguinte comando em seu terminal:

⚠️ NÃO edite o email

gh auth login -s 'user:email' -w

gh fará algumas perguntas:

What is your preferred protocol for Git operations? Com as setas, escolha SSH e pressione Enter. SSH é um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha.

Generate a new SSH key to add to your GitHub account? Pressione Enter para pedir ao gh para gerar as chaves SSH para você.

Se você já possui chaves SSH, verá Upload your SSH public key to your GitHub account? Com as setas, selecione o caminho do arquivo de sua chave pública e pressione Enter.

Enter a passphrase for your new SSH key (Optional). Digite algo que você deseja e que você lembrará. É uma senha para proteger sua chave privada armazenada no disco rígido. Em seguida, pressione Enter.

Title for your SSH key. Você pode deixá-lo no "GitHub CLI" proposto, pressione Enter.

Você obterá então a seguinte saída:

! First copy your one-time code: 0EF9-D015
- Press Enter to open github.com in your browser...

Selecione e copie o código (0EF9-D015 no exemplo) e pressione Enter.

Seu navegador será aberto e solicitará que você autorize o GitHub CLI a usar sua conta GitHub. Aceite e espere um pouco.

Volte ao terminal, pressione Enter novamente e pronto.

Para verificar se você está conectado corretamente, digite:

gh auth status

✔️ Se você estiver Logado no github.com como <SEU NOME DE USUÁRIO> , então tudo bem 👍

❌ Caso contrário, entre em contato com um professor.

Dotfiles (configuração padrão)

Os hackers adoram refinar e aprimorar sua estrutura e ferramentas.

Começaremos com uma ótima configuração padrão fornecida pelo Le Wagon: lewagon/dotfiles.

Como sua configuração é pessoal, você precisa de seu próprio repositório para armazená-la. Então você irá fazer o fork do repositório Le Wagon.

Bifurcar significa que você criará um novo repositório em sua própria conta GitHub $GITHUB_USERNAME/dotfiles, idêntico ao original do Le Wagon que você poderá modificar à vontade.

Abra seu terminal e defina uma variável para seu nome de usuário GitHub:

export GITHUB_USERNAME=`gh api user | jq -r '.login'`

echo $GITHUB_USERNAME

✔️ Você deverá ver seu nome de usuário do GitHub impresso.

❌ Se não, pare aqui e peça ajuda. Pode haver um problema com a etapa anterior (gh auth).

⚠️ Por favor note que esta variável só é definida para o tempo em que seu terminal está aberto. Se você fechá-lo antes ou durante as próximas etapas, será necessário configurá-lo novamente com as duas etapas acima!

É hora de fazer um fork do repositório e cloná-lo em seu computador:

mkdir -p ~/code/$GITHUB_USERNAME && cd $_

gh repo fork lewagon/dotfiles --clone

Instalador do Dotfiles

Execute o instalador dotfiles:

cd ~/code/$GITHUB_USERNAME/dotfiles

zsh install.sh

Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa:

gh api user/emails | jq -r '.[].email'

✔️ Se você vir a lista de seus e-mails registrados, você pode prosseguir 👍

❌ Caso contrário, reautentique no GitHub antes de executar este comando ☝️ novamente.

Instalador git

Execute o instalador git:

cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh

☝️ Isso solicitará seu nome (Nome Sobrenome) e seu e-mail. O email que você escolher será exibido publicamente na internet. 💡 Selecione o endereço @users.noreply.github.com se você não deseja que seu e-mail apareça em repositórios públicos aos quais você possa contribuir.

⚠️ Você precisa colocar um dos e-mails listados acima graças ao comando anterior gh api .... Se você não fizer isso, Kitt não conseguirá acompanhar seu progresso.

Agora reinicie seu terminal executando:

exec zsh

rbenv

Vamos instalar o rbenv, um software para instalar e gerenciar ambientes ruby.

Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter:

rvm implode && sudo rm -rf ~/.rvm
# If you got "zsh: command not found: rvm", carry on. It means `rvm` is not
# on your computer, that's what we want!

sudo rm -rf $HOME/.rbenv /usr/local/rbenv /opt/rbenv /usr/local/opt/rbenv

⚠️ Este comando pode solicitar sua senha.

⚠️ Quando você digita sua senha, nada aparecerá na tela, isso é normal. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione Enter.

No terminal, execute:

brew uninstall --force rbenv ruby-build

exec zsh

Então rode:

brew install rbenv

Ruby

Instalação

Agora, você está pronto para instalar a versão mais recente do ruby e defini-la como a versão padrão.

Execute este comando, demorará um pouco (5 a 10 minutos)

rbenv install 3.3.5

Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema para usar a versão 3.3.5 por padrão.

rbenv global 3.3.5

Reinicialize seu terminal e verifique sua versão do Ruby:

exec zsh

Então corra:

ruby -v

✔️ Se você vir algo começando com ruby 3.3.5 então você pode prosseguir 👍

❌ Se não, pergunte a um professor

Instalando algumas gems

Se você estiver na China 🇨🇳 clique aqui

⚠️ Se você estiver na China, você deve atualizar a forma como instalaremos o gem com os seguintes comandos.

# Somente China!
fontes de gemas --remove https://rubygems.org/
fontes de gemas -a https://gems.ruby-china.com/
fontes de gemas -l
#***FONTES ATUAIS***
# https://gems.ruby-china.com/
# Ruby-china.com deve estar na lista agora

Todos, na China ou não, continuem aqui para instalar gems.

No mundo Ruby, chamamos bibliotecas externas de gems: são pedaços de código Ruby que você pode baixar e executar em seu computador. Vamos instalar alguns!

No seu terminal, copie e cole o seguinte comando:

gem install colored faker http pry-byebug rake rails:7.1.3.4 rest-client rspec rubocop-performance sqlite3:1.7.3 activerecord:7.1.3.2

✔️ Se você tiver xx gems installed, então tudo bem 👍

❌ Se você encontrar o seguinte erro:

ERROR: While executing gem ... (TypeError)
incompatible marshal file format (can't be read)
format version 4.8 required; 60.33 given

Execute o seguinte comando:

rm -rf ~/.gemrc

Execute novamente o comando para instalar as gemas.

⚠️ NUNCA instale uma gem com sudo gem install! Mesmo se você encontrar uma resposta do Stackoverflow (ou o terminal) solicitando que você faça isso.

Node.js

Node.js é um tempo de execução JavaScript para executar código JavaScript no terminal. Vamos instalá-lo com nvm, um gerenciador de versões para Node.js.

Em um terminal, execute os seguintes comandos:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh

exec zsh

Em seguida, execute o seguinte comando:

nvm -v

Você deverá ver uma versão. Se não, pergunte a um professor.

Agora vamos instalar o Node.js:

nvm install 20.17.0

Quando a instalação terminar, execute:

node -v

Se você vir v20.17.0, a instalação foi bem-sucedida ✔️ Você pode então executar:

nvm cache clear

❌ Caso contrário, entre em contato com um professor

Yarn

yarn é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo:

Em um terminal, execute os seguintes comandos:

corepack enable
yarn set version stable

exec zsh

⚠️ Se vires quaisquer mensagens de erro, tenta executar npm install -g corepack e, em seguida, volta a executar os comandos acima.

Em seguida, execute o seguinte comando:

yarn -v

✔️ Se você vir uma versão, você está bem 👍

❌ Se não, entre em contato com um professor

SQLite

Em algumas semanas falaremos sobre bancos de dados e SQL. SQLite é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo:

Em um terminal, execute os seguintes comandos:

brew install sqlite

Em seguida, execute o seguinte comando:

sqlite3 -version

✔️ Se você vir uma versão, você está bem 👍

❌ Se não, peça um professor

PostgreSQL

Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada PostgreSQL, um sistema de banco de dados de código aberto, robusto e pronto para produção.

Vamos instalá-lo agora.

Execute os seguintes comandos:

brew install postgresql@15 libpq
brew link --force libpq

brew services start postgresql@15

Depois de fazer isso, vamos verificar se funcionou:

psql -d postgres

Você deverá ver um novo prompt como este 👇

psql (15.2)
Type "help" for help.

postgres=#

✔️ Se for esse o caso, digite \q e depois Enter para sair deste prompt. Você está pronto para ir 👍

❌ Se não, por favor entre em contato com um professor

Checagem

Vamos verificar se você instalou tudo com sucesso.

No seu terminal, execute o seguinte comando:

exec zsh

Então corra:

curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb

✔️ Se você receber uma mensagem verde Awesome! Your computer is now ready!, então você está bem 👍

❌ Caso contrário, entre em contato com um professor.

Kitt

⚠️ Se você recebeu um e-mail do Le Wagon convidando você a se inscrever no Kitt (nossa plataforma de aprendizagem), você pode pular esta etapa com segurança. Em vez disso, siga as instruções no e-mail que você recebeu, caso ainda não tenha feito isso.

Se não tiver certeza sobre o que fazer, siga este link. Se você já estiver logado, pode pular esta seção com segurança. Se você não estiver logado, clique em Enter Kitt as a Student. Se você conseguir fazer login, poderá pular esta etapa com segurança. Caso contrário, pergunte a um professor se você deveria ter recebido um e-mail ou siga as instruções abaixo.

Registre-se como Alumni da Le Wagon acessando kitt.lewagon.com/onboarding. Selecione seu batch, faça login no GitHub e insira todas as suas informações.

Seu professor irá então validar que você realmente faz parte do batch. Você pode pedir que eles façam isso assim que preencher o formulário de registro.

Assim que o professor aprovar seu perfil, acesse sua caixa de entrada de e-mail. Você deve ter 2 e-mails:

• Um do Slack, convidando você para a comunidade Le Wagon Alumni do Slack (onde você conversará com seus amigos e todos os ex-alunos anteriores). Clique em Inscreva-se e preencha os dados.
• Um do GitHub, convidando você para a equipe lewagon. Aceite caso contrário você não conseguirá acessar os slides da aula.

Slack

Slack é uma plataforma de comunicação bastante popular na indústria de tecnologia.

Instalação

Baixe o aplicativo Slack e instale-o.

⚠️ Se você já usa o Slack em seu navegador, baixe e instale o aplicativo para desktop que vem com todos os recursos.

Configurações

Inicie o aplicativo e faça login na organização lewagon-alumni.

Certifique-se de fazer upload de uma foto de perfil 👇

A ideia é que você tenha o Slack aberto o dia todo, para que você possa compartilhar links úteis/pedir ajuda/decidir onde ir almoçar/etc.

Para garantir que tudo está funcionando bem nas videochamadas, vamos testar sua câmera e microfone:

• Abra o aplicativo Slack
• Clique na foto do seu perfil no canto superior direito.
• Selecione Preferências no menu.
• Clique em Áudio e vídeo na coluna do lado esquerdo.
• Abaixo de Solução de problemas, clique em Executar um teste de áudio, vídeo e compartilhamento de tela. O teste será aberto em uma nova janela.
• Verifique se seus dispositivos preferidos de alto-falante, microfone e câmera aparecem nos menus suspensos e clique em Iniciar teste.

✔️ Quando o teste terminar, você deverá ver mensagens verdes de "Sucesso" pelo menos para seu microfone e câmera. 👍

❌ Caso contrário, entre em contato com um professor.

Você também pode instalar o aplicativo Slack no seu telefone e entrar em lewagon-alumni!

Configurações do MacOS

Segurança

É obrigatório que você proteja sua sessão com uma senha. Se ainda não for o caso, vá para  > Ajustes do Sistema > Usuários e Grupos e altere a senha da sua conta. Você também deve ir para  > Ajustes do Sistema > Segurança > Geral. Você deve exigir uma senha 5 segundos após o início da suspensão ou da proteção de tela.

Você também pode ir para  > Ajustes do Sistema > Controle daVelocidade de repetição de teclaVelocidade de repetição de Escritorio y Dock e clicar no botão cantos de acesso rápido (Hot Corners) no canto inferior esquerdo. Escolha no canto inferior direito para iniciar o protetor de tela. Dessa forma, ao sair da mesa, você pode bloquear rapidamente a tela colocando o mouse no canto inferior direito. 5 segundos depois, seu MacBook estará bloqueado e solicitará uma senha para voltar à sessão.

Teclado

Ao se tornar um programador, você entenderá que deixar o teclado leva muito tempo, então você vai querer minimizar o uso do trackpad ou do mouse. Aqui estão alguns truques no macOS para ajudá-lo a fazer isso.

Velocidade do teclado

Vá para  > Preferências do Sistema > Teclado. Defina Velocidade de repetição de tecla para a posição mais rápida (à direita) e Atraso da repetição para a posição mais curta (à direita).

macOS Para hackers

Leia este script e escolha algumas coisas que você acha que combinam com você. Por exemplo, você pode digitar no terminal este:

# Expanding the save panel by default
defaults write NSGlobalDomain NSNavPanelExpandedStateForSaveMode -bool true
defaults write NSGlobalDomain PMPrintingExpandedStateForPrint -bool true
defaults write NSGlobalDomain PMPrintingExpandedStateForPrint2 -bool true

# Save screenshots to the Desktop (or elsewhere)
defaults write com.apple.screencapture location "${HOME}/Desktop"

# etc..

Fixe aplicativos no seu dock

Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Vamos fixá-los no seu dock para que fiquem a apenas um clique de distância!

Para fixar um aplicativo no seu dock, inicie o aplicativo, clique com o botão direito no ícone na barra de tarefas para abrir o menu de contexto e escolha "Opções" e depois "Manter no Dock".

Você deve fixar:

• Seu terminal
• Seu explorador de arquivos
• VS Code
• Seu navegador de Internet
• Slack
• Zoom

Configuração concluída!

Seu computador agora está pronto para o curso de Desenvolvimento Web Le Wagon 💪 👏

Aproveite o bootcamp, você vai acertar 🚀