Share via


Directrices de control de código fuente adicionales para proyectos y editores

Hay una serie de directrices que deben cumplir los proyectos y editores para admitir el control de código fuente.

Directrices

El proyecto o el editor también deben hacer lo siguiente para admitir el control de código fuente:

Área Proyecto Editor Detalles
Copias privadas de archivos X El apoyo ambiental copias privadas de archivos. Es decir, cada persona que se inscribe en el proyecto tiene su propia copia privada de los archivos de ese proyecto.
Persistencia ansi/Unicode X X Si escribe el código de persistencia, conserve los archivos en el formulario ANSI porque la mayoría de los programas de control de código fuente no admiten actualmente Unicode.
Enumerar archivos X El proyecto debe contener una lista específica de todos los archivos que contiene y debe poder enumerar la lista de archivos mediante o IVsSccProject2GetProperty (VSH_PROPID_First_Child/Next_Sibling). El proyecto también debe exponer los nombres de elementos a través de su GetMkDocument implementación y admitir la búsqueda de nombres (incluidos los archivos especiales) a través de su IsDocumentInProject implementación.
Formato de texto X X Cuando sea posible, los archivos deben estar en formato de texto para admitir la combinación de diferentes versiones. Los archivos que no están en formato de texto no se pueden combinar con otras versiones del archivo más adelante. El formato de texto preferido es XML.
Basado en referencias X Los proyectos basados en referencia se admiten fácilmente en el control de código fuente. Sin embargo, los proyectos basados en directorios también son compatibles con el control de código fuente siempre que el proyecto pueda generar una lista de sus archivos a petición, independientemente de si esos archivos existen en el disco. Al abrir un proyecto desde el control de código fuente, el archivo del proyecto se reduce primero antes de cualquiera de sus archivos.
Conservar objetos y propiedades en orden predecible X X Conserve los archivos en un orden predecible, como el orden alfabético, para facilitar la combinación.
Volver a cargar X X Cuando un archivo cambia en el disco, el editor debe poder volver a cargarlo. Al participar en el control de código fuente, el entorno volverá a cargar los datos mediante una llamada a la ReloadDocData implementación. El caso de recarga más difícil es cuando se produce una desprotección cuando se ha llamado A IVsQueryEditQuerySave::QueryEditFiles y se está procesando la información. Sin embargo, el código de recarga debe poder ejecutarse en esta situación.

El entorno vuelve a cargar automáticamente los archivos del proyecto. Sin embargo, un proyecto debe implementar IVsPersistHierarchyItem2 si tiene jerarquías anidadas para admitir la recarga de archivos de proyecto anidados.