Tutorial: trabajar con control de origen

Control de versión, también conocido como control de origen, es la práctica de vigilar y gestionar los cambios en el código de software o los archivos de un proyecto. Los sistemas de control de versión son herramientas de software que ayudan a los equipos a gestionar los cambios realizados en un proyecto a lo largo del tiempo.

El software de control de versión ayuda a llevar la cuenta de los cambios y se asegura de que los miembros del equipo trabajan en la versión más reciente. Debería ayudarte a desarrollar y entregar más rápido al mejorar la visibilidad y ayudar a los equipos a colaborar. Los cambios quedan registrados en una especie de base de datos, llamada repositorio. Si se comete un error, se pueden comparar versiones anteriores del proyecto de StudioX para ayudar a solucionar el error, minimizando las molestias a todos los miembros del equipo.

Nota: este tutorial solo se aplica a las versiones de StudioX 2020.10 y 2021.4. Para versiones más recientes de StudioX consulta Gestión de proyectos con GIT en la guía de StudioX.

Aunque existen varias versiones de software de control de versión disponibles, esta guía utiliza Bitbucket y GitHub Desktop como ejemplos.

Crear repositorios

Pídele a tu administrador o jefe de equipo que cree repositorios para ti. En general, lo más recomendable es contar con dos repositorios:

• Un repositorio personal para que puedas almacenar tus proyectos StudioX personales, a los que es poco probable que otros usuarios necesiten acceder.
• Un repositorio compartido para el equipo para los proyectos de StudioX a cuyos archivos es probable que necesiten acceder todos los miembros de tu equipo u organización.

Consejos y recursos

• Trabaja solo con una única rama (por ejemplo, maestra).
• No crees ramas adicionales ni solicitudes de incorporación sin una buena razón. Pueden complicar el proceso de uso del control de versión.
• Haz siempre una solicitud de incorporación para sincronizar cualquier cambio desde el repositorio antes de comenzar a trabajar en un proyecto.
• Haz siempre un Confirmar y un Insertar cuando termines de trabajar en un proyecto para asegurarte de que tus cambios se suben al repositorio.
• Para obtener más guías detalladas de GitHub, visita el portal de documentación de GitHub Dekstop.
• Para obtener más guías relacionadas con la aplicación Sourcetree, visita el portal de documentación de Atlassian.

<details>

<summary>GitHub Desktop</summary>

Descargar e instalar GitHub Desktop

Para comenzar a usar GitHub Desktop debes descargarlo, instalarlo y configurarlo en tu máquina. Para hacerlo, visita la guía de GitHub sobre cómo descargar e instalar su software.

Configurar GitHub Desktop en tu máquina

Si aún no tienes una cuenta, crea una e inicia sesión en la aplicación GitHub Desktop.

Para conectar un repositorio a tu proyecto local:

1. Abre la aplicación GitHub Desktop.
2. Haz clic en el menú Archivo y selecciona Clonar repositorio.

3. En la ventana recién abierta:

   • Haz clic en la pestaña GitHub.com.
   • Introduce el nombre del repositorio.
   • Introduce la ruta de la carpeta \Documents\UiPath en el campo Ruta local.

4. Haz clic en Clonar cuando todo esté configurado.

   
   

   

   
   

Trabajar con proyectos

Sincroniza cualquier cambio desde el repositorio

Antes de crear un proyecto nuevo o realizar cambios a un proyecto existente en StudioX, asegúrate de que todos los proyectos están cerrados en StudioX (la forma más segura es asegurarse de que todas las instancias de StudioX están cerradas)

1. Abre la aplicación GitHub Desktop.

2. Escoge el repositorio que contenga el proyecto con el que estás trabajando.

   
   

   

   
   
3. Haz clic en el menú Repositorio en la parte superior y selecciona Incorporar.

Crear un nuevo proyecto

Para crear un nuevo proyecto de StudioX que utilice el control de versión:

1. Crea una nueva tarea en StudioX.

2. En el campo Ubicación, navega hasta la carpeta que represente al repositorio correcto (personal o compartido para el equipo).

   
   

   

   
   

Esto coloca el proyecto en su propia carpeta en la raíz del repositorio.

Nota:

Para proyectos existentes, si quieres moverlo al control de versión, la carpeta puede ser

trasladada manualmente a la carpeta del repositorio.

Confirmar cambios

Puedes guardar (confirmar) cambios desde tu máquina local al repositorio en línea tan a menudo como quieras.

1. Cierra el proyecto en StudioX.
2. Abre la aplicación GitHub Desktop.

3. Escoge el repositorio que contenga el proyecto de StudioX cuyos cambios quieras confirmar.

   
   

   

   
   
4. Introduce un breve resumen de los cambios en el campo Resumen.

5. Haz clic en el botón Confirmar.

   
   

   

   
   
6. Haz clic en el menú Repositorio en la parte superior y selecciona Incorporar.

7. Haz clic en el botón Insertar origen para enviar los cambios al repositorio.

   
   

   

   
   

</detalles>

<details>

<summary>Bitbucket</summary>

Descargar e instalar la aplicación Sourcetree

Para comenzar a usar Sourcetree debes descargarlo, instalarlo y configurarlo en tu máquina. Para hacerlo, visita la guía de Atlassian sobre cómo descargar e instalar su software.

Trabajar con proyectos

Sincroniza cualquier cambio desde el repositorio

Antes de crear un proyecto nuevo o realizar cambios a un proyecto existente en StudioX, asegúrate de que todos los proyectos están cerrados en StudioX (la forma más segura es asegurarse de que todas las instancias de StudioX están cerradas)

1. Abre la aplicación Sourcetree.
2. Haz clic en Remoto en la parte superior.

3. Selecciona el repositorio que contenga el proyecto en el que estás trabajando haciendo clic en Clonar.

   
   

   

   
   

Crear un nuevo proyecto

Para crear un nuevo proyecto de StudioX que utilice el control de versión:

1. Crea una nueva tarea en StudioX.

2. En el campo Ubicación, navega hasta la carpeta que represente al repositorio correcto (personal o compartido para el equipo).

   
   

   

   
   

Esto coloca el proyecto en su propia carpeta en la raíz del repositorio.

Nota:

Si hay proyectos existentes que necesiten ser trasladados al control de versión, la carpeta puede ser

trasladada manualmente a la carpeta del repositorio.

Confirmar cambios

Puedes guardar (confirmar) cambios desde tu máquina local al repositorio en línea tan a menudo como quieras.

1. Cierra el proyecto en StudioX.
2. Abre la aplicación Sourcetree.
3. Asegúrate de seleccionar el repositorio que contenga el proyecto de StudioX.
4. Haz clic en el icono + junto a los archivos que quieras confirmar para añadirlos a la lista.
   
   

   

   
   
5. Selecciona la casilla Insertar los cambios inmediatamente al origen/maestro.

6. Escribe un mensaje y haz clic en Confirmar en la esquina inferior derecha.

   
   

   

   
   

</detalles>