Administrar proyectos con GIT

La integración de GIT en Studio requiere Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017, 2019 y 2022. Consulta la página Requisitos de software.

Autenticar a GIT

Los métodos de autenticación en Studio difieren según los métodos utilizados para clonar un repositorio GIT, bien HTTPS o SSH. Consulta esta página para ver qué debes usar si trabajas con GitHub.

Nota:

• Las credenciales de GIT que proporcionas en Studio se almacenan en el Administrador de credenciales de Windows.
• La integración de GIT con Studio admite actualmente la autenticación de dos factores solo para GitHub si te autenticas iniciando sesión en el servicio. Para otras herramientas, utiliza el método de autenticación SSO con un token personal o el método de autenticación de acceso básica.

La guía actual detalla los pasos para autenticar en un repositorio de GitHub, pero la integración de Git en Studio no se limita a solo este servicio.

Sobre HTTPS

Al clonar un repositorio de GIT remoto o copiar el proyecto actual a un repositorio de GIT existente usando HTTPS por primera vez, debes proporcionar tus credenciales de GIT. Dichas credenciales deben escribirse en los campos Usar credenciales:

Puedes autenticarte utilizando las siguientes opciones:

• Iniciar sesión con GitHub: inicia sesión con tu cuenta de GitHub.
• Usuario/Contraseña: especifica tu usuario y tu contraseña.

• Token: especifica tu usuario y token de acceso personal.

  Sigue los pasos detallados en esta página para generar un token GIT para tu repositorio GitHub.

  Importante: La opción Iniciar sesión con GitHub solo está disponible para repositorios alojados en github.com y requiere que la aplicación UiPath GitHub esté instalada en tu organización o cuenta.

Sobre SSH

Al clonar un repositorio o copiar el proyecto actual a un repositorio de GIT existente usando SSH por primera vez, tienes la opción de usar una clave privada:

Agrega la Ruta de clave privada y la Contraseña y luego haz clic en Abrir para clonar tu repositorio GIT remoto. Consulta los pasos detallados aquí para generar una clave SSH para tu repositorio GitHub.

Error de autenticación

Sobre HTTPS

Al clonar un repositorio GIT, se muestra la ventana Especificar credenciales con el mensaje Error de autenticación si las credenciales proporcionadas fueran incorrectas:

Especifica las credenciales correctas e inténtalo de nuevo. También puedes usar Git Bash, por ejemplo, para clonar tu repositorio de forma remota y, por tanto, comprobar si el nombre de usuario y la contraseña son correctos.

En la siguiente imagen hemos intentado clonar un repositorio sobre HTTPS, pero escribimos una contraseña incorrecta. La ventana Git Bash muestra que las credenciales eran incorrectas.

Sobre SSH

Se muestra la siguiente ventana Introducir credenciales cuando la autenticación sobre SSH falla:

Escribe la Ruta de clave privada y Contraseña correctas y vuelve a intentarlo. También puedes usar Git Bash, por ejemplo, para clonar tu repositorio de forma remota y, por tanto, comprobar si el token y la contraseña son correctos.

En la siguiente imagen, hemos intentado clonar un repositorio sobre SSH, pero no teníamos ninguna clave SSH pública configurada en nuestra cuenta.

Clonar un repositorio GIT remoto

1. En la pestaña Equipo, selecciona Clonar repositorio. El Clonado de un repositorio GIT remoto. se mostrará la ventana.
2. Selecciona Usar HTTPS o Usar SSH.
3. Escribe la URL del repositorio, y selecciona un Directorio de comprobación vacío.
4. Selecciona Usar credenciales/Usar clave y configura la autenticación (inicia sesión con GitHub, introduce el usuario y la contraseña, introduce el usuario y el token para HTTPS, o introduce la ruta de clave privada y la contraseña para SSH).
5. Haz clic en Abrir, Studio abre el proyecto en el panel Diseñador.
6. En la ventana Abrir, selecciona un archivo project.json para abrirlo en Studio.

