Cómo: Obtener datos de cobertura de código

Artículo
10/07/2008

Actualización: noviembre 2007

La efectividad de las pruebas se puede medir línea por línea o incluso bloque por bloque. Para ello, las ejecuciones de prueba se configuran de modo que generen datos de cobertura de código. Los datos resultantes se muestran en la ventana Resultados de la cobertura de código y en los archivos de código fuente.

Se recopilan datos de cobertura de código cuando se han instrumentado artefactos, normalmente archivos binarios, y se cargan en memoria durante una ejecución de prueba. El procedimiento Obtener datos de cobertura de código describe cómo seleccionar un archivo para su instrumentación.

Nota:
De forma predeterminada, la cobertura de código se mide al ejecutar pruebas unitarias. Por tanto, cuando se ejecutan pruebas unitarias, es necesario seguir los pasos de Obtener datos de cobertura de código solo si se ha desactivado la cobertura de código o si se desea instrumentar más artefactos para recopilar datos de cobertura de código para ellos.

Una vez completada la ejecución de prueba, puede ver los datos de cobertura de código; para obtener más información, consulte Ver los datos de cobertura de código.

También puede combinar varios conjuntos de datos de cobertura de código, tal y como se describe en Cómo: Combinar datos de cobertura de código. Para obtener información acerca de varias circunstancias relacionadas con la combinación de datos de cobertura de código, vea Trabajar con combinación de datos de cobertura de código.

Tal y como se ha explicado en Instrumentar y volver a firmar ensamblados, los ensamblados con nombre seguro que se hayan instrumentado deberán volver a firmarse. Para permitir que se vuelva a firmar el ensamblado, tiene que especificar un archivo de claves. Para obtener más información, vea Volver a firmar ensamblados.

Cuando se ejecutan pruebas que no son unitarias, los artefactos deben instrumentarse explícitamente para obtener datos de cobertura de código. Por ejemplo, una herramienta de comprobación que ejecuta una prueba manual podría iniciar un programa determinado. Si se instrumentan los binarios del programa, se recopilarán datos de cobertura de código. Para obtener más información, consulte Información general sobre las pruebas manuales.

Obtener datos de cobertura de código

Para obtener datos de cobertura de código

Cree pruebas para el código. Pueden ser pruebas unitarias o de otro tipo, que utilicen código para el que se dispone de símbolos y para el que se hayan seleccionado los binarios apropiados para instrumentar.

Para obtener información acerca de cómo crear pruebas unitarias, vea Cómo: Generar una prueba unitaria.
Abra la configuración de la ejecución de prueba que se va a utilizar para las pruebas unitarias.

Para obtener más información, vea Cómo: Especificar la configuración de una ejecución de prueba.
Haga clic en Cobertura de código.

En Seleccionar artefactos para instrumento, seleccione el archivo DLL, el archivo ejecutable o el directorio de su solución. Por ejemplo, si su solución se denomina ClassLibrary1, active la casilla correspondiente al ensamblado denominado ClassLibrary1.dll cuya ruta de acceso es <Directorio de la solución>\ClassLibrary1\bin\Debug.

Nota:
También puede seleccionar el archivo DLL que contiene los archivos de proyecto de prueba. De este modo, se generan datos de cobertura de código para los métodos del proyecto de prueba, no solo para los métodos del código de producción.

Haga clic en Aplicar y, a continuación, haga clic en Cerrar.

Ejecute una o más pruebas.

Para obtener más información, vea Cómo: Ejecutar las pruebas seleccionadas.

Mientras se ejecutan las pruebas, se recopilan datos de cobertura de código. Para obtener información sobre cómo verlos, consulte Ver los datos de cobertura del código.

Nota:
La ejecución de VSPerfMon.exe puede interactuar con la recolección de datos de cobertura de código. Para obtener más información, vea la sección "Datos de cobertura de código y VSPerfMon.exe" en Solucionar problemas de Test Edition.

No pueden recopilarse datos de cobertura de código para una aplicación que se ejecuta en un proceso de 64 bits. Por lo tanto, cuando solicite datos de cobertura de código mientras prueba una aplicación de este tipo, el motor de pruebas establecerá el marcador "32BIT" en el encabezado del archivo ejecutable portable (PE) del ensamblado que se va a instrumentar. Una vez completada la ejecución de prueba, el ensamblado volverá a su estado original.

Volver a firmar ensamblados

Para volver a firmar ensamblados

Abra la configuración de la ejecución de prueba que se va a utilizar para las pruebas unitarias.

Para obtener más información, vea Cómo: Especificar la configuración de una ejecución de prueba.
Haga clic en Cobertura de código.
Haga clic en el botón de puntos suspensivos (…) situado junto al cuadro de texto Volviendo a firmar el archivo de claves.

