Compartir a través de


MSSCCPRJ.SCC (Archivo)

Cuando una solución o un proyecto de Visual Studio se coloca bajo control de código fuente utilizando el IDE, el IDE recibe dos fragmentos de información clave del complemento de control de código fuente en forma de cadenas. Estas cadenas, “AuxPath” y “Nombre proyecto”, son opacas al IDE, pero son utilizadas por el complemento para buscar la solución o el proyecto en control de versiones. El IDE suele recibir estas cadenas la primera vez llamando a SccGetProjPath (Función), y a continuación las guarda en el archivo de la solución o el proyecto para las llamadas del futuro a SccOpenProject (Función). Cuando se insertan en los archivos de solución y de proyecto, las cadenas de “AuxPath” y “Nombre proyecto” no se actualizan automáticamente cuando las bifurcaciones de un usuario, bifurcaciones, ni copia archivos de solución y de proyecto que están en control de versiones. Para asegurarse de que el punto de archivos de solución y de proyecto a la ubicación correcta del control de versiones, usuarios debe actualizar manualmente las cadenas. Dado que las cadenas están diseñados para ser opacas, no siempre estar claro cómo deben actualizarse.

El complemento de control de código fuente puede evitar este problema almacenando las cadenas de “AuxPath” y “Nombre proyecto” en un archivo denominado especial el archivo de MSSCCPRJ.SCC. Es un archivo local, de cliente que es propiedad y mantenido por el complemento. Este archivo nunca se coloca bajo control de código fuente pero genera el complemento para cada directorio que contiene los archivos controlados mediante código fuente. Para determinar qué archivos son archivos de solución y de proyecto de Visual Studio, un complemento de control de origen puede comparar las extensiones de archivo con un estándar o una lista proporcionada por. Una vez que el IDE detecta que un complemento admite el archivo de MSSCCPRJ.SCC, comando de insertar las cadenas de “AuxPath” y “Nombre proyecto” en la solución y archivos de proyecto, y leer esas cadenas del archivo de MSSCCPRJ.SCC en su lugar.

Un complemento de control de código fuente que admite el archivo de MSSCCPRJ.SCC debe observar las siguientes instrucciones:

  • Sólo puede haber un archivo de MSSCCPRJ.SCC por directorio.

  • Un archivo de MSSCCPRJ.SCC puede contener “AuxPath” y “Nombre proyecto” para varios archivos que están bajo el control de código fuente en un directorio determinado.

  • La cadena de “AuxPath” no debe tener comillas dentro de ella. Se permite tener comillas alrededor de como delimitadores (por ejemplo, un par de comillas dobles se puede utilizar para indicar una cadena vacía). El IDE eliminará todas las comillas de la cadena de “AuxPath” cuando se lee del archivo de MSSCCPRJ.SCC.

  • La cadena de “Nombre proyecto” en el archivo de MSSCCPRJ.SCC debe coincidir exactamente con la cadena devuelta por la función de SccGetProjPath . Si la cadena devuelta por la función tiene comillas alrededor de ella, la cadena del archivo de MSSCCPRJ.SCC debe tener comillas alrededor de ella, y viceversa.

  • Se crea o se actualiza un archivo de MSSCCPRJ.SCC siempre que un archivo se coloque bajo control de código fuente.

  • Si un archivo de MSSCCPRJ.SCC obtiene eliminado, un proveedor debe regenerarlo la próxima vez que realiza una operación de control de código fuente que pertenecen a ese directorio.

  • un archivo de MSSCCPRJ.SCC debe seguir estrictamente el formato definido.

Una ilustración del formato de archivo de MSSCCPRJ.SCC

A continuación se muestra un ejemplo del formato de archivo de MSSCCPRJ.SCC (números de línea se proporcionan sólo como guía, y no deben incluir en el cuerpo del archivo):

[Línea 1] SCC = This is a Source Code Control file

[Línea 2]

[Línea 3] [TestApp.sln]

[Línea 4] SCC_Aux_Path = "\\server\vss\"

[Línea 5] SCC_Project_Name = "$/TestApp"

[Línea 6]

[Línea 7] [TestApp.csproj]

[Línea 8] SCC_Aux_Path = "\\server\vss\"

[Línea 9] SCC_Project_Name = "$/TestApp"

La primera línea indica la finalidad del archivo y actúa como la firma para todos los archivos de este tipo. Esta línea debe aparecer exactamente así en todos los archivos de MSSCCPRJ.SCC:

SCC = This is a Source Code Control file

Lo siguiente es una sección de configuración para cada archivo, marcados por el nombre de archivo entre corchetes. En esta sección se repite para cada archivo que sigue. esta línea es un ejemplo de un nombre de archivo, a saber, [TestApp.csproj]. El IDE cuenta con las dos líneas siguientes. , Sin embargo, no define el estilo de los valores definidos. las variables son SCC_Aux_Path y SCC_Project_Name.

SCC_Aux_Path = "\\server\vss\"

SCC_Project_Name = "$/TestApp"

No hay delimitador de extremo a esta sección. El nombre del archivo, así como de todos los literales que aparecen en el archivo, se define en el archivo de encabezado scc.h. Para obtener más información, vea Cadenas usadas como claves para buscar un complemento de control de código fuente.

Vea también

Conceptos

Cadenas usadas como claves para buscar un complemento de control de código fuente

Otros recursos

Complementos de control de código fuente