Agregar archivos al servidor

El proceso para agregar un archivo al control de versiones normalmente se realiza de forma automática cuando se utiliza el Explorador de soluciones y el proyecto está bajo el control de versiones. Sin embargo, en algunos casos, deben realizarse algunos pasos adicionales para agregar el proyecto al control de versiones.

Sugerencia
Antes de agregar archivos al control de versiones, debe configurar el área de trabajo del equipo de desarrollo.

¿Qué desea hacer?

• Crear un nuevo proyecto de código y una solución con control de versiones

• Incluir una solución existente y proyectos de código bajo el control de versiones

• Agregar uno o varios archivos al control de versiones

• Aprovechar archivos binarios de terceros que su código no compila

• Personalizar qué archivos se van a omitir en el control de versiones

• Trabajar desde el símbolo del sistema

Crear un nuevo proyecto de código y una solución con control de versiones

Puede crear simultáneamente un nuevo proyecto de equipo y agregarlo al control de versiones para que, junto con su equipo, pueda disfrutar inmediatamente de todas las ventajas del control de versiones, desde la primera línea de código que escriba.

1. En Visual Studio, si todavía no lo ha hecho, conéctese al proyecto de equipo.

2. Elija archivo, Nuevo, Proyecto (teclado: Ctrl + Mayús + N).

   Aparecerá el cuadro de diálogo Nuevo proyecto.

3. Seleccione el tipo de proyecto de código que desea crear.

4. En el cuadro Nombre, escriba el nombre del proyecto de código.

5. Si aparece la lista Solución, asegúrese de que la opción Crear nueva solución está seleccionada.

6. En la lista Ubicación, especifique la ruta de acceso a una carpeta de trabajo local (como c:\code\SiteApp\Main\) del área de trabajo que creó al configurar el equipo de desarrollo.

   Asegúrese de que las casillas Crear directorio para la solución y Agregar al control de código fuente estén activadas.

7. Elija Aceptar para crear el proyecto de código, que podrá ver en el Explorador de soluciones (teclado: Ctrl + Alt + L).

   

8. En el Explorador de soluciones, abra el menú contextual de la solución que creó o modificó y, a continuación, elija Proteger para enviar los cambios pendientes.

Incluir una solución existente y proyectos de código bajo el control de versiones

Para agregar una solución existente al control de versiones, mueva todos los archivos de la solución al área de trabajo y, a continuación, agréguelos.

Nota
Evite utilizar el cuadro de diálogo Agregar solución al control de código fuente para cargar la solución en el control de versiones.Use en su lugar el siguiente procedimiento.

1. En Visual Studio, si todavía no lo ha hecho, conéctese al proyecto de equipo.

2. Elija Ver, Otras ventanas, Explorador de control de código fuente.

3. En el Explorador de control de código fuente, navegue hasta una carpeta principal lógica de la solución, como $/SiteApp/Main, donde SiteApp es el nombre del proyecto del equipo. ¿Por qué esta es una carpeta principal adecuada?

4. Elija el vínculo junto a Ruta de acceso local para abrir la carpeta principal en el Explorador de Windows (o el Explorador de archivos en Windows 8).

   ¿Qué hago si el texto del vínculo es “Sin asignar”?

5. Lleve la carpeta que contiene la solución a la carpeta principal.

6. En Visual Studio, elija Archivo, Abrir, Proyecto o solución y utilice el cuadro de diálogo Abrir proyecto para abrir la solución.

7. En el Explorador de soluciones (teclado: Ctrl + Alt + L), seleccione la solución, abra el menú contextual y después elija Agregar solución al control de código fuente.

8. En el Explorador de soluciones, seleccione la solución, abra el menú contextual y después elija Proteger.

9. En Team Explorer, aparece la página Cambios pendientes.

10. ¿Hay cambios detectados que se muestran en la sección Cambios excluidos?

    • No: vaya al paso siguiente.

    • Sí: elija el vínculo Cambios detectados. Aparecerá el cuadro de diálogo Promover cambios candidatos. Los archivos que aparecen en este cuadro de diálogo no tienen referencias en ningún proyecto de código de la solución. Si el equipo necesita estos archivos, asegúrese de que estén seleccionados y después elija Promover para moverlos a la sección Cambios incluidos de la página Cambios pendientes. Para obtener más información, vea Proteger su contribución al código base del equipo.

