Tutorial: Explorar el control de versiones de Team Foundation

Artículo
10/07/2008

Actualización: noviembre 2007

En este tutorial se muestran las características de integración del control de versiones de Visual Studio Team System Team Foundation Server.

En este tutorial se describe cómo utilizar el control de versiones en el IDE de Visual Studio Team System Team Foundation Server. En particular, puede aprender a realizar las tareas siguientes:

Establecer Control de versiones de Team Foundation como complemento de control de versiones predeterminado para Visual Studio Team System Team Foundation Server.
Crear un nuevo proyecto en Visual Studio.
Agregar el proyecto al control de versiones y crear un área de trabajo local donde almacenar, editar y probar archivos bajo control de versiones.
Proteger la solución.
Agregar un archivo al proyecto con control de versiones y editar uno ya existente.
Confirmar todos los cambios pendientes del área de trabajo local en el servidor de control de versiones.

Requisitos previos

Para seguir este tutorial debe:

Especificar un servidor Team Foundation Server. Para obtener más información sobre cómo conectarse con un servidor Team Foundation Server, vea Cómo: Conectarse a Team Foundation Server.
Crear o abrir un proyecto de equipo existente. Para obtener más información, vea Tutorial: Crear un nuevo proyecto de equipo o Tutorial: Unirse a un proyecto de equipo.

Permisos necesarios

Para realizar este tutorial, debe tener los permisos Read y Checkin.

Establecer el control de versiones de Team Foundation como complemento de control de código fuente

Para poder utilizar Control de versiones de Team Foundation, antes debe configurar Visual Studio para que utilice el complemento Control de versiones de Team Foundation como se muestra en el procedimiento siguiente. Para obtener más información, vea Cómo: Configurar Visual Studio con el control de versiones de Team Foundation.

Nota:
Visual Studio está configurado para usar automáticamente el complemento de Control de versiones de Team Foundation cuando se instala Team Explorer una vez instalado Visual Studio.

Para configurar Visual Studio para que utilice el control de versiones de Team Foundation

En el menú Herramientas, seleccione Opciones.
En el cuadro de diálogo Opciones, busque Control decódigo fuente, despliéguelo y haga clic en Selección de complemento.
En la lista desplegable Complemento de control de código fuente actual, seleccione Visual Studio Team Foundation Server.
Haga clic en Aceptar.

Agregar un proyecto al control de versiones

Cuando cree proyectos, es posible que desee agregarlos al control de versiones para poder administrarlos en Control de versiones de Team Foundation. La primera vez que agrega un proyecto al control de versiones Control de versiones de Team Foundation crea un área de trabajo automáticamente. Un área de trabajo es una copia de cliente de los archivos y las carpetas del servidor Team Foundation. Cuando agregue, modifique, elimine, mueva, cambie de nombre o administre de alguna otra forma un elemento con control de versiones, los cambios se conservarán en el cliente. Estos cambios se controlan como cambios pendientes en el área de trabajo del equipo local.

Un área de trabajo proporciona un espacio aislado en el que puede escribir y probar su código. Las modificaciones que realiza no afectan a la estabilidad del código fuente protegido. Está desligado de las modificaciones que sus compañeros de equipo realizan. Los cambios pendientes se aislarán en el área de trabajo hasta que los confirme en el servidor Team Foundation protegiéndolos.

Por cada servidor Team Foundation puede crear varias áreas de trabajo en su equipo. Para obtener más información, vea Trabajar con espacios de trabajo del control de versiones.

Para crear una nueva solución y un nuevo proyecto

En el menú Archivo, haga clic en Nuevo y, a continuación, en Proyecto.
En el cuadro de diálogo Nuevo proyecto, seleccione Visual C# en el panel Tipos de proyecto.
En el panel derecho, haga clic en Aplicación de Windows Forms.
En el cuadro Nombre, escriba MiAplWindows y, a continuación, escriba una ruta de acceso en el cuadro Ubicación .
Active la casilla Agregar al control de código fuente y haga clic en Aceptar.
En el cuadro Agregar solución al control de código fuente, seleccione el proyecto de equipo que desea utilizar para este tutorial.
Haga clic en Aceptar.

También puede agregar soluciones y proyectos desde la línea de comandos o desde el menú de Visual Studio. Sin embargo, cuando se agregan proyectos y soluciones de esta forma, estos proyectos y soluciones no se enlazan. Al enlazar se proporciona la funcionalidad de control de versiones. Esto incluye varios iconos de control de versiones que indican el estado en el Explorador de soluciones. Para obtener más información, vea Cómo: Enlazar y desenlazar proyectos y soluciones, Comando add y Cómo: Agregar archivos y carpetas que no son de proyecto ni de solución al control de versiones.

Ventana Cambios pendientes

En la ventana Cambios pendientes se proporciona información sobre el estado de los cambios pendientes en el área de trabajo. Utilice esta ventana para realizar un seguimiento de la información asociada a los cambios, como elementos de trabajo pertinentes y notas de protección. Puede utilizar el menú Ver para tener acceso a la ventana Cambios pendientes. Para obtener más información, vea Utilizar las ventanas de cambios pendientes y de protección de cambios pendientes.

