VSS - Futebol de Robôs

# 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}}

## 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).

## 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.

## 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:

![](1.png)

Execute os comandos abaixo para logar na sua conta:

![](2.png)

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.

## 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.

![](3.png)

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) 

![](4.png)

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. 

## Navegar entre os branchs

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

![](5.png)

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:

![](6.png)

## 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>:

![](7.png)

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

![](8.png)

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

![](9.png)

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

![](10.png)

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