Guía de Git & GitHub para Desarrolladores

Antes de empezar, entendamos qué son estas herramientas y para qué sirven.

🐙 ¿Qué es Git?

Git es un programa que guarda el historial de todos los cambios que haces en tus archivos. Imagina que tienes una carpeta con tu proyecto — ya sea un videojuego, una app web o cualquier software. Git guarda una "fotografía" de tus archivos cada vez que tú se lo dices, para que nunca pierdas tu trabajo y puedas regresar a versiones anteriores cuando algo falla.

☁️ ¿Qué es GitHub?

GitHub es un sitio web donde puedes guardar tus proyectos en internet (en la nube). Funciona como una "red social para programadores" donde puedes compartir tu código y colaborar con personas de todo el mundo.

📖 Palabras clave que usaremos

GitHub es completamente gratis para uso personal. Vamos a crear tu cuenta paso a paso.

📋 Pasos para registrarte

1. Abre tu navegador y ve a https://github.com
2. Haz clic en el botón verde "Sign up"
3. Ingresa tu correo electrónico
4. Crea una contraseña segura
5. Elige un nombre de usuario profesional (ej: juan-ubes-dev)
6. Resuelve el puzzle de verificación y confirma tu correo

$ xcode-select --install

# Ubuntu / Debian:
$ sudo apt update && sudo apt install git -y
# Fedora:
$ sudo dnf install git -y

✅ Verifica la instalación

$ git --version
# Deberías ver: git version 2.x.x

⚙️ Configura tu identidad (solo una vez)

$ git config --global user.name "Tu Nombre Aquí"
$ git config --global user.email "[email protected]"
$ git config --global init.defaultBranch main
# Verifica que quedó bien:
$ git config --list

Desde agosto 2021, GitHub ya no acepta tu contraseña normal. Necesitas un Token de Acceso Personal (PAT).

🎫 Crear tu Token

1. Ve a github.com/settings/tokens
2. Clic en "Generate new token (classic)"
3. Escribe un nombre: "Mi laptop UBES"
4. Expiration: 90 days o No expiration
5. Marca ✅ repo en los scopes
6. Clic en "Generate token"
7. ⚠️ Copia el token ahora. Empieza con ghp_...

💾 Guardar el token automáticamente

$ git config --global credential.helper manager
# La primera vez que hagas push, te pedirá tu usuario y token

$ git config --global credential.helper osxkeychain

$ git config --global credential.helper store

1️⃣ Ver qué cambió

$ git status
# Rojo = cambios no preparados | Verde = listos para commit

2️⃣ Preparar los archivos

$ git add .          # Agrega TODO
$ git add archivo.cs  # Agrega un archivo específico

3️⃣ Guardar la "fotografía"

$ git commit -m "Agrego sistema de salto al personaje"
# ✅ Bueno:  "Corrijo error en movimiento del jugador"
# ❌ Malo:   "cambios" o "asdf123"

4️⃣ Subir a GitHub

$ git push origin main

5️⃣ Descargar cambios del equipo

$ git pull origin main
# Siempre haz pull ANTES de empezar a trabajar

Dependiendo de tu tipo de proyecto, hay consideraciones específicas al subirlo a GitHub. A continuación el proceso para proyectos Unity — pero los pasos de git init, git add, git commit y git push son idénticos para cualquier proyecto: apps web, software, ciberseguridad, lo que sea.

📋 Paso 1: Configura Unity para Git

Antes de hacer nada, abre tu proyecto en Unity y cambia estas configuraciones:

1. Ve al menú Edit → Project Settings → Editor
2. En Version Control → Mode: selecciona "Visible Meta Files"
3. En Asset Serialization → Mode: selecciona "Force Text"
4. Guarda con Ctrl+S (o ⌘+S en Mac)

📋 Paso 2: Crea el repositorio en GitHub

