VSS - Futebol de Robôs

1. Tutorial - Git

O github é uma plataforma online de gerenciamento de arquivos muito utilizado para projetos de desenvolvimento que envolvem muitas pessoas. Usamos aqui na VSS, e também nos outros projetos da RoboIME, pois permite trabalho organizado, pois todos terão acesso aos trabalhos feitos pelos outros integrantes.
O responsável por aceitar pessoas no repositório será o Luiz Sampaio. Ao entrar no github da VSS, solicite sua entrada para poder utilizar os recursos e, qualquer problema, fale com ele.
Obs: todas as imagens mostram uma pasta da SEK pois esse tutorial foi feito inicialmente para a SEK. Porém, a única diferença é que, em vez de SEK, você verá VSS

{{toc}}

1. Instalar o github

Para instalar, acesse o site do [git](https://git-scm.com/downloads) e instale para o seu sistema operacional. Para o Windows, será instalado o gitbash, que será utilizado para escrever os comandos (é semelhante ao Terminal no Linux/MacOS).

1. Cadastrar-se no github

Entre no site do [github](https://github.com) e crie uma conta. Depois disso, você deverá ser adicionado na organização da RoboIME. Lá, terá um repositório da VSS, onde estarão os arquivos que forem feitos.

1. Criar seu usuário no gitbash

Feito isso, é necessário que você entre com seu login no gitbash para fazer commits depois. Ao abrir o gitbash, você verá a seguinte tela:


Execute os comandos abaixo para logar na sua conta:


O user.email é o e-mail que você cadastrou no github, e o user.name é o seu nickname no github.
Agora, você foi definido como usuário global do seu computador, e pode fazer commits.

1. Fazer download do projeto pela primeira vez

Depois de logar, você precisa criar uma pasta em seu computador para ter os arquivos da VSS. É a mesma pasta que você vai colocar os arquivos que fizer para que todos da equipe vejam e usem depois. Ao abrir o gitbash, provavelmente você estará na pasta de seu usuário. Neste exemplo, vamos criar a pasta ROBOIME dentro da pasta Documents para ter nosso arquivo.


O comando cd serve para você entrar nas pastas, e o comando mkdir serve para você criar pastas. Utilize agora o comando clone para baixar o repositório da SEK para a pasta que você criou, cujo link é https://github.com/roboime/VSS.git. Depois, o comando cd VSS é utilizado para você acessar a pasta dos arquivos da VSS. Perceba que agora a linha de comando mostra:

seuUsuario@seuPC MINGW64 ~/VSS (master)


Isso significa que você está no branch master, que é a pasta principal de arquivos. Porém, enquanto estivermos desenvolvendo os projetos, nossos arquivos devem ser mandados para o branch development, que é onde estarão os arquivos em desenvolvimento. Imagine que o branch master é o tronco de uma árvore. O branch development é um ramo da árvore no qual você pode trabalhar em paralelo com outros branchs, por exemplo, master. Conforme você faz commits, o ramo cresce, deixando versões anteriores para trás armazenadas na árvore. Computacionalmente, um branch é um ponteiro que aponta para o seu último commit.

1. Navegar entre os branchs

Para trocar de branch, basta utilizar o comando checkout, como no exemplo:


Você pode também usar o comando checkout . para apagar as alterações que você fizer em qualquer momento. Isso é importante para ser usado às vezes antes do comando pull para ter o projeto na versão mais recente, pois alterações que fazemos podem não ficar boas.
Agora, para atualizar sua pasta com o que foi feito pelos outros, você utiliza o comando pull, como no exemplo:


1. Fazer e ver commits

Para você adicionar um arquivo ao repositório, primeiramente você deve copiá-lo para a pasta VSS do seu computador. Agora, se você usar o comando status, o arquivo que você colocou aparecerá como "em espera" para depois ser enviado por você com o comando add <nome do arquivo>:


Agora, você precisa usar o comando commit para poder enviar para o repositório:


Para checar que o envio foi feito, e também para ver os envios passados dos integrantes da equipe, utilize o comando log:


Para enviar agora suas alterações para o repositório, utilize o comando push. Será necessário colocar seu usuário e senha.


Pronto! Agora tudo que você fez foi salvo no repositório da VSS, e estará disponível para todos da equipe usarem.