Instalar GitHub Desktop en equipo Windows. Crear repositorios en local y publicarlos en GitHub. Clonar repositorios de GitHub a local. Modificar repositorios y sincronizar en GitHub.
- Instalar GitHub Desktop en Windows.
- Crear y publicar repositorio local en GitHub con GitHub Desktop.
- Clonar repositorio de GitHub a local.
Instalar GitHub Desktop en Windows
Accederemos a la web oficial:
Realizaremos la descarga del instalador para nuestra versión del sistema operativo, en este caso el fichero GitHubDesktopSetup-x64.exe. Ejecutaremos el instalador descargado:
Tras la instalación de GitHub Desktop, nos mostrará una ventana para iniciar sesión en GitHub. Si no disponemos de cuenta en GitHub la crearemos pulsando en «Create your free account», si la tenemos pulsaremos en «Sign in to GitHub.com»:
Nos abrirá una ventana del navegador para permitir el acceso de GitHub Desktop a nuestra cuenta de GitHub:
Nos mostrará una ventana para dar autorización a GitHub Desktop a acceder a nuestra cuenta de GitHub:
Tras el inicio de sesión en GitHub, pulsaremos en «Finish» en GitHub Desktop:
Crear y publicar repositorio local en GitHub con GitHub Desktop
Si tenemos algún proyecto de desarrollo de software en local del equipo, podremos subirlo a GitHub, e incluso hacerlo público, mediante GitHub Desktop. Para ello, desde GitHub Desktop, pulsaremos en «File» – «New repository…»:
Nota: si el repositorio Git ya existía en local, usaremos la opción de menú «Add local repository…». En este caso, dado que no existe el repositorio Git en local, lo crearemos en la carpeta de nuestro proyecto de desarrollo ya existente.
Si la carpeta de nuestro proyecto de desarrollo ya existe, elegiremos la carpeta anterior en «Local path» y en «Name» introduciremos el nombre exacto de la carpeta de nuestro proyecto. De esta forma, GitHub Desktop usará esta misma carpeta para añadir sus ficheros de información del repositorio. Así pues, introduciremos los datos del nuevo repositorio:
- Name: nombre del repositorio, no puede contener espacios ni caracteres especiales (incluidas las tildes y eñes). En este nombre, como hemos indicado, si ya tenemos una carpeta con el código de nuestro proyecto, introduciremos aquí el mismo nombre de la carpeta, dado que GitHub usará este nombre para crear la carpeta (si no existe).
- Description: una descripción sobre el proyecto de desarrollo de software.
- Local path: indicaremos aquí la carpeta anterior a la de nuestro proyecto, para que GitHub use la anterior y el nombre establecido en Name. Si elegimos la misma carpeta de nuestro proyecto, GitHub Desktop creará una subcarpeta dentro con el nombre indicado en Name. No sería mayor problema, posteriormente podríamos moverla a la anterior, lo veremos más adelante.
- Marcaremos la opción «Inicialize this repository with a README» para que cree el archivo README, que será el que contenga toda la información de nuestro repositorio.
- Si tenemos alguna licencia la indicaremos en «License», en caso contrario, seleccionaremos «The Unlicense».
Una vez introducidos los datos pulsaremos en «Create repository»:
GitHub Desktop creará la carpeta con el nombre indicado en «Name» y, dentro, creará las subcarpetas y ficheros con la información del repositorio:
- Subcarpeta .git.
- Fichero .gitattibutes.
- Fichero LICENSE.
- Fichero README.md.
En GitHub Desktop nos mostrará un aviso referente a que el repositorio sólo está en local, no en GitHub. Para publicarlo en GitHub pulsaremos en «Publish repository»:
Indicaremos el nombre para el repositorio y la descripción. Muy importante, si desmarcamos la opción «Keep this code private«, el repositorio subido a GitHub será accesible por toda la comunidad. En este caso queremos que sea público, por lo que desmarcaremos esta opción y pulsaremos en «Publish repository»:
En el caso anterior, puesto que hemos seleccionado la misma carpeta del proyecto de código ya existente (lo hemos hecho a propósito para mostrar cómo mover los ficheros de Git de un repositorio a otra carpeta), nos habrá creado una subcarpeta dentro de esta con el nombre indicado en «Name». Si queremos mover estos ficheros de Git a la carpeta anterior del proyecto, los cortaremos y pegaremos, desde el Explorador de Windows:
Al mover los ficheros de Git del repositorio, en GiHub Desktop no lo encontrará, por lo que nos mostrará un mensaje dándonos la opción de buscarlo en otra carpeta, pulsando en «Locate…»:
Y eligiendo la carpeta donde hemos movido los ficheros de Git:
El repositorio local se sincronizará con el de GitHub, asociado a nuestra cuenta y quedará publicado:
Si hacemos un cambio en la web, por ejemplo cambiar el fichero README:
GitHub Desktop lo detectará y nos dará la opción de sincronizar el cambio de la web con el repositorio local, pulsaremos en «Pull origin» para sincronizarlo:
De la misma forma, si hacemos algún cambio en los ficheros de nuestro repositorio de código local, nos los mostrará para sincronizarlos con el repositorio de la web. Para sincronizar el cambio, introduciremos una descripción (es obligatoria), indicando lo que se ha cambiado (por ejemplo) y pulsaremos en «Commit to main»:
En cambio de local quedará actualizado en el repositorio público.
Clonar repositorio de GitHub a local
GitHub Desktop también nos permite hacer el procedimiento inverso al anterior: clonar un repositorio de la web de GitHub al equipo local. Para ello, desde GitHub Desktop, pulsaremos en el menú «File» – «Clone repository…»:
Nos mostrará una lista con todos los repositorios de nuestra cuenta de GitHub, elegiremos el que queramos clonar a local y pulsaremos en «Clone» (se clonará a la carpeta indicada):
Una vez clonado, podremos abrirlo, por ejemplo, con Visual Studio Code, pulsando en «Open in Visual Studio Code»:
De esta forma, cualquier equipo de desarrollo dispondrá del código del repositorio en cualquier momento que lo necesite:
Si realizamos cambios en el repositorio local, desde cualquier editor o IDE, GitHub Desktop los detectará y nos dará la opción de sincronizarlos (como ya hemos indicado).
