Administrar proyectos con GIT

La integración de GIT en Studio requiere el Redistribuible de Microsoft Visual C++ 2015 actualización 3, versión x86. 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 no admite actualmente la autenticación de dos factores. Como solución temporal, usa el método de autenticación SSO con un token personal o el método de autenticación de acceso básico.

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 usando:

• Nombre de usuario y contraseña en sus campos específicos;
• Nombre de usuario en el campo Usuario y token GIT en el campo Token;

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

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

Si la contraseña o el nombre de usuario se escribieron mal al clonar un repositorio GIT usando el método HTTPS, se muestra la ventana Introducir credenciales con el mensaje Autenticación fallida:

Escribe las credenciales de Usuario 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 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. Elige entre Clonar con HTTPS o Usar SSH.
3. Escribe la URL del repositorio, y selecciona un Directorio de comprobación vacío.
4. Marca la casilla de verificación Usar credenciales o Usar clave para añadir tu nombre de usuario Git o la Ruta de clave privada y la contraseña.
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.

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

1. En el panel Proyecto, haz clic con el botón derecho en el nodo del proyecto o en el archivo contenido, o en el icono de la barra de estado y selecciona Administrar ramas. Se mostrará la ventana Administrar ramas.

   
   

   

   
   
2. Agrega una rama haciendo clic en el botón . Escribe un nombre para la rama en la sección Nombre. Haz clic en Añadir y luego en Guardar. La rama se añadirá a la lista.

Haz clic con el botón derecho sobre cualquier rama para mostrar las opciones de las ramas de Git:

• 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 entre ramas, haz clic en el icono en la barra de estado para abrir la lista con todas las ramas recientemente comprobadas. Haz clic en un elemento para cambiar la rama.

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 archivo, 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.

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.