11. Cuando esté preparado, envíe los cambios pendientes.

Agregar uno o varios archivos al control de versiones

Cuando se utiliza el Explorador de soluciones para agregar un archivo al proyecto de código, el sistema lo agrega automáticamente al control de versiones. Sin embargo, también se pueden agregar archivos que no tienen referencias en los proyectos de código.

Sugerencia
Si crea un proceso automatizado o si prefiere usar el símbolo del sistema, puede utilizar Add (Comando) en lugar de los procedimientos siguientes.

Agregar automáticamente uno o varios archivos al control de versiones

Si usa un área de trabajo local, los archivos nuevos se detectan automáticamente en la página Cambios pendientes.

1. En Visual Studio, si todavía no lo ha hecho, conéctese al proyecto de equipo.

2. Elija Ver, Otras ventanas, Explorador de control de código fuente.

3. En el Explorador de control de código fuente, navegue a la carpeta en la que desea agregar los archivos o carpetas.

4. Elija el vínculo que se encuentra junto a Ruta de acceso local para abrir la carpeta de destino en el Explorador de Windows (o el Explorador de archivos en Windows 8).

   Mueva los archivos y carpetas a esta carpeta.

   ¿Qué hago si el texto del vínculo es “Sin asignar”?

5. En Visual Studio, en Team Explorer, elija Cambios pendientes.

6. En la página Cambios pendientes, en la sección Cambios Excluidos, elija Cambios detectados.

7. En el cuadro de diálogo Promover cambios candidatos, asegúrese de que solo los archivos que desea proteger estén seleccionados y, a continuación, elija Promover.

8. Envíe los cambios pendientes.

Agregar manualmente los archivos al control de versiones

También puede agregar manualmente los archivos al control de versiones.

1. Elija Ver, Otras ventanas, Explorador de control de código fuente.

2. En el Explorador de control de código fuente, navegue a la carpeta en la que desea colocar los archivos o carpetas.

   Importante
   Asegúrese de que esta carpeta está protegida antes de continuar.Si está creando la carpeta ahora, abra el menú contextual, elija Proteger y proteja la carpeta antes de continuar.

3. Arrastre las carpetas o los archivos desde el Explorador de Windows (o Explorador de archivos) a la carpeta del Explorador de control de código fuente.

4. Cuando aparezca el cuadro de diálogo Agregar al control de código fuente, asegúrese de que todos los archivos que desea agregar estén seleccionados y, a continuación, elija Incluir elementos.

5. Elija Finalizar.

6. En Team Explorer, cuando aparezca la página Cambios pendientes, asegúrese de que los archivos binarios que desea agregar aparecen en la sección Cambios incluidos. Elija Proteger.

Aprovechar archivos binarios de terceros que su código no compila

Muchos equipos desarrollan código que depende de archivos binarios que no se compilan en la solución en la que se administra el código. Normalmente, estos archivos binarios forman parte de una biblioteca que el equipo utiliza con licencia de terceros.

A veces, estos archivos binarios proceden de otro equipo de la misma compañía. Por ejemplo, el equipo A depende de los archivos binarios generados por el equipo B, y cada equipo debe, por alguna razón, trabajar en colecciones de proyectos de equipo diferentes. Como resultado, el equipo B entrega archivos binarios al equipo A, que después este comprueba en el control de versiones.

Sugerencia
Si los equipos de desarrollo y los servidores de compilación pueden acceder a Internet, NuGet puede facilitar a su equipo la administración de las dependencias y mantener los archivos binarios actualizados.Aunque decida utilizar NuGet, es muy probable que aún tenga que agregar los archivos binarios al control de versiones para poder reproducir y compilar versiones históricas del código.

La estructura de carpetas y áreas de trabajo que debe utilizar para almacenar los archivos binarios de terceros varía en función del modo en que las soluciones dependen de estas bibliotecas.

Agregar archivos binarios en la estructura de carpetas o bifurcaciones

Si sitúa los archivos binarios de terceros en la misma carpeta primaria que contiene las carpetas de la solución, todos los proyectos de código de todas las soluciones podrán hacer referencia a las bibliotecas con la misma ruta de acceso relativa.

Por ejemplo, un equipo utiliza esta estructura de carpetas:

Cada proyecto de código puede hacer referencia a la carpeta de bibliotecas con la ruta de acceso relativa siguiente: ../../Lib

