Implementar directivas de protección de análisis de código personalizadas para el código administrado
Una directiva de protección de análisis de código especifica un conjunto de reglas que los miembros de un proyecto de equipo deben ejecutar en el código fuente antes de protegerlo en el control de versiones. Microsoft proporciona una serie de conjuntos de reglas estándar que agrupan el análisis de código del grupo en áreas funcionales. Los conjuntos de reglas de directivas de protección personalizadas especifican un conjunto de reglas de análisis de código específicas de un proyecto de equipo. Un conjunto de reglas se almacena en un archivo .ruleset.
Las directivas de protección se establecen en el nivel de proyecto de equipo y son especificadas por la ubicación de un archivo .ruleset en el árbol del control de versiones. No hay ninguna restricción en cuanto a la ubicación del control de versiones del conjunto de reglas de directivas personalizadas de equipo.
El análisis de código para los proyectos de código individuales se configura en la ventana Propiedades de cada proyecto. Un conjunto de reglas personalizadas para un proyecto de código se especifica por la ubicación física del archivo .ruleset en el equipo local. Cuando se especifica un archivo .ruleset que se encuentra en la misma unidad que el proyecto de código, Visual Studio 2010 utiliza una ruta de acceso relativa al archivo en la configuración del proyecto.
Un ejercicio sugerido para crear un conjunto de reglas personalizadas de proyecto de equipo es almacenar el archivo .ruleset de directivas de protección en una carpeta especial que no forme parte de ningún proyecto de código. Si almacena el archivo en una carpeta dedicada, puede aplicar permisos que restrinjan quién puede modificar el archivo de reglas, además de poder mover con facilidad la estructura de directorios que contiene el proyecto a otro directorio o equipo.
Crear el conjunto de reglas de protección personalizadas del proyecto de equipo
Para crear un conjunto de reglas personalizadas para un proyecto de equipo, primero cree una carpeta especial para el conjunto de reglas de directivas de protección en el Explorador de control de código fuente. A continuación, cree el archivo del conjunto de reglas y agréguelo al control de versiones. Finalmente, especifique el conjunto de reglas como la directiva de protección de análisis de código del proyecto de equipo.
Nota
Para crear una carpeta en un proyecto de equipo, debe asignar la raíz del proyecto de equipo a una ubicación del equipo local. Para obtener más información, vea Crear y trabajar con áreas de trabajo.
Para crear la carpeta de control de versiones para el conjunto de reglas de directivas de protección
En Team Explorer, expanda el nodo del proyecto de equipo y, a continuación, haga clic en Control de código fuente.
En el recuadro Carpetas, haga clic con el botón secundario en el proyecto de equipo y seleccione Nueva carpeta.
En el recuadro principal Control de código fuente, haga clic con el botón secundario en Nueva carpeta, haga clic en Cambiar nombre y escriba un nombre para la carpeta del conjunto de reglas.
Para crear el conjunto de reglas de directivas de protección
En el menú Archivo, elija Nuevo y, a continuación, haga clic en Archivo.
En la lista Categorías, haga clic en General.
En la lista Plantillas, haga doble clic en Conjunto de reglas de análisis de código.
Especifique las reglas que desea incluir en el conjunto de reglas y, a continuación, guarde el archivo del conjunto de reglas en la carpeta del conjunto de reglas que ha creado.
Para obtener más información, vea Crear conjuntos de reglas de análisis de código personalizadas
Para agregar el archivo del conjunto de reglas al control de versiones
En el Explorador de control de código fuente, haga clic con el botón secundario en la nueva carpeta y, a continuación, haga clic en Agregar elementos a carpeta.
Para obtener más información, vea Uso del control de versiones.
Haga clic en el archivo del conjunto de reglas que ha creado y, a continuación, en Finalizar.
El archivo se agrega al control de código fuente y se desprotege para usted.
En la ventana de detalles Explorador de control de código fuente, haga clic con el botón secundario en el nombre de archivo y, a continuación, haga clic en Proteger cambios pendientes.
En el cuadro de diálogo Proteger, tiene la opción de agregar un comentario. A continuación, haga clic en Proteger.
Nota
Si ya ha configurado una directiva de protección de análisis de código para su proyecto de equipo y ha seleccionado Exigir sólo la protección de archivos que formen parte de la solución actual, desencadenará una advertencia de error de directiva. En el cuadro de diálogo Error en la directiva, seleccione Invalidar el error de la directiva y continuar la protección. Agregue un comentario obligatorio y haga clic en Aceptar.
Para especificar el archivo del conjunto de reglas como directiva de protección
En el menú Equipo, elija Configuración del proyecto de equipo y, a continuación, haga clic en Control de código fuente.
Haga clic en Directiva de protección y, a continuación, en Agregar.
En la lista Directiva de protección, haga doble clic en Análisis de código y asegúrese de que la casilla Exigir análisis de código para código administrado esté activada.
En la lista Ejecutar este conjunto de reglas, haga clic en <Seleccionar conjunto de reglas en el control de código fuente>.
Escriba la ruta de acceso del archivo del conjunto de reglas de directivas de protección en el control de versiones.
La ruta de acceso debe tener la sintaxis siguiente:
**$/TeamProjectName/**VersionControlPath
Nota
Puede copiar la ruta de acceso mediante uno de los siguientes procedimientos en el Explorador de control de código fuente:
En el recuadro Carpetas, haga clic en la carpeta que contiene el archivo del conjunto de reglas. Copie la ruta de acceso del control de versiones de la carpeta que aparece en el cuadro Código fuente y escriba el nombre del archivo del conjunto de reglas manualmente.
En la ventana de detalles, haga clic con el botón secundario en el archivo del conjunto de reglas y, a continuación, haga clic en Propiedades. En la pestaña General, copie el valor en Nombre del servidor.
Sincronizar los proyectos de código con el conjunto de reglas de directivas de protección
En el cuadro de diálogo de propiedades del proyecto de código se especifica un conjunto de reglas de directivas de protección de proyecto de equipo como configuración de proyecto de código. Si el conjunto de reglas se encuentra en la misma unidad que el proyecto de código, se utiliza una ruta de acceso relativa para especificar el conjunto de reglas cuando se selecciona la ruta de acceso desde el cuadro de diálogo Archivo. La ruta de acceso relativa permite pasar la configuración de propiedades del proyecto a otros equipos que utilizan estructuras de control de versiones locales similares.
Para especificar un conjunto de reglas de proyecto de equipo como el conjunto de reglas de un proyecto de código
Si fuera necesario, recupere la carpeta y el archivo del conjunto de reglas de directivas de protección del control de versiones.
Puede realizar este paso en el Explorador de control de código fuente si hace clic con el botón secundario en la carpeta del conjunto de reglas y hace clic en Obtener la última versión.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en el proyecto de código y, a continuación, haga clic en Propiedades.
Haga clic en Análisis de código.
Si fuera necesario, haga clic en las opciones adecuadas de las listas Configuración y Plataforma.
Para ejecutar el análisis de código cada vez que se compila el proyecto de código con la configuración especificada, active la casilla Habilitar análisis de código al compilar (define la constante CODE_ANALYSIS).
Para omitir el código en componentes de otras empresas, active la casilla Suprimir resultados del código generado.
En la lista Ejecutar este conjunto de reglas, haga clic en <Examinar...>.
Especifique la versión local del archivo del conjunto de reglas de directivas de protección.