Compartir a través de

Pruebas unitarias de aplicaciones C++ existentes con el Explorador de pruebas

  • Artículo

Se recomienda que, antes de cambiar una aplicación existente, se asegure de que tiene buena cobertura con pruebas unitarias.Así podrá confiar en que los cambios no han introducido errores.Si la aplicación todavía no tiene pruebas unitarias, se pueden agregar mediante las técnicas que se muestran en este tema.En este tema se describe cómo agregar pruebas unitarias para código Visual C++ existente, comenzando por decidir cómo probar el código y cómo crear, escribir y, por último, ejecutar las pruebas.

La decisión sobre cómo probar el código

Abra el proyecto existente de C++ e inspecciónelo para decidir cómo desea agregar las pruebas unitarias.Quizá desee utilizar herramientas de modelado, que ayudan a ver las dependencias del código y ayudan a entender cómo interactúan las partes.Para obtener más información, consulta Visualizar el código.

Se recomienda separar los cambios en pequeñas tareas.Antes de cada pequeño cambio, escriba pruebas unitarias para los aspectos del comportamiento que permanezcan invariables.Estas pruebas seguirán completándose correctamente después de realizar el cambio.Por ejemplo, si planea cambiar una función de ordenación de modo que ordene una lista de personas por apellido en lugar de por nombre, puede escribir una prueba unitaria que compruebe que todos los nombres de entrada aparecen en la salida.Después de realizar el cambio, se pueden agregar nuevas pruebas unitarias para el nuevo comportamiento.

Si resulta práctico, muchas de las pruebas unitarias o todas ellas deben utilizar solo las funciones que se exportan.No obstante, si se cambia solo una pequeña parte de toda la aplicación, quizá desee utilizar funciones que no se exporten.Por ejemplo, quizás desee que las pruebas invoquen funciones internas o pruebas que establezcan y obtengan los valores de variables internas.

Hay varias maneras de probar el código del producto, según si expone las interfaces que desea probar.Elija una de las siguientes formas:

  • Las pruebas unitarias utilizarán solo las funciones que se exportan del código en pruebas:
    Agregue un proyecto de prueba independiente.En el proyecto de prueba, agregue una referencia al proyecto en pruebas.
Vaya al procedimiento Para hacer referencia a funciones exportadas desde el proyecto de prueba.

  • El código en pruebas se compila como un archivo .exe:
    Agregue un proyecto de prueba independiente.Vincúlelo al archivo objeto de salida.

    Vaya al procedimiento Para vincular las pruebas a los archivos de biblioteca u objeto.

  • Las pruebas unitarias deben utilizar funciones y datos privados y el código en pruebas puede compilarse como una biblioteca estática:
    Cambie el proyecto en pruebas para compilarlo como un archivo .lib.Agregue un proyecto de prueba independiente que haga referencia al proyecto en pruebas.

    Este enfoque tiene la ventaja de permitir que las pruebas utilicen miembros privados, pero sigue manteniendo las pruebas en un proyecto independiente.Sin embargo, puede no ser adecuado para algunas aplicaciones donde se debe tener una biblioteca de vínculos dinámicos (.dll).

    Vaya al procedimiento Para cambiar el código en pruebas a una biblioteca estática.

  • Las pruebas unitarias deben utilizar funciones y datos privados y el código debe compilarse como una biblioteca de vínculos dinámicos (DLL):
    Agregue las pruebas unitarias en el mismo proyecto que el código de producto.

    Vaya al procedimiento Para agregar pruebas unitarias en el mismo proyecto.

Crear las pruebas

Para cambiar el código en pruebas a una biblioteca estática

  • Si las pruebas deben utilizar miembros que no exporte un proyecto en pruebas y el proyecto en pruebas se compila como una biblioteca dinámica, considere convertirla en una biblioteca estática.

    1. En el Explorador de soluciones, en el acceso directo del proyecto en pruebas, elija Propiedades.Se abrirá la ventana de propiedades del proyecto.

    2. Elija Propiedades de configuración, General.

    3. Establezca Tipo de configuración en Biblioteca estática (.lib).

Continúe con el procedimiento Para vincular las pruebas a los archivos de biblioteca u objeto.