Después de clonar un repositorio GIT en un directorio de trabajo local, se crea el subdirectorio .git que contiene los metadatos GIT necesarios. Los metadatos incluyen subdirectorios para objetos, referencias y archivos de plantilla. Además, se crea un archivo HEAD, que señala a la confirmación actualmente comprobada.

Añadir un proyecto a GIT

El comando GIT Init añade el proyecto actual a un repositorio GIT local. Accede al comando desde la pestaña Equipo o la barra de estado.

1. Crea o abre un proyecto en Studio. Haz clic en la pestaña Inicio > Equipo. Se mostrará la pestaña Equipo.

2. Haz clic en el botón GIT Init y luego selecciona una ruta en la que debe inicializarse el repositorio. La ubicación puede ser la misma que la del proyecto o la carpeta principal. Se abrirá la ventana Confirmar cambios.

   
   

   

   
   
3. La sección Archivos modificados muestra los archivos del proyecto que se añadirán al repositorio Git. Desmarca la casilla junto a los que no quieres añadir o usa Seleccionar todos, Seleccionar ninguno.

4. Selecciona la casilla de verificación Mostrar archivos no versionados para añadir archivos no versionados a la lista.

   Escribe un Mensaje de confirmación. Haz clic en el botón Confirmar para confirmar los cambios en el repositorio de Git local.

Cuando se ha añadido un proyecto a GIT, el menú contextual del panel Proyecto incluye opciones específicas de GIT. Para obtener más información, consulta Opciones del menú contextual para GIT.

Nota: la carpeta .local, que contiene datos almacenados en caché localmente para el proyecto, no debe añadirse a GIT.

Confirmar y publicar a GIT

1. Desde la misma ventana Confirmar cambios, haz clic en Confirmar y enviar para guardar los cambios y enviarlos al repositorio remoto. Se mostrará la ventana Administrar Remotos. La ventana también está disponible desde la barra de estado.

   
   

   

   
   
2. En la sección Nombre, añade el nombre del repositorio remoto.
3. En la sección URL añade la URL remota.

Si quieres realizar modificaciones en los repositorios añadidos, haz clic en una entrada, cambia el nombre y la URL, y luego haz clic en el botón Actualizar. Cuando hayas terminado, haz clic en Añadir y luego en Guardar. Se abrirá el siguiente cuadro de mensaje. Esto significa que el repositorio local no está sincronizado con el remoto.

• Haz clic en el botón Sobrescribir contenido remoto para enviar las versiones locales de los archivos al repositorio remoto y sobrescribir los archivos que hay allí.
• Haz clic en el botón Incorporar (cambio de base) para enviar los archivos remotos y cambiar la base de la rama actual.
• Haz clic en el botón Cancelar para descartar toda la operación.

El número de cambios no enviados y los archivos recién añadidos son visibles en la barra de estado. Haz clic en el icono para abrir la ventana Confirmar cambios, o en el icono para impulsar cambios.

Nota: Si modificas un archivo desde un proyecto añadido a control de fuente en un editor externo, el cambio es visible en el panel Proyecto y la barra de estado solo tras hacer clic en Actualizar en el panel Proyecto.

Cambiar la última confirmación

La integración de Studio con Git también incluye una opción de Corregir confirmación para cambiar la última confirmación realizada, antes de que se realizase el envío.

1. Haz clic con el botón derecho en un archivo modificado en el panel Proyecto y selecciona Confirmar. Se mostrará la ventana Confirmar cambios.

   
   

   

   
   
2. Selecciona el cuadro Reparar confirmación. Se mostrará el último mensaje de confirmación, junto con los archivos que se hayan confirmado. Para ver los cambios entre el archivo actual y el último confirmado, usa la opción Mostrar cambios.
3. Cambia el mensaje de confirmación y selecciona los archivos que quieres incluir. Haz clic en el botón Confirmar y enviar o en el botón Confirmar.

Deshacer cambios pendientes

Studio incluye la opción de deshacer cambios que se hayan hecho en archivos versionados, antes de confirmar y enviarlos al repositorio remoto.

Después de realizar cambios en un archivo en el repositorio local, haz clic en Deshacer en el menú contextual de GIT para abrir la ventana Deshacer cambios pendientes.

