Se você está começando a estudar desenvolvimento ou já tem alguma experiência, mas ainda não domina o processo de publicação no GitHub, este artigo é para você. Aqui vamos mostrar um guia prático Java: criando e publicando seu projeto no GitHub! Para saber, você pode assistir o vídeo incrível que saiu no Youtube da Orange!
Por que publicar no GitHub?
O GitHub é muito mais do que um repositório de código. É uma plataforma de colaboração, versionamento e demonstração do seu trabalho para o mundo. Publicar seus projetos no GitHub permite:
- Colaboração: facilite a contribuição de outros desenvolvedores para o seu projeto.
- Versionamento: acompanhe as mudanças no seu código e reverta para versões anteriores se necessário.
- Portfólio: mostre suas habilidades para potenciais empregadores ou clientes.
- Backup: mantenha seu código seguro na nuvem.
Mão na massa: publicando seu projeto
Vamos seguir os passos práticos para publicar seu projeto no GitHub, inspirados no vídeo do nosso canal:
1. Inicialize o Repositório Localmente:
Abra o terminal na pasta do seu projeto e execute o comando git init
. Isso transformará seu projeto em um repositório Git.
2. Adicione os arquivos:
Use o comando git add .
para adicionar todos os arquivos do seu projeto ao “stage” do Git.
3. Crie o arquivo .gitignore
(opcional, mas recomendado):
- Crie um arquivo chamado
.gitignore
na raiz do seu projeto. - Adicione os nomes de arquivos e pastas que você não quer versionar (por exemplo, arquivos de configuração sensíveis, pastas de módulos Node.js, etc.).
- No vídeo, é mencionado o uso do
.gitkeep
para forçar o Git a versionar diretórios vazios.
4. Faça o primeiro commit:
Execute o comando git commit -m "Mensagem descritiva do commit"
. A mensagem deve ser clara e concisa, explicando as mudanças que você está fazendo.
Exemplo: git commit -m "Adiciona arquivos de configuração inicial e .gitignore"
5. Crie o repositório remoto no GitHub:
Acesse o GitHub, faça login e clique em “New repository”. Dê um nome ao seu repositório e escolha se ele será público ou privado.
Importante: Não inicialize o repositório com um README, LICENSE ou .gitignore. Faremos isso localmente.
6. Conecte o repositório local ao remoto:
Copie a URL do seu repositório remoto (disponível na página do repositório no GitHub). No terminal, execute o comando git remote add origin <URL do seu repositório>
.
7. Envie as alterações para o GitHub:
Execute o comando git push -u origin main
(ou master
, dependendo da configuração do seu Git). Isso enviará seu código para o repositório remoto. A flag -u
configura o “upstream branch”, o que facilita os próximos pushes.
Dicas extras
- Git Switch: explore o
git switch
para navegar entre branches de forma mais segura. Ele evita problemas que podem ocorrer com ogit checkout
quando há alterações não commitadas. Usegit switch -c <nome-da-branch>
para criar e mudar para uma nova branch. - Branch Develop: Crie uma branch
develop
para integrar as mudanças antes de enviar para a branch principal (main
oumaster
). - Convenções de nomes de branch: utilize prefixos como
feature/
,bugfix/
,hotfix/
para organizar suas branches e indicar o tipo de alteração que está sendo feita.
Publicar seu projeto no GitHub é um passo fundamental para qualquer pessoa que irá desenvolver. Além de facilitar a colaboração e o versionamento, é uma ótima forma de construir seu portfólio e mostrar suas habilidades para o mundo. Na Plataforma Orange, tem uma trilha de Desenvolvimento Full Stack, e um dos módulos é sobre Git e GitHub.
E aí, gostou do artigo? Não deixe de assistir ao vídeo completo no nosso canal para ver o passo a passo criando e publicando seu projeto no GitHub: