Tutorial Basico - Git e GitHub
1 Pre-requisitos
Antes de comecar, voce precisa:
- Ter o Git instalado - https://git-scm.com/downloads
- Criar uma conta no GitHub - https://github.com
- Configurar seu nome e e-mail (para identificar seus commits):
git config --global user.email "seuemail@example.com"
2 Clonar um repositorio existente do GitHub
Se voce quer trabalhar em um projeto que ja existe, primeiro precisa clona-lo.
-
No GitHub, va ate o repositorio que voce quer clonar. Exemplo:
https://github.com/usuario/repositorio.git -
No terminal (ou Git Bash), rode:
Isso cria uma copia local do projeto na sua maquina.
- Entre na pasta do projeto:
3 Verificar o status das mudancas
Antes de enviar as mudancas, veja o que foi alterado:
4 Adicionar os arquivos ao commit
Adicione os arquivos modificados a "area de stage":
Ou para adicionar todos os arquivos modificados:
5 Fazer um commit (salvar a versao local)
Crie um commit com uma mensagem explicando o que mudou:
6 Enviar as mudancas para o GitHub
Se o repositorio ja tem um remoto configurado (chamado origin), envie assim:
master em vez de main. Verifique com:
Utilize o comando abaixo para renomear a branch
7 (Opcional) Criar uma nova branch
Para trabalhar em algo sem afetar o codigo principal:
Depois, envie essa branch para o GitHub:
8 Atualizar o projeto com as ultimas mudancas
Antes de comecar novas alteracoes, e bom atualizar o codigo:
Resumo dos principais comandos
| Acao | Comando |
|---|---|
| Clonar repositorio | git clone URL |
| Entrar na pasta | cd nome-do-repo |
| Ver status | git status |
| Adicionar arquivos | git add . |
| Criar commit | git commit -m "mensagem" |
| Enviar ao GitHub | git push origin main |
| Atualizar repositorio | git pull origin main |
Tipo e descricao
O commit semantico possui os elementos estruturais abaixo (tipos), que informam a intencao do seu commit ao utilizador(a) de seu codigo.
-
feat- Commits do tipo feat indicam que seu trecho de codigo esta incluindo um novo recurso (se relaciona com o MINOR do versionamento semantico). -
fix- Commits do tipo fix indicam que seu trecho de codigo commitado esta solucionando um problema (bug fix), (se relaciona com o PATCH do versionamento semantico). -
docs- Commits do tipo docs indicam que houveram mudancas na documentacao, como por exemplo no Readme do seu repositorio. (Nao inclui alteracoes em codigo). -
test- Commits do tipo test sao utilizados quando sao realizadas alteracoes em testes, seja criando, alterando ou excluindo testes unitarios. (Nao inclui alteracoes em codigo) -
build- Commits do tipo build sao utilizados quando sao realizadas modificacoes em arquivos de build e dependencias. -
perf- Commits do tipo perf servem para identificar quaisquer alteracoes de codigo que estejam relacionadas a performance. -
style- Commits do tipo style indicam que houveram alteracoes referentes a formatacoes de codigo, semicolons, trailing spaces, lint... (Nao inclui alteracoes em codigo). -
refactor- Commits do tipo refactor referem-se a mudancas devido a refatoracoes que nao alterem sua funcionalidade, como por exemplo, uma alteracao no formato como e processada determinada parte da tela, mas que manteve a mesma funcionalidade, ou melhorias de performance devido a um code review. -
chore- Commits do tipo chore indicam atualizacoes de tarefas de build, configuracoes de administrador, pacotes... como por exemplo adicionar um pacote no gitignore. (Nao inclui alteracoes em codigo) -
ci- Commits do tipo ci indicam mudancas relacionadas a integracao continua (continuous integration). -
raw- Commits do tipo raw indicam mudancas relacionadas a arquivos de configuracoes, dados, features, parametros. -
cleanup- Commits do tipo cleanup sao utilizados para remover codigo comentado, trechos desnecessarios ou qualquer outra forma de limpeza do codigo-fonte, visando aprimorar sua legibilidade e manutenibilidade. -
remove- Commits do tipo remove indicam a exclusao de arquivos, diretorios ou funcionalidades obsoletas ou nao utilizadas, reduzindo o tamanho e a complexidade do projeto e mantendo-o mais organizado.