Establecer configuraciones Debug y Release en Visual Studio

  • Artículo

Los proyectos de Visual Studio tienen configuraciones independientes para el lanzamiento y la depuración del programa. La versión de depuración se compila para depurar y la versión de lanzamiento para la distribución final.

En la configuración de depuración, el programa se compila sin optimizar y con toda la información de depuración simbólica. La optimización complica la depuración, ya que la relación entre el código fuente y las instrucciones generadas es más compleja.

La configuración de versión del programa no contiene información de depuración simbólica y está totalmente optimizada. Para código administrado y de C++, la información de depuración se puede generar en archivos .pdb, en función de las opciones del compilador que se usen. La creación de archivos .pdb puede ser útil si más tarde tiene que depurar la versión de lanzamiento.

Para más información sobre las configuraciones de compilación, vea Descripción de las configuraciones de compilación.

La configuración de compilación se puede modificar desde el menú Compilar, la barra de herramientas o las páginas de propiedades del proyecto. Las páginas de propiedades del proyecto son específicas de un lenguaje. El procedimiento que se indica a continuación muestra cómo cambiar la configuración de compilación desde el menú y la barra de herramientas. Para obtener más información sobre cómo cambiar la configuración de compilación de proyectos en distintos lenguajes, consulte la sección Contenido relacionado que aparece más adelante.

Cambio de la configuración de compilación

Para cambiar la configuración de compilación:

  • En la barra de herramientas, elija Depurar o Versión en el cuadro de lista Configuraciones de soluciones.

    toolbars build configuration

    o

  • En el menú Compilar, seleccione Administrador de configuración y después Depurar o Versión.

Generación de archivos de símbolos (.pdb) para una compilación (C#, C++, Visual Basic, F#)

Puede optar por generar archivos de símbolos (.pdb) y la información de depuración que se va a incluir. Para la mayoría de los tipos de proyecto, el compilador genera archivos de símbolos de forma predeterminada para las compilaciones de depuración y versión, mientras que otros valores predeterminados varían según el tipo de proyecto y la versión de Visual Studio.

Importante

El depurador solo cargará un archivo .pdb de un archivo ejecutable que coincida exactamente con el archivo .pdb creado cuando se compiló el archivo ejecutable (es decir, el archivo .pdb debe ser el original o una copia del archivo .pdb original). Para obtener más información, vea ¿Por qué Visual Studio requiere que los archivos de símbolos del depurador coincidan exactamente con los archivos binarios con los que se han creado?.

Cada tipo de proyecto puede tener una manera distinta de establecer estas opciones.

Generación de archivos de símbolos para un proyecto de C# o ASP.NET Core (solo .NET Core y .NET 5 y versiones posteriores)

Para obtener información detallada sobre la configuración del proyecto para las configuraciones de depuración en C#, vea Configuración del proyecto para una configuración de depuración de C#. (En el caso de los proyectos de .NET de Visual Basic, los archivos de símbolos se configuran igual que en .NET Framework).

  1. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y, luego, elija Propiedades.

  2. En el panel lateral, elija Compilación>General.

  3. En la sección Optimizar código elija Debug o Release.

  4. En la lista Símbolos de depuración, elija Archivo PDB, plataforma actual, Archivo PBD, portable o Incrustado.

    El formato portátil es el formato multiplataforma más reciente para .NET Core. Para obtener más información sobre las opciones, vea Cuadro de diálogo Configuración de compilación avanzada (C#).

    Generate PDBs for builds in .NET

  5. Compilar el proyecto.

    El compilador crea los archivos de símbolos en la misma carpeta que el ejecutable o el archivo de salida principal.

Generación de archivos de símbolos para un proyecto de C#, ASP.NET o Visual Basic (.NET Framework)

Para obtener más información sobre la configuración del proyecto para configuraciones de depuración en C# o Visual Basic, vea Configuración del proyecto para una configuración de depuración de C# o Configuración del proyecto para una configuración de depuración de Visual Basic.

  1. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y, luego, elija Propiedades.

  2. En el panel lateral, elija Compilar (o Compilar en Visual Basic).

  3. En la lista Configuración de la parte superior, elija Debug o Release.

  4. Seleccione el botón Avanzado (o el botón Opciones de compilación avanzadas de Visual Basic).

  5. En la lista Información de depuración (o la lista Generar información de depuración de Visual Basic), elija Completa, Solo PDB o Portátil.

    El formato portátil es el formato multiplataforma más reciente para .NET Core. Para obtener más información sobre las opciones, vea Cuadro de diálogo Configuración de compilación avanzada (C#).

    Generate PDBs for builds in C#

  6. Compilar el proyecto.

    El compilador crea los archivos de símbolos en la misma carpeta que el ejecutable o el archivo de salida principal.

Generación de archivos de símbolos para un proyecto de C++

  1. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y, luego, elija Propiedades.

  2. En la lista Configuración, elija Depurar o Versión.

  3. En el panel lateral, elija Enlazador > Depuración y, después, seleccione opciones para Generar información de depuración.

    En la mayoría de los proyectos de C++, el valor predeterminado es Generar información de depuración (/DEBUG) .

    Para obtener información detallada sobre la configuración del proyecto para las configuraciones de depuración en C++, vea Configuración del proyecto para una configuración de depuración de C++.

  4. Configure las opciones de Generar archivos de base de datos de programa.

    En la mayoría de los proyectos de C++, el valor predeterminado es $(OutDir)$(TargetName).pdb, que genera archivos .pdb en la carpeta de salida.

    Generate PDBs for builds in C++

  5. Compilar el proyecto.

    El compilador crea los archivos de símbolos en la misma carpeta que el ejecutable o el archivo de salida principal.

Contenido relacionado