Selecciona la casilla de verificación al lado de los archivos y haz clic en Deshacer. Ahora los archivos se devuelven al estado que tenían antes de realizar los cambios.

Nota: La opción Deshacer no cubre archivos no versionados. Si creas nuevos archivos y luego seleccionas Deshacer, los archivos no se eliminan del proyecto. Una vez añadidos al árbol del proyecto, los nuevos archivos permanecen allí a menos que se borren de forma manual.

Copiar un proyecto a GIT

El botón Copiar a GIT en la vista Backstage de Studio y en la barra de estado te permite copiar el proyecto actual a un repositorio de GIT existente.

Para hacerlo, primero abre o crea un proyecto en Studio. En la pestaña Equipo, selecciona Copiar a GIT y elige una carpeta de repositorio de GIT existente en tu máquina. El proyecto se añade al repositorio de GIT local y se abre el cuadro de mensaje Copiar a GIT.

• Selecciona Sí para abrir el proyecto desde la nueva ubicación. Se abrirá la ventana Confirmar cambios. Escribe un Mensaje de confirmación y haz clic en Confirmar y enviar o simplemente en Confirmar.
• Selecciona No para volver a la interfaz de usuario de Studio.

Crear y gestionar ramas

Añade y gestiona las ramas desde la ventana Administrar ramas. Para acceder, haz clic con el botón derecho en el nodo del proyecto o en un archivo del panel de Proyecto y selecciona Administrar ramas o utiliza el menú de ramas en la barra de estado.

• Para añadir una rama:

  1. Selecciona una rama en la tabla y luego haz clic en Más en la parte superior de la ventana.

  2. Introduce un nombre para la rama, haz clic en Crear rama desde branch_name y luego haz clic en Guardar.

     La rama se añadirá a la lista.

• Para actualizar la lista de ramas, haz clic en Actualizar en la parte superior de la ventana.
• Para eliminar una rama local, selecciónala y, después, haz clic en Eliminar en la parte superior de la ventana.

• Para administrar ramas, haz clic derecho en cualquier rama y selecciona una de las opciones en el menú:

  • La opción Comprobar rama cambia a la rama seleccionada.
  • La opción Reorganizar base reorganiza la base de la rama actual sobre la rama seleccionada.

  • La opción Fusionar une la rama seleccionada con la rama actual.

    Para fusionar una rama en el maestro de un repositorio remoto de GIT, debes tener la rama maestro marcada en Studio y luego combinar la rama modificada en el maestro.

• Para cambiar de rama, abre el menú de la barra de estado y luego selecciona la rama a la que deseas cambiar en la lista que aparece.

Nota: Las ramas deben agregarse localmente en Studio desde la ventana Administrar ramas . Agregar ramas desde el repositorio GIT remoto puede causar problemas al intentar cambiar entre ramas.

Ver el Historial de confirmaciones

Para ver el historial de confirmación para un proyecto o para un archivo o carpeta específico en un proyecto, haz clic con el botón secundario en el nodo del proyecto, un archivo o carpeta en el panel Proyecto, y luego selecciona Mostrar historial. Así, se abrirá la ventana Historial, que muestra una lista de revisiones existentes para el archivo, carpeta o proyecto seleccionado. Para cada confirmación, se mostrará el hash, mensaje, autor y fecha de la confirmación en una tabla en la parte superior de la ventana. Puedes ver más información sobre una confirmación seleccionada en las pestañas Detalles y Cambios en la parte inferior de la ventana.

Comparar dos versiones de un archivo

Para comparar dos versiones del mismo archivo:

• Si has abierto el historial para un archivo, haz clic con el botón secundario en la ventana Historial y luego selecciona Comparar con previo, Comparar con local o Comparar con último.
• Si has abierto el historial para una carpeta o proyecto, selecciona una confirmación en la ventana Historial y luego, en la pestaña Cambios, haz doble clic en un archivo para comparar su versión anterior.

Crear una rama de una confirmación anterior

Para crear una rama desde una confirmación específica:

1. Haz clic con el botón secundario en una confirmación de la ventana Historial y luego selecciona Crear rama.

