Visual Studio Code

Instalação

Instalação no Ubuntu

Para instalar o VSCode no Ubuntu você deve ir na loja de aplicativos do Ubuntu e pesquisar por Visual Studio Code. Lá você conseguirá fazer toda a instalação.

Caso prefira fazer pela linha de comando, use sudo snap install --classic code.

Instalação no Windows e MacOS

Acesse o site oficial e faça o download indicado para Windows ou MacOS (versão estável):

No Windows: Salve o arquivo e, quando finalizado o download, abra-o para fazer a instalação. Siga os passos indicados no instalador. Ao finalizar, você deve ter seu VSCode instalado e funcionando.

No Mac: Basta descompactar o arquivo e mover o Visual Studio Code.app para a pasta Applications.

Configuração e primeiros passos

Terminal

Para abrir um terminal, use Ctrl + Shift + ‘ . Se você estiver no Windows, por padrão, o terminal aberto usará a shell do windows, PowerShell. Recomendamos trocar esse padrão para uma shell padrão do GNU/Linux, como Bash.

Se você já instalou Git no seu sistema, mudar é mais fácil:

Agora você pode fechar esse terminal e abrir outro que ele já estará com a Bash.

Inicializar repositório da disciplina

Durante essa disciplina usaremos o sistema de versionamento Git e o server do IC no GitLab para submeter e postar novas tarefas.

Começaremos criando uma pasta, digamos MC202, onde colocaremos os arquivos da disciplina. No canto superior esquerdo, no menu Files, clique em abrir uma nova pasta (ou com o atalho Ctrl+K Ctrl+O). Selecione a pasta na qual deseja guardar seus arquivos da disciplina.

Após aberta a pasta pelo seu VSCode, podemos agora clonar o seu repositório no GitLab. Abra a paleta de comandos usando Ctrl + Shift + P e digite git clone. Uma vez selecionado esse comando, o campo de texto solicitará a URL do seu repositório. Lembre-se de que a url de seu repositório é https://gitlab.ic.unicamp.br/mc202-2020/ra123456 , trocando 123456 pelo seu RA. Digite o URL e aperte enter. Selecione a pasta que criamos para a disciplina. Depois disso, você precisará digitar seus dados de autenticação. No Windows, deve aparecer um pop-up perguntando seu usuário e senha do Gitlab do IC; o Windows pode guardar esses dados para você. Preencha-os e aperte enter.

Caso você troque sua senha ou tenha escrito errado, tudo o que precisa fazer é

Refazendo os passos descritos anteriormente você deve ser capaz de clonar seu repositório.

Pronto, agora você deverá ter uma pasta chamada ra123456 (seu RA) com as suas tarefas, como mostrado na figura. Lembre-se que para começar a usar o git, você deve primeiro cadastrar seu nome e seu email, com git config --global user.name SEU_NOME e git config --global user.email SEU_EMAIL. Procure utilizar seu e-mail institucional da DAC (com formato aXXXXXX@dac.unicamp.br).

Plugins úteis

Algumas extensões do VSCode serão extremamente úteis para nossa disciplina. Elas farão com que o nosso editor contenha tudo que precisamos. Para instalar qualquer uma das extensões, o processo é o mesmo.

No menu lateral à esquerda, a última opção da parte superior, é onde encontramos nossas extensões. Você clicar diretamente no ícone ou usar o atalho Crtl + Shift + X para acessá-las.

Na barra de pesquisa no segundo painel, digite o nome do plugin que deseja instalar, selecione-o dentre os resultados que surgirem e clique no botão verde Install. Para que o plugin tenha efeito, você deve reiniciar o VSCode.

Aqui vai uma lista de plugins que nós recomendamos:

Dicas uteis

Formatação automática

Você pode formatar seu código automaticamente usando o seguinte atalho:

Antes:

Depois:

Se desejar mudar o estilo de formatação, pesquise Clang_format_fallback no menu de configurações (Ctrl + ,) para ver como alterar o estilo padrão. Você pode escolher qualquer estilo de formatação já consolidado, mas utilize-o consistente.

Workflow do Git

Por fim, gostaríamos de demonstrar algumas funcionalidades para trabalhar com o controle de versões. O terceiro ícone do menu lateral esquerdo permite que você acesse o resumo de seu controle e versões (atalho Ctrl + /Shift + G). Nessa interface, será mostrada a lista de arquivos que diferem do último commit. Clicando em cada arquivo nessa lista, vemos as diferenças.

Na seleção do arquivo, no painel escrito Changes, você pode, da esquerda para a direita, abrir o arquivo, reverter as mudanças ou dar stage. Ao adicionar os arquivos desejados ao stage, no campo Message, você precisa escrever uma mensagem de commit. Você deve escrever boas mensagens, descritivas das alterações; isso irá facilitar muito a sua vida depois. Uma sugestão é sempre começar a mensagem com um verbo:

Uma vez escrita a mensagem, pode-se usar Ctrl + Enter pode registrar o commit.

Lembre-se de que logo depois de registrado o commit, suas mudanças ainda são apenas locais e não foram enviadas ao repositório GitLab do IC. Para sincronizar com seu remoto, utilize o botão em formato de ciclo no canto inferior esquerdo (normalmente é segundo botão azul).

Além disso, todos esse comandos podem ser utilizados manualmente no terminal que configuramos anteriormente.