Agregar archivos al servidor

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | VS 2017 | VS 2015 | VS 2013

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, primero debe configurar el área de trabajo en la máquina de desarrollo.

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

Puede crear simultáneamente un nuevo proyecto y agregarlo al control de versiones para que usted y su equipo puedan disfrutar inmediatamente de todas las ventajas del control de versiones a partir de la primera línea de código que escriba.

Cuadro de Project nuevo archivo

  1. En Visual Studio, si aún no lo ha hecho, conéctese al proyecto.

  2. Elija Archivo, Nuevo, Project (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 , especifique el nombre del proyecto de código.

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

  6. En la lista Ubicación, especifique la ruta de acceso a una buena carpeta de trabajo local (por ejemplo, c:\code\SiteApp\Main\)en el área de trabajo que creó al configurar la máquina de desarrollo.

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

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

    Proyecto de nuevo código en el Explorador de soluciones

  8. En Explorador de soluciones, abra el menú contextual de la solución que creó o modificó y, a continuación, elija Comprobar 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 usar 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 aún no lo ha hecho, conéctese al proyecto.

  2. Elija Ver, Otros Windows, Explorador de control de código fuente.

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

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

    ¿Qué debo hacer si el texto del vínculo es "No asignado"?

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

  6. En Visual Studio, elija Archivo ,Abrir ,Project/Solucióny, a continuación, use el cuadro de diálogo Abrir Project para abrir la solución.

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

  8. En Explorador de soluciones, seleccione la solución, abra su menú contextual y, a continuación, elija Comprobar.

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

  10. ¿Hay algún elemento detectado que se muestra en la sección Cambios excluidos?

    • No: Vaya al paso siguiente.

    • Sí: Elija el vínculo Detectado. Aparece 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, a continuación, elija Promover para moverlos a la sección Cambios incluidos de la página Cambios pendientes. Para obtener más información, vea Check in your work to the team's codebase(Comprobación del trabajo en el código base del equipo).

  11. Cuando esté listo, 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 va a crear un proceso automatizado o prefiere usar el símbolo del sistema, puede usar el comando Agregar en lugar de los procedimientos siguientes.

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

Importante

Estos pasos solo se aplican cuando se usa un área de trabajo local. Los archivos guardados al trabajar en un área de trabajo del servidor se agregarán y se comprobarán sin mostrarse como un cambio pendiente en Team Explorer.

Si usa un área de trabajo local,la página Cambios pendientes detecta automáticamente nuevos archivos.

  1. En Visual Studio, si aún no lo ha hecho, conéctese al proyecto.

  2. Elija Ver, Otros Windows, 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 situado junto a Ruta de acceso local para abrir la carpeta de destino en Windows Explorer (Explorador de archivos en Windows 8).

    Mueva los archivos y carpetas a esta carpeta.

    ¿Qué debo hacer si el texto del vínculo es "No asignado"?

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

  6. En la página Cambios pendientes, en la sección Cambios excluidos, seleccione el vínculo Detectado.

  7. En el cuadro de diálogo Promover cambios candidatos , asegúrese de que solo están seleccionados los archivos que desea insertar en el registro 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, Otros Windows, 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 va a crear la carpeta ahora, abra su menú contextual, elija Comprobary, a continuación, compruebe la nueva carpeta antes de continuar.

  1. 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.

  2. 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.

  3. Elija Finalizar.

  4. 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 Check In (Comprobar).

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, por algún motivo, cada equipo debe trabajar en diferentes colecciones de proyectos. Como resultado, el equipo B entrega archivos binarios al equipo A, que después este comprueba en el control de versiones.

Sugerencia

Si las máquinas de desarrollo y los agentes de compilación pueden acceder a Internet, NuGet puede facilitar al equipo la administración de las dependencias y mantener actualizados los archivos binarios. Puede almacenar los paquetes en TFS o Azure DevOps Services mediante Azure Artifacts.

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:

Carpeta de biblioteca en la carpeta primaria principal
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 rama 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.

Carpeta de biblioteca en una estructura de rama

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, varios proyectos contienen soluciones con dependencias diferentes en un conjunto común de bibliotecas. En casos como este, puede almacenar las bibliotecas de terceros en un proyecto dedicado. Los colaboradores de los distintos proyectos se asignan en las carpetas que contienen las bibliotecas que necesitan.

Por ejemplo, FabrikamFiber coloca la siguiente estructura de proyecto, rama y carpeta:

Bibliotecas almacenadas en un proyecto dedicado

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:

Asignación de áreas de trabajo en las bibliotecas

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:

  • Al agregar archivos omitido a carpetas que están asignadas en un área de trabajo local,no aparecen en la página Cambios pendientes de Team Explorer.

  • Al intentar agregar archivos omitido mediante el cuadro de diálogo Agregar al control de código fuente (por ejemplo, arrastrándolos a Explorador de control de código fuente), aparecen automáticamente en la pestaña Elementos excluidos .

Puede configurar qué tipos de archivos se omiten colocando el archivo de texto denominado .tfignore en la carpeta donde desea que se apliquen 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:

  • # comienza una línea de comentario

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

  • Una filespec es recursiva a menos que tenga el prefijo del \ carácter .

  • ! nega un filespec (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 haya detectado un cambio.

Importante

Esto solo se aplica cuando se usa un área de trabajo local. Los archivos modificados al trabajar en un área de trabajo del servidor se comprobarán sin mostrarse como un cambio pendiente en Team Explorer.

Para generar automáticamente un archivo .tfignore

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

    Aparece el cuadro de diálogo Promover cambios candidatos.

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

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

  4. Aparece un archivo .tfignore en la sección Cambios incluidos de la página Cambios pendientes. 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

  • Agregue el comando Upload archivos desde el área de trabajo del equipo de desarrollo al servidor.

Consulte también

Otros recursos

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