2. En la ventana Crear rama:

   • Especifica un nombre para la nueva rama.
   • Para extraer del repositorio también la nueva rama, asegúrate de que la opción Extraer del repositorio después de crear esté seleccionada.
3. Haz clic en Aceptar.

Resolución de conflictos

La integración de GIT con Studio incluye una característica para resolver los conflictos que pueden surgir al realizar el comando Reorganizar base o Enviar, que se encuentran en la ventana Confirmar cambios.

Cada vez que Studio detecta un conflicto entre el archivo local y el que se encuentra en el repositorio remoto, se muestra la ventana Resolución de conflictos.

La ventana es similar a Diferenciar flujo de trabajo, mostrando las diferencias entre la versión Remota del archivo y la versión Local.

La siguiente tabla describe las opciones disponibles en la ventana Resolver conflictos.

Opción	Descripción
Elegir izquierda	Selecciona el archivo izquierdo que representa el archivo en el repositorio remoto para enviarlo.
Elegir derecha	Selecciona el archivo derecho que representa el archivo en el repositorio local para enviarlo.
Guardar	Haz clic en Guardar después de elegir el archivo izquierdo o derecho.
Cancelar	Cancela la operación y sal de la ventana Resolver conflictos.
Anterior	Navega hasta el cambio anterior en los archivos comparados.
Sig.	Navega hasta el siguiente cambio en los archivos comparados.
Contraer todo	Contrae todos los nodos de los archivos .xaml.
Expandir todo	Expande todos los nodos de los archivos .xaml.

Desconectar de GIT

La opción Desconectar de la vista Backstage de Studio > Equipo está disponible para los archivos versionados en los dos casos siguientes:

1. Se inicia un proceso como un repositorio de GIT local. Crea un nuevo proceso, usa GIT Init para añadirlo a un repositorio de GIT local y luego usa Desconectar para eliminar la etiqueta de subversión.
2. La etiqueta de subversión se puede eliminar haciendo clic en Desconectar para un repositorio de GIT que incluye proyectos principales y secundarios.
3. Si desconectas un proyecto secundario, todo el repositorio de GIT que contiene el proyecto abierto se desconecta del control de origen. Se muestra un cuadro de mensaje en Studio que requiere tu confirmación antes de realizar la acción de desconexión.

Cambiar la firma

El cambio de la firma de confirmación de GIT se puede hacer desde la pestaña Equipo > Cambiar firma. Escribe tu nombre y la dirección de correo electrónico, y haz clic en Aceptar.

Cambiar las credenciales

Para actualizar las credenciales utilizadas para conectarse a un repositorio remoto:

1. En el menú de rama en la barra de estado, selecciona Administrar remotos.
2. En el diálogo Administrar remotos, haz clic con el botón secundario en un repositorio remoto y selecciona Cambiar credenciales.

3. Dependiendo de cómo se clonó el repositorio (mediante HTTPS o SSH), inicia sesión en una cuenta de GitHub (solo para repositorios alojados en github.com) y escribe tu nombre de usuario/contraseña o nombre de usuario/token, o apunta a una nueva clave privada y haz clic en Aceptar.

   Las credenciales se actualizan en el Administrador de credenciales de Windows.

Usar GIT con un servidor proxy

La integración GIT en Studio admite acceso a repositorios remotos si el acceso a Internet es a través de un servidor proxy. Esto se puede hacer de dos formas: o bien configurado en el nivel de máquina en la ventana Configuración de proxy o haciendo cambios en los comandos git.

Los detalles del proxy configurado en la ventana Configuración de proxy se tienen en cuenta, sin necesidad de introducirlos en el archivo .gitconfig.

Para configurar los detalles de proxy con los comandos git, añádelos a los archivos de configuración GIT de la manera siguiente:

[http "https://domain.com"] proxy = http://proxyUsername:[e-mail]:port

Se pueden encontrar archivos de configuración GIT en las siguientes ubicaciones:

• Archivo config: %ProgramData%\Git
• Archivo .gitconfig: %UserProfile%
• archivo local config del nivel de proyecto, por ejemplo %UserProfile%\Desktop estproject\.git.