Definir configurações de depuração e versão no Visual StudioSet debug and release configurations in Visual Studio

Os projetos do Visual Studio têm configurações separadas de versão e depuração para seu programa.Visual Studio projects have separate release and debug configurations for your program. Você cria a versão de depuração para depuração e a versão de lançamento para a distribuição de versão final.You build the debug version for debugging and the release version for the final release distribution.

Em configuração de depuração, seu programa compila com informações de depuração simbólicas completas e sem otimização.In debug configuration, your program compiles with full symbolic debug information and no optimization. A otimização complica a depuração, porque a relação entre o código fonte e as instruções geradas é mais complexa.Optimization complicates debugging, because the relationship between source code and generated instructions is more complex.

A configuração de versão do programa não tem informações de depuração simbólicas e é totalmente otimizada.The release configuration of your program has no symbolic debug information and is fully optimized. Para código gerenciado e C++ código, as informações de depuração podem ser geradas em arquivos. pdb, dependendo das opções de compilador usadas.For managed code and C++ code, debug information can be generated in .pdb files, depending on the compiler options that are used. A criação de arquivos. pdb pode ser útil se você precisar depurar a versão de lançamento posteriormente.Creating .pdb files can be useful if you later have to debug your release version.

Para obter mais informações sobre configurações de build, consulte Noções básicas sobre configurações de build.For more information about build configurations, see Understand build configurations.

Você pode alterar a configuração de Build no menu Compilar , na barra de ferramentas ou nas páginas de propriedades do projeto.You can change the build configuration from the Build menu, from the toolbar, or in the project's property pages. As páginas de propriedades do projeto são específicas do idioma.Project property pages are language-specific. O procedimento a seguir mostra como alterar a configuração de Build no menu e na barra de ferramentas.The procedure below shows how to change the build configuration from the menu and the toolbar. Para obter mais informações sobre como alterar a configuração de compilação em projetos em idiomas diferentes, consulte a seção Consulte também abaixo.For more information about how to change the build configuration in projects in different languages, see the See also section below.

Alterar a configuração da compilaçãoChange the build configuration

Para alterar a configuração da compilação, seja:To change the build configuration, either:

  • No menu Compilar , selecione Configuration Managere, em seguida, selecione depurar ou liberar.From the Build menu, select Configuration Manager, then select Debug or Release.

ouor

  • Na barra de ferramentas, escolha depurar ou liberar na lista de configurações da solução .On the toolbar, choose either Debug or Release from the Solution Configurations list.

    configuração da compilação de barras de ferramentastoolbars build configuration

Gerar arquivos de símbolo (. pdb) para uma compilaçãoC#( C++,, Visual Basic F#,)Generate symbol (.pdb) files for a build (C#, C++, Visual Basic, F#)

Você pode optar por gerar arquivos de símbolo (. pdb) e quais informações de depuração incluir.You can choose to generate symbol (.pdb) files and what debug information to include. Para a maioria dos tipos de projeto, o compilador gera arquivos de símbolo por padrão para compilações de depuração e versão, enquanto outras configurações padrão diferem por tipo de projeto e versão do Visual Studio.For most project types, the compiler generates symbol files by default for debug and release builds, while other default settings differ by project type and Visual Studio version.

Important

O depurador carregará apenas um arquivo .pdb para um arquivo executável que corresponde exatamente ao arquivo .pdb criado quando o executável foi compilado (isto é, o .pdb deve ser o original ou uma cópia do arquivo .pdb original).The debugger will load only a .pdb file for an executable file that exactly matches the .pdb file that was created when the executable was built (that is, the .pdb must be the original or a copy of the original .pdb file). Para obter mais informações, consulte por que o Visual Studio exige arquivos de símbolo do depurador para corresponder exatamente aos arquivos binários com os quais eles foram criados?.For more information, see Why does Visual Studio require debugger symbol files to exactly match the binary files that they were built with?.

Cada tipo de projeto pode ter uma maneira diferente de definir essas opções.Each project type may have a different way of setting these options.

Gerar arquivos de símbolo para C#um projeto do, ASP.NET ou Visual BasicGenerate symbol files for a C#, ASP.NET, or Visual Basic project

Para obter informações detalhadas sobre as configurações do projeto para C# configurações de depuração no ou Visual Basic, consulte configurações de projeto para uma C# configuração de depuração ou configurações de projeto para uma configuração de depuração de Visual Basic.For detailed information on project settings for debug configurations in C# or Visual Basic, see Project settings for a C# debug configuration or Project settings for a Visual Basic debug configuration.

  1. No Gerenciador de Soluções, selecione o projeto.In Solution Explorer, select the project.

  2. Selecione o ícone de Propriedades (ou pressione ALT + Enter).Select the Properties icon (or press Alt+Enter).

  3. No painel lateral, escolha Compilar (ou Compilar em Visual Basic).In the side pane, choose Build (or Compile in Visual Basic).

  4. Na lista configuração , escolha depurar ou liberar.In the Configuration list, choose Debug or Release.

  5. Selecione o botão avançado (ou o botão Opções avançadas de compilação em Visual Basic).Select the Advanced button (or the Advanced Compile Options button in Visual Basic).

  6. Na lista informações de depuração (ou na lista gerar informações de depuração no Visual Basic), escolha completo, somente PDBou portátil.In the Debugging information list (or the Generate debug info list in Visual Basic), choose Full, Pdb-only, or Portable.

    O formato portátil é o formato de plataforma cruzada mais recente para o .NET Core.The portable format is the most recent cross-platform format for .NET Core. Para obter mais informações sobre opções, consulte caixa de diálogo Configurações avançadasC#de compilação ().For more information on options, see Advanced Build Settings dialog box (C#).

    Gerar PDBs para Builds C# emGenerate PDBs for builds in C#

  7. Criar o projeto.Build your project.

    O compilador cria os arquivos de símbolo na mesma pasta que o executável ou o arquivo de saída principal.The compiler creates the symbol file(s) in the same folder as the executable or the main output file.

Gerar arquivos de símbolo para C++ um projetoGenerate symbol files for a C++ project

  1. No Gerenciador de Soluções, selecione o projeto.In Solution Explorer, select the project.

  2. Selecione o ícone de Propriedades (ou pressione ALT + Enter).Select the Properties icon (or press Alt+Enter).

  3. Na lista configuração , escolha depurar ou liberar.In the Configuration list, choose Debug or Release.

  4. No painel lateral, escolha vinculador > depuraçãoe, em seguida, selecione opções para gerar informações de depuração.In the side pane, choose Linker > Debugging, then select options for Generate Debug Info.

    Para obter informações detalhadas sobre as configurações do projeto para C++configurações de depuração no, consulte configurações de projeto para C++ uma configuração de depuração.For detailed information on project settings for debug configurations in C++, see Project settings for a C++ debug configuration.

  5. Configurar opções para gerar arquivos de banco de dados do programa.Configure options for Generate Program Database Files.

    Na maioria C++ dos projetos, o valor padrão $(OutDir)$(TargetName).pdbé, que gera arquivos. pdb na pasta de saída.In most C++ projects, the default value is $(OutDir)$(TargetName).pdb, which generates .pdb files in the output folder.

    Gerar PDBs para Builds C++ emGenerate PDBs for builds in C++

  6. Criar o projeto.Build your project.

    O compilador cria os arquivos de símbolo na mesma pasta que o executável ou o arquivo de saída principal.The compiler creates the symbol file(s) in the same folder as the executable or the main output file.

Confira tambémSee also