Agregar contenido al control de código fuente

por Jason Lee

En este tema se explica cómo agregar contenido al control de código fuente en Team Foundation Server (TFS) 2010. Describe cómo agregar soluciones y proyectos a un proyecto de equipo en TFS y se explica cómo agregar dependencias externas como marcos o ensamblados al control de código fuente.

Este tema forma parte de una serie de tutoriales basados en los requisitos de implementación empresarial de una empresa ficticia denominada Fabrikam, Inc. Esta serie de tutoriales utiliza una solución de muestra (Contact Manager) para representar una aplicación web con un nivel de complejidad realista, que incluye una aplicación ASP.NET MVC 3, un servicio Windows Communication Foundation (WCF) y un proyecto de base de datos.

Resumen de las tareas

En la mayoría de los casos, todos los miembros del equipo de desarrolladores deben poder agregar contenido al control de código fuente. Para agregar una solución al control de código fuente en TFS, deberá completar estos pasos generales:

  • Conéctese a un proyecto de equipo.
  • Asigne la estructura de carpetas del proyecto de equipo en el servidor a una estructura de carpetas en el equipo local.
  • Agregue la solución y su contenido al control de código fuente.
  • Agregue las dependencias externas al control de código fuente.

En este tema se explica cómo realizar estos procedimientos.

En las tareas y tutoriales de este tema se supone que ya ha creado un nuevo proyecto de equipo de TFS para administrar el contenido. Para obtener más información sobre cómo crear un nuevo proyecto de equipo, consulte Creación de un proyecto de equipo en TFS.

¿Quién realiza estos procedimientos?

En la mayoría de los casos, todos los miembros del equipo de desarrolladores deben poder agregar y modificar contenido dentro de proyectos de equipo específicos.

Conectar a un proyecto de equipo y crear una asignación de carpetas

Antes de agregar contenido al control de código fuente, debe conectarse a un proyecto de equipo y crear una asignación entre la estructura de carpetas en el servidor y el sistema de archivos de la máquina local.

Para conectarse a un proyecto de equipo y asignar una ruta de acceso local

  1. En la estación de trabajo del desarrollador, abra Visual Studio 2010.

  2. En Visual Studio, en el menú Equipo, haga clic en Conectar con Team Foundation Server.

    Nota:

    Si ya ha configurado una conexión a un servidor TFS, puede omitir los pasos 3 a 6.

  3. En el cuadro de diálogo Conexión al proyecto de equipo, haga clic en Servidores.

  4. En el cuadro de diálogo Agregar o quitar Team Foundation Server, haga clic en Agregar.

  5. En el cuadro de diálogo Agregar Team Foundation Server, proporcione los detalles de la instancia de TFS y, a continuación, haga clic en Aceptar.

    In the Add Team Foundation Server dialog box, provide the details of your TFS instance, and then click OK.

  6. En el cuadro de diálogo Agregar o quitar Team Foundation Server, haga clic en Cerrar.

  7. En el cuadro de diálogo Conectar proyecto de equipo, seleccione la instancia de TFS a la que quiere conectarse, seleccione la colección de proyectos de equipo, seleccione el proyecto de equipo al que desea agregar y, a continuación, haga clic en Conectar.

    In the Connect to Team Project dialog box, select the TFS instance you want to connect to, select the team project collection, select the team project you want to add to, and then click Connect.

  8. En la ventana Team Explorer, expanda el proyecto de equipo y, a continuación, haga doble clic en Control de código fuente.

    In the Team Explorer window, expand your team project, and then double-click Source Control.

  9. En la pestaña Explorador de control de código fuente, haga clic en No asignado.

    On the Source Control Explorer tab, click Not mapped.

  10. En el cuadro de diálogo Asignar, en el cuadro Carpeta local, vaya a (o cree) una carpeta local para que actúe como carpeta raíz para el proyecto de equipo y, a continuación, haga clic en Asignar.

    In the Map dialog box, in the Local folder box, browse to (or create) a local folder to act as the root folder for the team project, and then click Map.

  11. Cuando se le pida que descargue archivos de origen, haga clic en .

    When you're prompted to download source files, click Yes.

En este momento, ha asignado la carpeta del lado servidor del proyecto de equipo a una carpeta local de la estación de trabajo de desarrollador. También ha descargado cualquier contenido existente del proyecto de equipo en la estructura de carpetas local. Ahora puede empezar a agregar su propio contenido al control de código fuente.

Agregar soluciones y proyectos al control de código fuente

Para agregar proyectos y soluciones al control de código fuente, primero debe moverlos a la carpeta asignada para el proyecto de equipo en el equipo local. A continuación, puede proteger el contenido para sincronizar las adiciones con el servidor.

