Crear o actualizar directivas de protección de análisis de código estándar

Puede requerir que el análisis de código se ejecute en todos los proyectos de código de un proyecto de Azure DevOps mediante la directiva de comprobación de análisis de código. Requerir análisis de código puede mejorar la calidad del código que se comprueba en la base de código.

Nota

Esta característica solo está disponible si usa Team Foundation Server.

Las directivas de comprobación de análisis de código se establecen en la configuración del proyecto y se aplican a cada proyecto de código. Las ejecuciones de análisis de código se configuran para proyectos de código en el archivo de proyecto (.xxproj) para el proyecto de código. Las ejecuciones de análisis de código se realizan en el equipo local. Al habilitar una directiva de inserción en el repositorio de análisis de código, los archivos de un proyecto de código que se van a insertar en el repositorio se deben compilar después de su última edición y una ejecución de análisis de código que contenga, como mínimo, las reglas de la configuración del proyecto deben realizarse en el equipo en el que se han realizado los cambios.

  • Para el código administrado, establezca la directiva de inserción en el repositorio especificando un conjunto de reglas que contenga un subconjunto de las reglas de análisis de código.

  • Para el código de C/C++, en Visual Studio 2017 versión 15.6 y versiones anteriores, la directiva de inserción en el repositorio requiere que se ejecuten todas las reglas de análisis de código. Puede agregar directivas de preprocesador para deshabilitar reglas específicas para los proyectos de código individuales en el proyecto de Azure DevOps. En la versión 15.7 y posteriores, puede usar /analyze:ruleset para especificar qué reglas se van a ejecutar. Para obtener más información, vea Usar conjuntos de reglas para especificar las reglas de C++ que se van a ejecutar.

Después de especificar una directiva de inserción en el repositorio para código administrado, los miembros del equipo pueden sincronizar la configuración de análisis de código de los proyectos de código con la configuración de la directiva de proyecto de Azure DevOps.

Para abrir el editor de directivas de inserción en el repositorio

  1. En Team Explorer, haga clic con el botón derecho en el nombre del proyecto, seleccione Configuración del proyecto y, a continuación, haga clic en Control de código fuente.

  2. En el cuadro de diálogo Control de código fuente, seleccione la pestaña Directiva de protección.

  3. Realice una de las siguientes acciones:

    • Haga clic en Agregar para crear una nueva directiva de inserción en el repositorio.

    • Haga doble clic en el elemento Análisis de código existente en la lista Tipo de directiva para cambiar la directiva.

Para establecer las opciones de directiva

Seleccione o desactive las siguientes opciones:

Opción Descripción
Aplique la inserción en el repositorio para que solo contenga archivos que formen parte de la solución actual. El análisis de código solo se puede ejecutar en archivos especificados en archivos de configuración de soluciones y proyectos. Esta directiva garantiza que se analice todo el código que forma parte de una solución.
Exigir el análisis de código de C/C++ (/analyze) Requiere que todos los proyectos de C o C++ se compilen con la opción del compilador /analyze para ejecutar el análisis de código antes de que se puedan insertar en el repositorio.
Exigir análisis de código para código administrado Requiere que todos los proyectos administrados ejecuten el análisis de código y la compilación antes de que se puedan insertar en el repositorio.

Para especificar un conjunto de reglas administradas

En la lista Ejecutar este conjunto de reglas, use uno de los métodos siguientes:

  • Seleccione un conjunto de reglas estándar de Microsoft.

  • Seleccione un conjunto de reglas personalizado haciendo clic en <Seleccionar conjunto de reglas en Control de código fuente...>. A continuación, escriba la ruta de acceso del control de versiones del conjunto de reglas en el explorador de control de código fuente. La sintaxis de una ruta de acceso de control de versiones es:

    $/ TeamProjectName / VersionControlPath

Para obtener más información sobre cómo crear e implementar un conjunto de reglas de directiva de protección personalizado, consulte Implementación de directivas de protección personalizadas para código administrado.