Para hacer referencia a funciones exportadas del proyecto de prueba

  • Si un proyecto en pruebas exporta funciones que desea probar, puede agregar una referencia al proyecto de código desde el proyecto de prueba.

    1. Cree un proyecto de prueba C++.

      • En la barra de menús, elija Archivo, Nuevo, Proyecto, Visual C++,Prueba, Proyecto de prueba unitaria C++.

    2. En el Explorador de soluciones, en el acceso directo del proyecto de prueba, elija Referencias.Se abrirá la ventana de propiedades del proyecto.

    3. Seleccione Propiedades comunes, Marco de trabajo y referencias y elija el botón Agregar nueva referencia.

    4. Seleccione Proyectos y, a continuación, el proyecto que se va a probar.

      Elija el botón de Agregar.

    5. En las propiedades del proyecto de prueba, agregue la ubicación del proyecto en pruebas a los directorios de archivos de inclusión.

      Elija Propiedades de configuración, Directorios de VC++, Directorios de archivos de inclusión.

      Elija Editar y agregue el directorio del encabezado del proyecto en pruebas.

Vaya a Escritura de las pruebas unitarias.

Para vincular las pruebas a los archivos biblioteca u objeto

  • Si el código en pruebas no exporta funciones que desea probar, puede agregar el archivo de salida .obj o .lib a las dependencias del proyecto de prueba.

    1. Cree un proyecto de prueba C++.

      • En la barra de menús, elija Archivo, Nuevo, Proyecto, Visual C++,Prueba, Proyecto de prueba unitaria C++.

    2. En el Explorador de soluciones, en el acceso directo del proyecto de prueba, elija Propiedades.Se abrirá la ventana de propiedades del proyecto.

    3. Elija Propiedades de configuración, Vinculador, Entrada, Dependencias adicionales.

      Elija Editar y agregue los nombres de los archivos .obj o .lib.No utilice nombres de ruta de acceso completa.

    4. Elija Propiedades de configuración, Vinculador, General, Directorios de bibliotecas adicionales.

      Elija Editar y agregue la ruta del directorio de los archivos .obj o .lib.La ruta de acceso está normalmente dentro de la carpeta de compilación del proyecto en pruebas.

    5. Elija Propiedades de configuración, Directorios de VC++, Directorios de archivos de inclusión.

      Elija Editar y agregue el directorio del encabezado del proyecto en pruebas.

Vaya a Escritura de las pruebas unitarias.

Para agregar pruebas unitarias en el mismo proyecto

  1. Modifique las propiedades del proyecto de código del producto para incluir los encabezados y los archivos de biblioteca que se requieren para pruebas unitarias.

    1. En el Explorador de soluciones, en el acceso directo del proyecto en pruebas, elija Propiedades.Se abrirá la ventana de propiedades del proyecto.

    2. Elija Propiedades de configuración, Directorios de VC++.

    3. Edite los directorios de inclusión y de biblioteca:

      Directorios de archivos de inclusión

      $(VCInstallDir)UnitTest\include;$(IncludePath)

      Directorios de archivos de bibliotecas

      $(VCInstallDir)UnitTest\lib;$(LibraryPath)

  2. Agregue el archivo de prueba unitaria de C++:

    • En el Explorador de soluciones, en el acceso directo del proyecto, elija Agregar, Nuevo elemento y elija Pruebas unitarias de C++.

Vaya a Escritura de las pruebas unitarias.

Escritura de las pruebas unitarias

  1. En cada archivo de código de prueba unitaria, agregue un fragmento #include para los encabezados de proyecto en pruebas.

  2. Agregue las clases y los métodos de prueba a los archivos de código de prueba unitaria.Por ejemplo:

    #include "stdafx.h"
#include "CppUnitTest.h"
#include "MyProjectUnderTest.h"
using namespace Microsoft::VisualStudio::CppUnitTestFramework;
namespace MyTest
{
  TEST_CLASS(MyTests)
  {
  public:
      TEST_METHOD(MyTestMethod)
      {
          Assert::AreEqual(MyProject::Multiply(2,3), 6);
      }
  };
}

Para obtener más información, consulta Pruebas unitarias de código nativo con el Explorador de pruebas.

Ejecutar las pruebas

  1. En el menú Ver, elija Otras ventanas, Explorador de pruebas.

  2. En el Explorador de pruebas, elija Ejecutar todas.

Para obtener más información, consulta Inicio rápido: Desarrollo basado en pruebas con el Explorador de pruebas.