Skip to main content

Comenzar con GitHub Desktop

Aprende cómo ajustar, autenticar y configurar GitHub Desktop para permitirte contribuir en proyectos directamente desde tu máquina.

Introducción

GitHub Desktop es una aplicación que te habilita para interactuar con GitHub utilizando una GUI en vez de la línea de comandos o de un buscador web. GitHub Desktop fomenta que tú y tu equipo colaboren utilizando las mejoras prácticas con Git y GitHub. Puedes utilizar GitHub Desktop para completar la mayoría de los comandos de Git desde tu computadora de escritorio con confirmaciones visuales para los cambios. Puedes subir, extraer y clonar repositorios remotos con GitHub Desktop y utilizar herramientas colaborativas tales como atribuir confirmaciones y crear solicitudes de extracción.

Esta guía te ayudará a iniciar con GitHub Desktop mediante la configuración de la aplicación, la autenticación en tu cuenta, la configuración de ajustes básicos y la introducción de las bases fundamentales para administrar los proyectos con GitHub Desktop. Podrás utilizar GitHub Desktop para colaborar en proyectos y conectarte a repositorios remotos después de seguir esta guía.

Puede que te sea útil el entender los conceptos básicos de Git y de GitHub antes de comenzar a utilizar GitHub Desktop. Para obtener más información, consulte los siguientes artículos.

GitHub Desktop es un proyecto de código abierto. Puedes ver el itinerario, contribuir con el proyecto, o abrir un informe de problemas para proporcionar retroalimentación o solicitudes de características. Para más información, consulte el repositorio desktop/desktop.

Parte 1: Instalación y autenticación

Puedes instalar GitHub Desktop en cualquier sistema operativo compatible. Para obtener más información, vea "Sistemas operativos admitidos".

Para instalar GitHub Desktop, visite la página de descarga de GitHub Desktop. Para más información, vea "Instalación de GitHub Desktop".

Después de que hayas instalado GitHub Desktop, puedes autenticar la aplicación con tu cuenta en GitHub o en GitHub Enterprise. Esta autenticación te permite conectarte remotamente a los repositorios en GitHub o en GitHub Enterprise.

  1. Antes de que te autentiques en GitHub o en GitHub Enterprise, necesitarás una cuenta. Para obtener más información sobre cómo crear una cuenta, consulte "Registro para obtener una nueva cuenta de GitHub" o póngase en contacto con su administrador del sitio de GitHub Enterprise.

  2. En el menú desplegable de GitHub Desktop, haga clic en Preferences (Preferencias). En la ventana de preferencias, haga clic en Accounts (Cuentas) y siga los pasos para iniciar sesión. Para obtener más información sobre cómo autenticarse, vea "Autenticación en GitHub". El botón de inicio de sesión en GitHub

  1. Antes de que te autentiques en GitHub o en GitHub Enterprise, necesitarás una cuenta. Para obtener más información sobre cómo crear una cuenta, consulte "Registro para obtener una nueva cuenta de GitHub" o póngase en contacto con su administrador del sitio de GitHub Enterprise.

  2. En el menú desplegable File (Archivo), haga clic en Options (Opciones). En la ventana de opciones, haga clic en Accounts (Cuentas) y siga los pasos para iniciar sesión. Para obtener más información sobre cómo autenticarse, vea "Autenticación en GitHub". El botón de inicio de sesión en GitHub

Parte 2: Configurar y personalizar GitHub Desktop

Después de que instales GitHub Desktop, puedes configurar y personalizar la app para que se adapte mejor a tus necesidades.

Puedes conectar o eliminar cuentas en GitHub o en GitHub Enterprise, elegir un editor de texto o shell predeterminado, editar tu configuración de Git, cambiar la apariencia de GitHub Desktop, personalizar las cajas de diálogo del sistema y configurar las preferencias de privacidad en la ventana de Preferencias de GitHub Desktop. Para más información, consulte "Configuración básica".

Los ajustes básicos en la ventana de Preferencias

Puedes conectar o eliminar cuentas en GitHub o en GitHub Enterprise, elegir un editor de texto o shell predeterminado, editar tu configuración de Git, cambiar la apariencia de GitHub Desktop, personalizar las cajas de diálogo del sistema y configurar las preferencias de privacidad en la ventana de Opciones de GitHub Desktop. Para más información, consulte "Configuración básica".

Los ajustes básicos en la ventana de Opciones

Parte 3: Colaborar en proyectos con GitHub Desktop

Después deinstalar, autenticarte y configurar la app, estás listo para comenzar a utilizar GitHub Desktop. Puedes crear, agregar, o clonar los repositorios y utilizar GitHub Desktop para administrar las contribuciones a tus repositorios.

Crear, agregar y clonar repositorios

Para crear un repositorio, seleccione el menú File (Archivo) y haga clic en New repository… (Nuevo repositorio…). Para obtener más información, vea "Creación del primer repositorio mediante GitHub Desktop".

Para agregar un repositorio desde el equipo local, seleccione el menú File (Archivo) y haga clic en Add Local Repository… (Agregar repositorio local…). Para obtener más información, vea "Adición de un repositorio desde el equipo local a GitHub Desktop".

Para clonar un repositorio de GitHub, seleccione el menú File (Archivo) y haga clic en Clone Repository… (Clonar repositorio…). Para obtener más información, vea "Clonación y bifurcación de repositorios de GitHub Desktop".

Las opciones del menú de Archivo para crear, agregar, y clonar repositorios

Las opciones del menú de Archivo para crear, agregar, y clonar repositorios

Realizar cambios en una rama

Puedes utilizar GitHub Desktop para crearuna rama de un proyecto. Las ramas aislan tu trabajo de desarrollo de otras ramas en el repositorio para que puedas experimentar con varios cambios de manera segura. Para más información, vea "Administración de ramas".

El botón de Rama Nueva

Después de que hagas cambios a una rama, puedes revisarlos en GitHub Desktop y hacer una confirmación para controlar dichos cambios. Para más información, vea "Confirmación y revisión de los cambios en el proyecto".

Viualizar y hacer confirmaciones

Si quieres acceder a tus cambios de manera remota o si quieres compartirlos con otras personas, puedes cargar tus confirmaciones en GitHub. Para más información, vea "Inserción de cambios en GitHub".

Colaborar con GitHub Desktop

Puedes utilizar GitHub Desktop para crear informes de problemas o solicitudes de extracción para colaborar en proyectos con otras personas. Los informes de problemas te ayudan a llevar un seguimiento de las ideas y debatir los posibles cambios a los proyectos. Las solicitudes de extracción te permiten compartir tus cambios propuestos con los demás, recibir retroalimentación y fusionar los cambios en un proyecto. Para más información, vea "Creación de una incidencia o una solicitud de incorporación de cambios".

Puedes ver tus propias solicitudes de extracción o las de tus colaboradores en GitHub Desktop. El visualizar una solicitud de extracción en GitHub Desktop te permite ver cualquier cambio propuesto y hacer cambios adicionales si abres los repositorios y archivos del proyecto en tu editor de texto predeterminado. Para más información, vea "Visualización de una solicitud de incorporación de cambios en GitHub Desktop".

Mantener tu repositorio local sincronizado

Cuando haces cambios a tus repositorios locales o cuando otros hacen cambios a los repositorios remotos, necesitarás sincronizar tu copia local del proyecto con el repositorio remoto. GitHub Desktop puede mantener sincronizada tu copia local de un proyecto con la versión remota al subir y extraer las confirmaciones. Para más información, vea "Sincronización de la rama".

Información adicional