Nota:
Debe obtener la versión más reciente de todo el código fuente relevante del servidor y generar el código para asegurarse de que la compilación se realiza sin errores antes de proteger los cambios pendientes.

A continuación, debe utilizar la ventana Cambios pendientes para proteger los nuevos archivos de solución en el control de versiones.

Para proteger los cambios pendientes de la solución en el control de versiones

En el menú Generar, haga clic en Generar solución para confirmar que la aplicación se genera sin errores.
Si no está abierta la ventana Cambios pendientes, en el menú Ver, haga clic en Otras ventanas y luego en Cambios pendientes.

En la ventana Cambios pendientes se mostrarán los archivos de solución como agregar. Esto indica que los archivos se han creado en el área de trabajo, pero no se han agregado todavía al servidor.
En el cuadro de diálogo de la ventana Cambios pendientes, escriba el comentario "Agregar nuevo proyecto al control de versiones" en el cuadro Comentario.
Haga clic en Proteger para proteger los cambios de adiciones pendientes en el servidor.

Para obtener más información, vea Cambios pendientes y Cómo: Proteger cambios pendientes. Para obtener más información, vea Enviar cambios al servidor del control de versiones.

Editar el proyecto con control de versiones

El control de versiones es una parte totalmente integrada del desarrollo de Visual Studio. Por ejemplo, cuando se agrega un archivo a un proyecto con control de versiones, Visual Studio desprotege y actualiza de manera silenciosa el archivo de proyecto.

Cuando se agrega un archivo a un proyecto con control de versiones, Visual Studio asume que se pretende editar el archivo de alguna forma antes de que los compañeros del equipo puedan disponer de él. Por tanto, los archivos recién agregados no se protegen automáticamente. Se tratan como elementos agregados pendientes en el control de versiones. Cuando proteja explícitamente los cambios no confirmados, creará un nuevo conjunto de cambios en el servidor

Para agregar un archivo a un proyecto con control de versiones

Haga clic con el botón secundario del mouse en el proyecto del Explorador de soluciones, haga clic en Agregar y, a continuación, en Clase.
En el cuadro de diálogo Agregar nuevo elemento, haga clic en Agregar para agregar Class1.cs al proyecto.

Class1.cs aparece junto con los demás archivos del proyecto en la ventana Cambios pendientes y el tipo de cambio es adición. En el Explorador de soluciones observará que el icono del proyecto ha cambiado de un candado azul a una marca de verificación roja. Este icono indica que el archivo de proyecto está desprotegido. Observe que Class1.cs aparece con un signo más (+). Esto indica una adición pendiente.

Los archivos se desprotegen automáticamente y de forma silenciosa cuando decide editar un archivo de proyecto que está protegido.

Para editar un archivo existente de un proyecto con control de versiones

En el Explorador de soluciones, en la carpeta Propiedades, haga doble clic en AssemblyInfo.cs.
Agregue una nueva directiva using como using System.IO.Ports; al archivo en el editor de código.

Observe que Team Foundation desprotege automáticamente AssemblyInfo.cs cuando se empieza a editar. En el Explorador de soluciones, el icono de señal cambia a una marca de verificación. El sistema agrega el archivo a la lista de archivos de código fuente en la ventana Cambios pendientes.

Sincronizar el área de trabajo con la versión más reciente del servidor

La operación Obtener la última versión se utiliza para mantener los archivos del área de trabajo sincronizados con la última versión del servidor. Si siempre sincroniza y genera los archivos antes de protegerlos, puede evitar que se interrumpa la compilación de integración. Puede interrumpir una compilación si usted y otro usuario protegen cambios no conflictivos, pero mutuamente incompatibles, que impiden que se compile la aplicación.

Para obtener la última versión del servidor en el área de trabajo y generar

Haga clic con el botón secundario del mouse en el Explorador de soluciones y, a continuación, haga clic en Obtener la última versión (recursivo).
En el menú Generar, haga clic en Generar solución para confirmar que la aplicación se genera sin errores.

Proteger los cambios pendientes en el servidor

Después de asegurarse de que la aplicación se genera con la versión más reciente, puede proteger los cambios en Control de versiones de Team Foundation y hacer visible el proyecto a los compañeros de equipo.

Nota:
Si no se genera la aplicación porque no ha tenido tiempo de probarla, o si desea que otro desarrollador revise su código, puede aplazar los cambios en lugar de protegerlos. Para obtener más información, vea Trabajar con conjuntos de cambios aplazados del control de versiones.

Los cambios pendientes pueden protegerse de las maneras siguientes:

Utilizando el submenú Control de código fuente del menú Archivo.
Haciendo clic con el botón secundario del mouse en un archivo desprotegido en el Explorador de soluciones o el Explorador de control de código fuente.
Haciendo clic en Proteger, en la ventana Cambios pendientes.