Si, posteriormente en el proyecto, su equipo necesita aislar el trabajo con independencia de si se requieren versiones diferentes de los archivos binarios, se puede crear una bifurcación de la carpeta de bibliotecas junto con la carpeta de la solución.

Por ejemplo, la versión 1 de una aplicación aprovecha la versión 1 de una biblioteca. Como algunos desarrolladores del equipo de acceso a datos trabajan en la versión siguiente, aprovechan la versión 2. Sin embargo, los demás equipos no están preparados para realizar la actualización. Puede utilizar las bifurcaciones para administrar este tipo de situación.

Usar un área de trabajo para asignarla en los archivos binarios

Algunas compañías deben administrar dependencias más complejas de bibliotecas de terceros. Por ejemplo, muchos proyectos de equipo contienen soluciones con diferentes dependencias de un conjunto de bibliotecas común. En casos como este, puede almacenar sus bibliotecas de terceros en proyectos de equipo dedicados. Los colaboradores de los diversos proyectos de equipo asignan las carpetas que contienen las bibliotecas que necesitan.

Por ejemplo, FabrikamFiber establece el proyecto de equipo, la bifurcación y la estructura de carpetas siguientes:

Raisa configura su equipo de desarrollo con dos áreas de trabajo para dos trabajos diferentes, a cada uno de los cuales se les asigna las bibliotecas que necesita:

Personalizar qué archivos se van a omitir en el control de versiones

De forma predeterminada, el control de versiones omite ciertos tipos de archivos (por ejemplo, archivos .dll). Como resultado:

• Cuando se agregan archivos omitidos a las carpetas asignadas en un área de trabajo local, no aparecen en la página Cambios pendientes de Team Explorer.

• Cuando intenta agregar archivos omitidos utilizando el cuadro de diálogo Agregar a control de código fuente (por ejemplo arrastrándolos al Explorador de control de código fuente), estos aparecen automáticamente en la pestaña Elementos excluidos.

Puede configurar los tipos de archivos que se omitirán colocando un archivo de texto denominado .tfignore en la carpeta en la que desea aplicar las reglas. Los efectos del archivo .tfignore son recursivos. Sin embargo, puede crear archivos .tfignore en subcarpetas para reemplazar los efectos de un archivo .tfignore de una carpeta primaria.

Reglas del archivo .tfignore

Las siguientes reglas se aplican a los archivos .tfignore:

• # inicia una línea de comentario

• Se admiten los caracteres comodín * y ?.

• Una especificación de archivo es recursiva a menos que vaya precedida por el carácter \.

• ! niega una especificación de archivo (los archivos que coinciden con el patrón no se omiten)

Ejemplo de archivo .tfignore

######################################
# Ignore .cpp files in the ProjA sub-folder and all its subfolders
ProjA\*.cpp
# 
# Ignore .txt files in this folder 
\*.txt
#
# Ignore .xml files in this folder and all its sub-folders
*.xml
#
# Ignore all files in the Temp sub-folder
\Temp
#
# Do not ignore .dll files in this folder nor in any of its sub-folders
!*.dll

Crear y usar un archivo .tfignore

Aunque puede crear manualmente un archivo de texto .tfignore mediante las reglas anteriores, también puede generar uno automáticamente cuando la página Cambios pendientes detecte un cambio.

Para generar automáticamente un archivo .tfignore

1. En la página Cambios pendientes, en la sección Cambios excluidos, elija el vínculo Cambios detectados.

   Aparecerá el cuadro de diálogo Promover cambios candidatos.

2. Seleccione un archivo, abra el menú contextual y elija Omitir este elemento local, Omitir por extensión, Omitir por nombre de archivo u Omitir por carpeta.

3. Elija Aceptar o Cancelar para cerrar el cuadro de diálogo Promover cambios candidatos.

4. En la sección Cambios incluidos de la página Cambios pendientes, aparece un archivo .tfignore. Puede abrir este archivo y modificarlo según sus necesidades.

El archivo .tfignore se agrega automáticamente como un cambio pendiente incluido, de modo que las reglas que ha creado se aplicarán a cada miembro del equipo que obtenga el archivo.

Trabajar desde el símbolo del sistema

• Add (Comando) Cargue los archivos desde el área de trabajo del equipo de desarrollo en el servidor.

Vea también

Otros recursos

Decidir entre usar un área de trabajo local o del servidor