1. Ve a github.com y crea un repositorio nuevo
2. Ponle el nombre de tu juego (ej: mi-juego-unity)
3. NO marques "Add README" — lo haremos desde la terminal
4. Haz clic en "Create repository"
5. Copia la URL que aparece (ej: https://github.com/usuario/mi-juego-unity.git)

📋 Paso 3: Crea el archivo .gitignore para Unity

Este es el paso más importante. El .gitignore le dice a Git qué carpetas NO debe subir (las que Unity genera automáticamente y pesan muchísimo).

Abre tu terminal, entra a la carpeta de tu proyecto y crea el archivo:

# Entra a la carpeta de tu proyecto Unity
$ cd "C:/ruta/a/tu/proyecto"   # Windows
$ cd ~/Documentos/mi-juego    # Mac/Linux

Luego crea el archivo .gitignore. Puedes crearlo directamente desde tu explorador de archivos (crea un archivo de texto llamado exactamente .gitignore sin extensión) con este contenido:

📋 Paso 4: Inicializa Git y sube tu proyecto

Con la terminal abierta dentro de la carpeta de tu proyecto:

# 1. Inicializa Git en tu carpeta
$ git init

# 2. Conecta con tu repositorio de GitHub
$ git remote add origin https://github.com/TU-USUARIO/mi-juego-unity.git

# 3. Agrega todos los archivos (el .gitignore excluirá los innecesarios)
$ git add .

# 4. Haz tu primer commit
$ git commit -m "Subida inicial del proyecto Unity"

# 5. Sube todo a GitHub
$ git push -u origin main
# El flag -u solo se usa la primera vez

Ya tienes tu proyecto en GitHub. Ahora aprende el hábito de guardar tus avances regularmente. Piénsalo como un punto de guardado en tu videojuego, pero para el código.

📅 Rutina recomendada al trabajar en tu juego

══ Al EMPEZAR a trabajar ══
$ git pull origin main
# Descarga los últimos cambios (si trabajas en equipo)

══ Mientras trabajas ══
# Trabaja en Unity normalmente...
# Guarda tus escenas: Ctrl+S en Unity

══ Al TERMINAR o al lograr algo importante ══
$ git status             # Ver qué cambié
$ git add .              # Preparar todo
$ git commit -m "Agrego animación de correr al personaje"
$ git push origin main  # Subir a GitHub

✍️ Buenos mensajes de commit para juegos Unity

⏮️ ¿Cometiste un error? Regresa a una versión anterior

Una de las ventajas más poderosas de Git: puedes deshacer cambios y volver a cualquier punto guardado.

# Ver el historial de commits
$ git log --oneline
# Verás algo así:
# a3f2c1b Agrego nivel 3
# 9b1e4d2 Corrijo bug del salto
# 5c7a8f1 Subida inicial del proyecto Unity

# Ver cómo estaba el proyecto en un commit anterior (sin borrar nada)
$ git checkout 9b1e4d2

# Volver al estado actual
$ git checkout main

🌿 Usar ramas para probar cosas nuevas (avanzado)

¿Quieres probar un nuevo sistema de armas pero no quieres arruinar el juego principal? ¡Usa una rama!

# Crea una rama nueva para experimentar
$ git checkout -b sistema-de-armas

# ... (trabajas en Unity, haces commits...) ...

# Si te gustó, únela al juego principal
$ git checkout main
$ git merge sistema-de-armas

# Si no funcionó, simplemente abandona la rama sin daños
$ git branch -d sistema-de-armas

🔵 Comandos del día a día

🌿 Ramas (branches)

↩️ Deshacer cosas

🗑️ Eliminar un repositorio en GitHub (sitio web)

1. Ve a github.com y abre el repositorio que quieres eliminar
2. Haz clic en la pestaña "Settings" (arriba a la derecha del repo, necesitas ser el dueño)
3. Baja hasta el final de la página, a la sección roja "Danger Zone"
4. Haz clic en "Delete this repository"
5. GitHub te pedirá que escribas el nombre exacto del repositorio para confirmar
6. Escribe el nombre y haz clic en "I understand the consequences, delete this repository"

🗂️ Eliminar solo el seguimiento de Git (sin borrar tus archivos)

Si quieres que una carpeta deje de ser un repositorio de Git pero sin borrar tus archivos:

# Entra a la carpeta del proyecto
$ cd tu-proyecto

# En Windows (Git Bash):
$ rm -rf .git

# En Mac/Linux:
$ rm -rf .git

🧹 Eliminar un repositorio clonado de tu computadora

Si solo quieres borrar una copia local (sin afectar GitHub):

# Simplemente borra la carpeta como cualquier otra
# Windows: selecciona la carpeta en el Explorador y presiona Delete
# Mac/Linux desde terminal:
$ rm -rf nombre-del-repositorio/

🎯 Cosas útiles que puedes hacer en GitHub

⌨️ Atajos de teclado en GitHub

El README.md es lo primero que alguien ve cuando entra a tu repositorio. Es como la portada de tu juego. Hacerlo bien impresiona mucho.

📝 Estructura básica de un buen README

# Así se escribe Markdown en el README:

# 🎮 Nombre de Mi Juego

Una frase que describe de qué trata el juego.

## 📸 Capturas de pantalla
![Nombre de imagen](ruta/imagen.png)

## 🎯 ¿Cómo jugar?
- Usa las flechas para moverte
- Presiona espacio para saltar
- Recoge monedas para ganar puntos

## 🛠️ Hecho con
- Unity 2023
- C#

## 👤 Autor
Tu Nombre — Estudiante de UBES Academy

🎨 Elementos Markdown básicos

✅ Lista de verificación del desarrollador

🚀 Comandos más importantes para recordar

══ Para iniciar un proyecto nuevo ══
$ git init
$ git remote add origin URL-DEL-REPO
$ git push -u origin main

══ Flujo de trabajo diario ══
$ git pull origin main
$ git add .
$ git commit -m "Descripción clara"
$ git push origin main