Para proteger todos los cambios pendientes en el servidor

En el menú Ver, haga clic en Otras ventanas y, a continuación, haga clic en Cambios pendientes.
En la ventana Cambios pendientes, escriba un comentario en el cuadro Comentario para explicar el tipo de cambio que ha realizado.

Por ejemplo, podría escribir "he agregado una directiva using" e indicar el motivo: "para permitir llamadas a la clase Directory".
Abra el canal Elementos de trabajo y seleccione los elementos de trabajo que guardan relación con los cambios pendientes.

Para obtener más información, vea Cómo: Asociar los elementos de trabajo a conjuntos de cambios.

Abra el canal Notas de protección y agregue comentarios para las notas de protección destinadas al Revisor del código, al Revisor de seguridad y al Revisor del rendimiento.

Nota:
Un administrador puede configurar las notas de protección como campos obligatorios. Se deben rellenar durante el proceso de protección. El color sombreado del fondo del cuadro de texto indica que los campos son obligatorios.

Para obtener más información sobre cómo crear notas de protección y crear transiciones de elemento de trabajo personalizadas, vea Tutorial: Personalizar las notas y directivas de protección.

Haga clic en Proteger.

El proceso de protección del servidor Team Foundation Server está diseñado para facilitar el uso individual y la extensibilidad del equipo. Para optimizar la facilidad de uso, la ventana Cambios Pendientes supone implícitamente que desea proteger todos los cambios. Sin embargo, es fácil evitar la protección de cambios pendientes concretos. Generalmente la protección aplica conjuntos de cambios relacionados en lugar de aplicar cada uno de ellos por separado. Y a la inversa, al proteger desde el Explorador de soluciones o desde el menú Archivo, Visual Studio asume que sólo se desea proteger los cambios en el elemento seleccionado. Cuando selecciona un contenedor de archivos como un proyecto o una solución, selecciona proteger ese elemento y los elementos que contiene.

El administrador de Team Foundation Server puede asociar un conjunto de directivas de protección personalizadas a un proyecto de equipo para asegurarse de que todas las protecciones cumplen una serie de directrices o requisitos concretos.

Los distintos miembros del equipo pueden crear elementos de trabajo para realizar un seguimiento de los errores del producto o la solicitud de nuevas características. Pueden asociar un elemento de trabajo a un proyecto específico. Al finalizar un elemento de trabajo, éste puede asociarse con los cambios sufridos por el código fuente marcándose como tal en el canal Elementos de trabajo de la ventana Cambios pendientes. Al asociar los elementos de trabajo a cambios de código fuente, garantizará que se realice un seguimiento responsable y cuidadoso del estado del trabajo.

Por último, tanto usted como sus compañeros de equipo pueden agregar notas relevantes e importantes a cada protección. La plantilla de proceso utilizada para crear el proyecto de equipo determina el formato y el contenido de las notas de protección. El administrador de Team Foundation Server puede personalizar la plantilla para su equipo. Entre las categorías de notas de protección se encuentran las siguientes: impacto en el rendimiento, requisitos de la documentación, instrucciones para las pruebas e instrucciones para la generación.

El proceso de protección

Al hacer clic en Proteger,el sistema empaqueta juntos los archivos de código fuente seleccionados con todas las notas de protección y elementos de trabajo que especificó en la ventana Cambios pendientes. Control de versiones de Team Foundation carga a continuación este paquete en el servidor de Team Foundation y lo confirma como un nuevo conjunto de cambios. Un conjunto de cambioses un grupo de revisiones de archivos, notas de protección, elementos de trabajo asociados y metadatos de control de versiones que se almacenan en el servidor como una sola entidad fácil de administrar. Para obtener más información, vea Trabajar con conjuntos de cambios del control de versiones.

En segundo lugar, los elementos de trabajo incluidos en el conjunto de cambios se actualizan para que contengan los vínculos al conjunto de cambios recién creado.

A continuación, los elementos de trabajo atraviesan un flujo de trabajo basado en reglas de procesamiento predefinidas. Por ejemplo, el equipo podría definir una regla que cambiara automáticamente el estado de un error de "Activo" a "Resuelto" si su subestado fuera "Corrección disponible" cuando se protegiese dicho error. Las reglas de procesamiento y flujo de trabajo se crean mediante la plantilla de proceso utilizada para crear el proyecto de equipo. Sin embargo, el administrador de Team Foundation Server puede personalizar las reglas y el flujo de trabajo. Para obtener más información, vea Personalizar plantillas de procesos.

Por último, Control de versiones de Team Foundation genera una notificación de correo electrónico para todos los miembros del equipo que desean recibir notificaciones de protección.

Pasos siguientes

Después de completar los pasos de este tutorial, puede obtener más información sobre las funciones avanzadas de Control de versiones de Team Foundation. Para obtener más información, vea Tutorial: Funciones avanzadas del control de versiones. En este tutorial se muestra cómo bifurcar, combinar y aplicar etiquetas a elementos con control de versiones.

Vea también

Compartir a través de