Agregar proyectos al control de código fuente

  1. En la estación de trabajo del desarrollador, mueva los proyectos y soluciones a una ubicación adecuada dentro de la estructura de carpetas asignada para el proyecto de equipo.

    Nota:

    Muchas organizaciones tendrán un enfoque preferido sobre cómo se deben organizar los proyectos y las soluciones en el control de código fuente. Para obtener instrucciones sobre cómo estructurar carpetas, vea Procedimiento: Estructurar las carpetas de control de código fuente en Team Foundation Server.

  2. Abra la solución en Visual Studio 2010.

  3. En la ventana Explorador de soluciones, haga clic con el botón derecho en la solución y, después, haga clic en Agregar solución al control de código fuente.

    In the Solution Explorer window, right-click the solution, and then click Add Solution to Source Control.

    Nota:

    En algunos casos, dependiendo de cómo le gusta su organización estructurar el contenido en TFS, es posible que tenga que agregar proyectos al control de código fuente individualmente para proporcionar un control más específico sobre cómo se organiza el código fuente.

  4. Compruebe que la pestaña Explorador de control de código fuente muestra el contenido que ha agregado dentro de la estructura de carpetas del servidor para el proyecto de equipo.

    Verify that the Source Control Explorer tab displays the content you've added within the server folder structure for the team project.

    Nota:

    La pestaña Explorador de control de código fuente muestra el contenido sin que se le pida más porque agregó la solución a una carpeta asignada en el sistema de archivos local. Si la solución estaba en una ubicación no asignada, se le pedirá que especifique ubicaciones de carpetas en TFS y en el sistema de archivos local.

  5. En la pestaña Explorador de control de código fuente, en el panel Carpetas, haga clic con el botón derecho en el proyecto de equipo (por ejemplo, ContactManager) y, a continuación, haga clic en Comprobar cambios pendientes.

  6. En el cuadro de diálogo Proteger: archivos de origen, escriba un comentario y, a continuación, haga clic en Proteger.

    In the Check In – Source Files dialog box, type a comment, and then click Check In.

En este momento ha agregado la solución al control de código fuente en TFS.

Agregar dependencias externas al control de código fuente

Al agregar un proyecto o solución al control de código fuente, también se agregarán archivos y carpetas dentro del proyecto o solución. Sin embargo, en muchos casos, los proyectos y las soluciones también dependen de dependencias externas, como los ensamblados locales, para funcionar correctamente. Debe agregar estos recursos al control de código fuente para permitir que Team Build y otros miembros del equipo de desarrolladores compilen el código correctamente.

Por ejemplo, la estructura de carpetas de la solución de ejemplo Contact Manager incluye una carpeta denominada "packages". Contiene el ensamblado y varios recursos auxiliares para el ADO.NET Entity Framework 4.1. La carpeta "packages" no forma parte la solución Contact Manager, pero la solución no se compilará correctamente sin ella. Para habilitar Team Build para compilar la solución, debe agregar la carpeta "packages" al control de código fuente.

Nota:

La inclusión de una carpeta de paquetes es típica de lo que sucede al agregar Entity Framework o recursos similares a la solución mediante la extensión NuGet para Visual Studio 2010.

Para agregar contenido que no sea de proyecto al control de código fuente

  1. Asegúrese de que los elementos que desea agregar (por ejemplo, la carpeta "packages") se encuentran en una ubicación adecuada dentro de una carpeta asignada en el sistema de archivos local.

  2. En Visual Studio 2010, en la ventana Team Explorer, expanda el proyecto de equipo y, a continuación, haga doble clic en Control de código fuente.

    In Visual Studio 2010, In the Team Explorer window, expand your team project, and then double-click Source Control.

  3. En la pestaña Explorador de control de código fuente, en el panel Carpetas, seleccione la carpeta que contiene el elemento o los elementos que desea agregar.

  4. Haga clic en el botón Agregar elementos a la carpeta.

    Click the Add Items to Folder button.

  5. En el cuadro de diálogo Agregar al control de código fuente, seleccione la carpeta o los elementos que desea agregar y, a continuación, haga clic en Siguiente.

    In the Add to Source Control dialog box, select the folder or items you want to add, and then click Next.

  6. En la pestaña Elementos excluidos, seleccione los elementos necesarios que se han excluido automáticamente (por ejemplo, ensamblados) y, a continuación, haga clic en Incluir elemento(s).

    On the Excluded items tab, select any required items that have been automatically excluded (for example, assemblies), and then click Include item(s).

  7. En la pestaña Elementos que se van a agregar, compruebe que se muestran todos los archivos que desea incluir y, a continuación, haga clic en Finalizar.

    On the Items to add tab, verify that all the files you want to include are listed, and then click Finish.

  8. En la ventana Explorador de control de código fuente, haga clic en el botón Insertar en el repositorio.

    In the Source Control Explorer window, click the Check In button.

  9. En el cuadro de diálogo Proteger: archivos de origen, escriba un comentario y, a continuación, haga clic en Proteger.

En este punto, ha agregado las dependencias externas de la solución al control de código fuente.

Conclusión

En este tema se describe cómo conectarse a un proyecto de equipo, asignar una estructura de carpetas y agregar contenido al control de código fuente. Para obtener más información sobre cómo trabajar con elementos en el control de código fuente, consulte Uso del control de versiones.

En el tema siguiente, Configuración de un servidor de compilación de TFS para la implementación web, se describe cómo preparar un servidor de compilación de equipo de TFS para compilar e implementar la solución.

Lecturas adicionales

Para obtener información más completa sobre cómo trabajar con el control de código fuente en TFS, consulte Uso del control de versiones.