Aparecerá el cuadro de diálogo Elegir un archivo de claves.
Seleccione un archivo de claves y haga clic en Abrir.
En el editor de configuración de ejecución de prueba, haga clic en Aplicar y, a continuación, haga clic en Cerrar.

Si está probando varios ensamblados que ya se han firmado, Visual Studio intentará volver a firmar todos los ensamblados con nombre seguro que se firmaron con el archivo de claves especificado. Para obtener más información, vea "Volver a firmar el ensamblado" en Instrumentar y volver a firmar ensamblados.

Ver los datos de cobertura de código

Requisito previo: haber ejecutado pruebas que hayan generado datos de cobertura de código, como se describe en Obtener datos de cobertura de código.

Para ver los datos de cobertura de código

En la barra de herramientas Resultados de pruebas, haga clic en Resultados de la cobertura de código. Otra posibilidad es hacer clic en Ventanas en el menú Prueba y, a continuación, en Resultados de la cobertura de código.

Se abrirá la ventana Resultados de la cobertura de código.

En la ventana Resultados de la cobertura de código, la columna Jerarquía muestra un nodo que contiene todos los datos de cobertura de código obtenidos en la última ejecución de prueba. Si se produjera un error, el mensaje de error se mostraría en esta ubicación, en lugar del nodo raíz. Si se muestra el nodo, expándalo.

Nota:
De forma predeterminada, se asigna un nombre a este nodo de ejecución de prueba utilizando el formato <nombre de usuario>@<nombre de equipo> <fecha> <hora>. Puede cambiar el esquema de nombre predeterminado en la página General del cuadro de diálogo Opciones. Para obtener más información, consulte Cómo: Especificar la configuración de una ejecución de prueba.

Expanda el nodo para el ensamblado, para el espacio de nombres y para una clase del código de producción.

Las filas de la clase representan sus métodos. Las columnas de la tabla muestran estadísticas de cobertura para métodos individuales, para clases y para el espacio de nombres completo.

Haga doble clic en la fila correspondiente a uno de los métodos de la clase.

El archivo de código fuente se abre por el método elegido. En este archivo, se puede ver código resaltado. Desplazándose, se puede ver la cobertura para los otros métodos de este archivo. Para cambiar los colores en los que se resaltan las líneas de código, vea Cambiar la presentación de los datos de cobertura de código.

Nota:
Con los botones de la barra de herramientas Herramientas de prueba, se puede cambiar la presentación de la cobertura de código en el archivo y navegar a las líneas de código anteriores o siguientes del archivo.

(Opcional) Si se activa la casilla correspondiente al archivo DLL del proyecto de prueba, se puede abrir el archivo de código fuente que contiene las pruebas unitarias para ver qué métodos de prueba se han utilizado.

Mostrar diferentes cálculos de cobertura de código

Los cálculos de cobertura de código muestran los totales de cobertura de código como columnas en la ventana Resultados de la cobertura de código. Se pueden habilitar un máximo de ocho columnas para mostrar los cálculos del código que han cubierto las ejecuciones de pruebas, así como del código que no se ha cubierto. Las columnas que muestran los cálculos se pueden habilitar como porcentajes o como un total numérico. También puede habilitar columnas que muestren los cálculos para las líneas de código y para los bloques de código.

Para mostrar u ocultar una columna de datos de cobertura de código

Haga clic con el botón secundario en cualquiera de los datos de la ventana Resultados de la cobertura de código.
Haga clic en Agregar o quitar columnas.
Active las casillas situadas junto a los elementos que desea mostrar y desactive las situadas junto a los elementos que desea quitar.
Haga clic en Aceptar.

Cambiar la presentación del resaltado de la cobertura de código

De forma predeterminada, se utilizan ciertos colores para indicar si las pruebas que se han ejecutado han cubierto el código. Las líneas resaltadas en azul claro se utilizaron en la ejecución de prueba y las líneas resaltadas en castaño rojizo no. En las líneas resaltadas en beige, parte del código se utilizó y parte no.

Para cambiar la presentación de los datos de cobertura de código

Haga clic en Herramientas y, a continuación, en Opciones.

Aparecerá el cuadro de diálogo Opciones.
Expanda Entorno.
Haga clic en Fuentes y colores.
En Mostrar valores para, seleccione Editor de texto.
En Mostrar elementos, seleccione el área de cobertura de código cuyo color de presentación desea cambiar. Las opciones son Área de cobertura no modificada, Área de cobertura modificada parcialmente y Área de cobertura modificada.
Cambie la configuración para esta área de cobertura de código. Puede cambiar los colores de primer plano y de fondo y la fuente, el tamaño de fuente y el grosor del texto.
(Opcional) Cambie la configuración para otras áreas de cobertura de código.
Cuando termine, haga clic en Aceptar.

Vea también