Objetivo:

Aprender os comandos básicos do Git e praticar o uso do GitHub para versionamento de código, colaboração e controle de alterações, tudo isso integrado ao ambiente de desenvolvimento Java e com o auxílio do GitHub Desktop.

📋 Pré-requisitos

Sendo estes:

• Conta no GitHub
• Git instalado no computador (necessário para o GitHub Desktop funcionar plenamente).
• GitHub Desktop instalado (para uma experiência visual).
• IntelliJ IDEA Community Edition ou Ultimate Edition (instalado e configurado para Java).
• Acesso à internet

🧪 Desafio: Meu Primeiro Repositório Java no GitHub

Contexto:

Você vai criar um repositório no GitHub para um projeto Java simples. Este projeto pode ser um pequeno programa "Hello, World!" ou um arquivo README.md com uma apresentação pessoal e seus interesses em programação Java e tecnologia.

✅ Etapas da Atividade

1. Crie um Repositório no GitHub (via Navegador)

Vamos começar criando o repositório diretamente no site do GitHub, o que facilitará a integração inicial.

• Acesse github.com e faça login na sua conta.
• Clique no botão "New" (verde) para criar um novo repositório.
• Repository name: meu-primeiro-projeto-java-git
• Description: "Meu primeiro projeto Java versionado com Git e GitHub"
• Marque a opção "Add a README file".
• Clique em "Create repository".

2. Clone o Repositório Localmente (usando GitHub Desktop)

Agora, vamos trazer esse repositório para o seu computador usando o GitHub Desktop.

• Abra o GitHub Desktop.
• No menu superior, clique em File > Clone Repository...
• Na aba "GitHub.com", localize e selecione o repositório meu-primeiro-projeto-java-git.
• Escolha um "Local Path" (caminho no seu computador) onde o projeto será salvo (ex: C:\ProjetosJava\meu-primeiro-projeto-java-git).
• Clique em "Clone".
  • O GitHub Desktop fará o download do repositório para a pasta especificada.

3. Crie um Novo Projeto Java no IntelliJ IDEA

Vamos criar um projeto Java dentro da pasta clonada.

• Abra o IntelliJ IDEA.

• No menu principal, selecione "File > Open...".

• Navegue até a pasta que você acabou de clonar (meu-primeiro-projeto-java-git) e selecione-a.

• O IntelliJ irá perguntar se você deseja abrir o projeto ou criar um novo a partir dele. Escolha "Open".

• Agora que a pasta está aberta, crie um novo projeto Java dentro dela:

  • Clique com o botão direito na raiz do seu projeto no painel "Project" (geralmente o nome da pasta meu-primeiro-projeto-java-git).
  • Selecione "New > Module...".
  • Selecione "New Project" ou "Java" (dependendo da sua versão do IntelliJ) e clique em "Next".
  • "Name" para o módulo: HelloJava (ou outro nome de sua preferência).
  • "Location": Certifique-se de que o caminho seja dentro da pasta do seu repositório (ex: .../meu-primeiro-projeto-java-git/HelloJava).
  • Clique em "Finish".

• Dentro do módulo HelloJava, crie uma nova classe Java (clique com o botão direito em src ou src/main/java > New > Java Class):

  • Name: Main

  • Adicione um método main simples:

    public class Main {
        public static void main(String[] args) {
            System.out.println("Hello, Git e Java!");
        }
    }
    

• Importante: Salve todos os arquivos (Ctrl+S ou File > Save All).

4. Use o GitHub Desktop para Comitar e Enviar (Push)

Agora que você tem um projeto Java, vamos versionar as alterações com o GitHub Desktop.

• Volte para o GitHub Desktop.
• Na aba "Changes", você verá muitos arquivos novos que o IntelliJ IDEA gerou (pasta .idea/, arquivos .iml, pasta out/ ou target/, etc.).
• Adicione um .gitignore (crucial para Java/IntelliJ):

  • Para evitar que o Git rastreie arquivos desnecessários da IDE e de build, vamos adicionar um .gitignore.

  • No GitHub Desktop, no painel "Changes", logo abaixo da lista de arquivos modificados, você verá um link "Create a .gitignore file". Clique nele ou crie manualmente na raiz do seu repositório um arquivo chamado .gitignore e cole o seguinte conteúdo: Snippet de código

    # IntelliJ IDEA
    .idea/
    *.iml
    *.ipr
    *.iws
    out/
    target/
    .DS_Store # macOS specific
    *.log
    *.class
    

  • Salve o .gitignore.

  • O GitHub Desktop deve atualizar a lista de "Changes", mostrando agora apenas os arquivos importantes do seu projeto Java (como Main.java e o .gitignore que você acabou de criar).

• Selecione os arquivos para o commit: Marque as caixas de seleção ao lado de HelloJava/src/Main.java (ou HelloJava/src/main/java/Main.java) e .gitignore (se ainda não estiver).
• Escreva a mensagem do commit:
  • Summary: feat: Adiciona projeto Java inicial e .gitignore
  • Description (opcional): "Cria o projeto HelloJava com a classe Main e configura o .gitignore para ignorar arquivos da IDE."
• Clique em "Commit to main".
• Clique no botão "Push origin" na parte superior para enviar seus commits locais para o GitHub.com.