Configurações do projeto para uma configuração de depuração do C++Project settings for a C++ debug configuration

Você pode alterar as configurações do projeto para uma configuração de depuração C ou C++ na caixa de diálogo páginas de propriedades , conforme discutido em como definir as configurações de depuração e versão.You can change the project settings for a C or C++ debug configuration in the Property Pages dialog box, as discussed in How to: Set debug and release configurations. As tabelas a seguir mostram como localizar configurações relacionadas ao depurador na caixa de diálogo Páginas de Propriedades.The following tables show where to find debugger-related settings in the Property Pages dialog box.

Observação

As configurações do projeto de depuração na categoria Propriedades/depuração de configuração são diferentes para aplicativos UWP e para componentes escritos em C++.The debug project settings in the Configuration Properties/Debugging category are different for UWP apps and for components that are written in C++. Consulte iniciar uma sessão de depuração (VB, C#, C++ e XAML).See Start a debug session (VB, C#, C++ and XAML).

Cada configuração de propriedade de depuração é automaticamente gravada e salva no arquivo "por usuário" (. vcxproj. User) para sua solução quando você salva sua solução.Each debug property setting is automatically written and saved to the "per-user" file (.vcxproj.user) for your solution when you save your solution.

Especifique qual depurador usar na caixa de listagem depurador para iniciar , conforme descrito na tabela a seguir.Specify which debugger to use in the Debugger to launch list box, as described in the following table. Sua escolha afetará as propriedades visíveis.Your choice will affect which properties are visible.

A pasta propriedades de configuração (categoria de depuração)Configuration Properties folder (Debugging category)

ConfiguraçãoSetting DescriçãoDescription
Depurador a ser inicializadoDebugger to launch Especifica o depurador para executar, com as seguintes opções:Specifies the debugger to run, with the following choices:

- Depurador Local do Windows- Local Windows Debugger
- Depurador Remoto do Windows- Remote Windows Debugger
- Depurador do Navegador da Web- Web Browser Debugger
- Depurador de Serviço Web- Web Service Debugger
Comando (Depurador Local do Windows)Command (Local Windows Debugger) Especifica o comando para iniciar o programa que você está depurando no computador local.Specifies the command for starting the program that you are debugging on the local computer.
Comando Remoto (Depurador Remoto do Windows)Remote Command (Remote Windows Debugger) O caminho para o .exe no computador remoto.The path for the .exe on the remote computer. Digite o caminho exatamente como você o digitaria no computador remoto.Enter the path just as you would enter it on the remote machine.
Argumentos de comando (depurador local do Windows)Command Arguments (Local Windows Debugger)

Argumentos de comando remoto (depurador remoto do Windows)Remote Command Arguments (Remote Windows Debugger)
– Especifica argumentos para o comando especificado anteriormente.- Specifies arguments for the command specified earlier.

Você pode usar os seguintes operadores de redirecionamento nesta caixa:You can use the following redirection operators in this box:

< file
Lê o stdin do arquivo.Reads stdin from file.

> file
Grava stdout no arquivo.Writes stdout to file.

>> file
Acrescenta o stdout ao arquivo.Appends stdout to file.

2> file2> file
Grava stderr no arquivo.Writes stderr to file.

2>> file2>> file
Acrescenta o stderr ao arquivo.Appends stderr to file.

2> &12> &1
Envia a saída de stderr (2) para a mesma localidade que o stdout (1).Sends stderr (2) output to same location as stdout (1).

1> &21> &2
Envia a saída de stdout (1) para a mesma localidade que o stderr (2).Sends stdout (1) output to same location as stderr (2).

Na maioria dos casos, esses operadores serão aplicáveis somente para aplicativos de console.In most cases, these operators are applicable only to console applications.
Diretório de trabalhoWorking Directory Especifica o diretório de trabalho do programa que está sendo depurado, relativo ao diretório do projeto onde o EXE está localizado.Specifies the working directory of the program being debugged, relative to the project directory where your EXE is located. Se você deixar isso em branco, o diretório de trabalho será o diretório do projeto.If you leave this blank, the working directory is the project directory. Para a depuração remota, o diretório do projeto está no servidor remoto.For remote debugging, the project directory is on the remote server.
Anexar (Depurador Local do Windows e Depurador Remoto do Windows)Attach (Local Windows Debugger and Remote Windows Debugger) Especifica se inicia ou anexa ao aplicativo.Specifies whether to start or attach to the application. A configuração padrão é Não.Default setting is No.
Nome do Servidor Remoto (Depurador Remoto do Windows)Remote Server Name (Remote Windows Debugger) Especifica o nome de um computador (diferente do seu) no qual você deseja depurar um aplicativo.Specifies the name of a computer (other than yours) on which you want to debug an application.

A macro de build RemoteMachine é definida com o valor desta propriedade; para obter mais informações, confira Macros para comandos e propriedades de compilação.The RemoteMachine Build macro is set to the value of this property; for more information, see Macros for build commands and properties.
Conexão (Depurador Remoto do Windows)Connection (Remote Windows Debugger) Permite que você alterne entre tipos de conexão padrão e sem autenticação para depuração remota.Allows you to switch between standard and no-authentication connection types for remote debugging. Especifique um nome do computador remoto na caixa de Nome do Servidor Remoto.Specify a remote computer name in the Remote Server Name box. Tipos de conexão incluem o seguinte:Connection types include the following:

- Remoto com autenticação do Windows- Remote with Windows Authentication
- Remoto Sem Autenticação- Remote with No Authentication

Observação Depuração remota sem a autenticação pode deixar o computador remoto vulnerável às violações de segurança.Note Remote debugging with No Authentication may leave the remote computer vulnerable to security violations. O modo de Autenticação do Windows é mais seguro.Windows Authentication mode is more secure.

Para obter mais informações, confira Configuração de depuração remota.For more information, see Remote debugging setup.
URL HTTP (depurador de serviço Web e depurador de navegador da Web)HTTP URL (Web Service Debugger and Web Browser Debugger) Especifica a URL no qual o projeto que você está depurar está localizado.Specifies the URL where the project you are debugging is located.
Tipo de DepuradorDebugger Type Especifica o tipo de depurador a ser usado: Somente Nativo, Somente Gerenciado, Somente GPU, Misto, Automático (padrão) ou Script.Specifies the type of debugger to be used: Native Only, Managed Only, GPU Only, Mixed, Auto (default), or Script.

- Apenas Nativo é para código C++ não gerenciado.- Native Only is for unmanaged C++ code.
- Gerenciado Somente é para código executado no Common Language Runtime (código gerenciado).- Managed Only is for code that runs under the common language runtime (managed code).
- Misto invoca depuradores para código gerenciado e não gerenciado.- Mixed invokes debuggers for both managed and unmanaged code.
- Automático determina o tipo do depurador com base no compilador e as informações de EXE.- Auto determines the debugger type based on compiler and EXE information.
- Script chama um depurador para scripts.- Script invokes a debugger for scripts.
- Somente GPU é para o código C++ AMP que é executado em um dispositivo GPU ou no rasterizador de referência de DirectX.- GPU Only is for C++ AMP code that runs on a GPU device or on the DirectX reference rasterizer. Consulte depuração de código de GPU.See Debugging GPU code.
Ambiente (depurador local do Windows e depurador remoto do Windows)Environment (Local Windows Debugger and Remote Windows Debugger) Especifica variáveis de ambiente para o programa que você está depurando.Specifies environment variables for the program that you are debugging. Use a sintaxe da variável de ambiente padrão (por exemplo, PATH="%SystemRoot%\..." ).Use standard environment variable syntax (for example, PATH="%SystemRoot%\..."). Essas variáveis substituem o ambiente do sistema ou são mescladas com o ambiente do sistema, dependendo da configuração de Ambiente de Mesclagem.These variables override the system environment or are merged with the system environment, depending on the Merge Environment setting. Quando você clica com o botão esquerdo na coluna configurações, um "Editar..." é exibido.When you left-click in the settings column, an "Edit..." appears. Selecione esse link para editar variáveis de ambiente.Select that link to edit environment variables.
Ambiente de Mesclagem (Depurador Local do Windows)Merge Environment (Local Windows Debugger) Determina se as variáveis que são especificadas na caixa Ambiente serão mescladas com o ambiente definido pelo sistema operacional.Determines whether the variables that are specified in the Environment box will be merged with the environment that is defined by the operating system. A configuração padrão é Sim.Default setting is Yes.
Depuração de SQL (todos, com exceção do Depurador do Conjunto de MPI)SQL Debugging (all but MPI Cluster Debugger) Permite a depuração de procedimentos SQL do seu aplicativo Visual C++Visual C++.Enables debugging of SQL procedures from your Visual C++Visual C++ application. A configuração padrão é Não.Default setting is No.
Tipo de Acelerador de Depuração (somente depuração de GPU)Debugging Accelerator Type (GPU debugging only) Especifica o dispositivo GPU a ser usado para depuração.Specifies the GPU device to use for debugging. A instalação de drivers de dispositivo para dispositivos compatíveis com GPU adicionará outras opções.Installing device drivers for compatible GPU devices will add additional options. A configuração padrão é GPU – Emulador de Software.The default setting is GPU - Software Emulator.
Comportamento de ponto de interrupção padrão GPU (somente depuração de GPU)GPU Default Breakpoint Behavior (GPU debugging only) Especifica se um evento de ponto de interrupção deve ser gerado para cada thread em um warp SIMD.Specifies whether a breakpoint event should be raised for each thread in a SIMD warp. A configuração padrão é gerar o evento do ponto de interrupção apenas uma vez por encurvamento.The default setting is to raise the breakpoint event only once per warp.
Acelerador Padrão de AmpAmp Default Accelerator Especifica o acelerador padrão de AMP ao depurar o código de GPU.Specifies the default AMP accelerator when debugging GPU code. Escolha Acelerador de software WARP para investigar se um problema é causado por hardware ou por um driver em vez de por seu código.Choose WARP software accelerator to investigate if an issue is caused by the hardware or a driver instead of your code.
Diretório de Implantação (Depurador Remoto do Windows)Deployment Directory (Remote Windows Debugger) Especifica o caminho no computador remoto onde a saída do projeto será copiada antes da inicialização.Specifies the path on the remote computer where the project output will be copied prior to launch. O caminho pode ser um compartilhamento de rede no computador remoto, ou pode ser um caminho para uma pasta no computador remoto.The path can be a network share on the remote computer, or it can be a path to a folder on the remote computer. A configuração padrão está vazia, o que significa que a saída do projeto não é copiada para um compartilhamento de rede.The default setting is empty, which means the project output is not copied to a network share. Para habilitar a implantação de arquivos, você também deve marcar a caixa de seleção Implantar na caixa de diálogo Configuration Manager.To enable deployment of the files, you must also select the Deploy check box in the Configuration Manager dialog box. Para obter mais informações, consulte como: criar e editar configurações.For more information, see How to: Create and edit configurations.
Arquivos adicionais para implantar (depurador remoto do Windows)Additional Files to Deploy (Remote Windows Debugger) Se a propriedade do diretório de implantação for definida, essa será uma lista delimitada por ponto-e-vírgula de arquivos adicionais a serem copiados para o diretório de implantação.If the Deployment Directory property is set, this is a semicolon-delimited list of additional files to copy to the deployment directory. A configuração padrão está vazia, o que significa que nenhum arquivo adicional é copiado para o diretório de implantação.The default setting is empty, which means that no additional files are copied to the deployment directory. Para habilitar a implantação de arquivos, você também deve marcar a caixa de seleção Implantar na caixa de diálogo Configuration Manager.To enable deployment of the files, you must also select the Deploy check box in the Configuration Manager dialog box. Para obter mais informações, consulte como: criar e editar configurações.For more information, see How to: Create and edit configurations.
Implantar Bibliotecas de Runtime de Depuração do Visual C++ (Depurador Remoto do Windows)Deploy Visual C++ Debug Runtime Libraries (Remote Windows Debugger) Se a propriedade do diretório de implantação estiver definida, isso especifica se as bibliotecas em runtime de depuração do Visual C++ da plataforma atual devem ser copiadas para o compartilhamento de rede.If the Deployment Directory property is set, this specifies whether the Visual C++ debug runtime libraries for the current platform should be copied to the network share. A configuração padrão é Sim.The default setting is Yes.

Pasta C/C++ (Categoria geral)C/C++ folder (General category)

ConfiguraçãoSetting DescriçãoDescription
Formato de Informação de Depuração (/Z7, /Zd, Zi, /ZI)Debug Information Format (/Z7, /Zd, Zi, /ZI) Especifica o tipo de informação de depuração a ser criada para o projeto.Specifies the type of debug information to be created for the project.

A opção padrão (/ZI) cria um banco de dados (PDB) do programa no formato Editar e Continuar compatível.The default option (/ZI) creates a program database (PDB) in Edit and Continue compatible format. Para obter mais informações, confira /Z7, /Zd, /Zi, /ZI (formato de informação de depuração).For more information, see /Z7, /Zd, /Zi, /ZI (Debug information format).

Pasta C/C++ (Categoria de otimização)C/C++ folder (Optimization category)

ConfiguraçãoSetting DescriçãoDescription
OtimizaçãoOptimization Especifica se o compilador deve otimizar o código que produz.Specifies whether the compiler should optimize the code it produces. A otimização altera o código que é executado.Optimization changes the code that is executed. O código otimizado não corresponde mais ao código-fonte, o que torna a depuração mais difícil.Optimized code no longer matches the source code, which makes debugging more difficult.

A opção padrão (Desabilitado (/0d)) suprime a otimização.The default option (Disabled (/0d)) suppresses optimization. Você pode desenvolver com a otimização suprimida e, em seguida, habilitá-la quando você criar a versão de produção do seu código.You can develop with optimization suppressed, and then turn it on when you create the production version of your code.

Pasta do vinculador (categoria de depuração)Linker folder (Debugging category)

ConfiguraçãoSetting DescriçãoDescription
Gerar informações de depuração (/DEBUG)Generate Debug Info (/DEBUG) Informe ao vinculador para incluir informações de depuração, que terá o formato especificado por /Z7, por /Zd, por Zi ou por /ZI.Tells the linker to include debug information, which will have the format specified by /Z7, /Zd, Zi, or /ZI.
Gerar arquivo de banco de dados de programa (/PDB:name)Generate Program Database File (/PDB:name) Especifique o nome de um arquivo de banco de dados de programa (PDB) nesta caixa.Specify the name of a program database (PDB) file in this box. Você deve selecionar ZI ou /Zi para obter o formato de informações de depuração.You must select ZI or /Zi for Debug Information Format.
Segmentar Símbolos Privados (/PDBSTRIPPED:filename)Strip Private Symbols (/PDBSTRIPPED:filename) Especifique o nome de um arquivo de PDB nesta caixa, caso não queira incluir símbolos particulares no arquivo de PDB.Specify the name of a PDB file in this box if you do not want to include private symbols in the PDB file. Essa opção cria um segundo arquivo PDB quando você cria a imagem do programa com qualquer um dos compiladores ou opções do vinculador que geram um arquivo PDB, como/DEBUG,/Z7,/ZD.This option creates a second PDB file when you build your program image with any of the compiler or linker options that generate a PDB file, such as /DEBUG, /Z7, /Zd. Ou /Zi.Or /Zi. Este segundo arquivo PDB omite os símbolos que você não desejaria enviar aos seus clientes.This second PDB file omits symbols that you would not want to ship to your customers. Para obter mais informações, confira /PDBSTRIPPED (Remover símbolos privados).For more information, see /PDBSTRIPPED (Strip private symbols).
Gerar arquivo de mapa (/MAP)Generate Map File (/MAP) Informe ao vinculador para gerar um arquivo de mapa durante a vinculação.Tells the linker to generate a map file during linking. A configuração padrão é Não.Default setting is No. Para obter mais informações, consulte /MAP (gerar mapa).For more information, see /MAP (Generate Mapfile).
Nome do arquivo de mapa (/map:Name)Map File Name (/MAP:name) Se você escolher Gerar Arquivo de Mapa, poderá especificar o arquivo de mapa nesta caixa.If you choose Generate Map File, you can specify the map file in this box. Para obter mais informações, consulte /MAP (gerar mapa).For more information, see /MAP (Generate Mapfile).
Exportações de Mapa (/MAPINFO:EXPORTS)Map Exports (/MAPINFO:EXPORTS) Inclui funções exportadas no arquivo de mapa.Includes exported functions in the map file. A configuração padrão é Não.Default setting is No. Para obter mais informações, consulte /MAPINFO (incluir informações em mapa).For more information, see /MAPINFO (Include Information in Mapfile).
Assembly Depurável (/ASSEMBLYDEBUG)Debuggable Assembly (/ASSEMBLYDEBUG) Especifica configurações para a opção de /ASSEMBLYDEBUG de vinculador.Specifies settings for the Linker /ASSEMBLYDEBUG option. Os valores possíveis são:Possible values are:

- Nenhum atributo depurável emitido.- No debuggable attribute emitted.
- Acompanhamento de runtime e desabilitação de otimizações (/ASSEMBLYDEBUG).- Runtime tracking and disable optimizations (/ASSEMBLYDEBUG). Essa é a configuração padrão,This is the default setting,
- Nenhum acompanhamento em runtime e otimizações habilitadas (/ASSEMBLYDEBUG:DISABLE).- No runtime tracking and enable optimizations(/ASSEMBLYDEBUG:DISABLE).
- <inherit from parent or project defaults>.- <inherit from parent or project defaults>.
– Para obter mais informações, confira /ASSEMBLYDEBUG (Adicionar DebuggableAttribute).- For more information, see /ASSEMBLYDEBUG (Add DebuggableAttribute).

Você pode alterar essas configurações na pasta Propriedades de Configuração (categoria Depuração) programaticamente usando a interface Microsoft.VisualStudio.VCProjectEngine.VCDebugSettings.You can change these settings in the Configuration Properties folder (Debug category) programmatically by using the Microsoft.VisualStudio.VCProjectEngine.VCDebugSettings interface. Para obter mais informações, consulte VCDebugSettings.For more information, see VCDebugSettings.

Outras configurações de projetoOther project settings

Para depurar tipos de projeto como bibliotecas e DLLs estáticas, seu projeto do Visual Studio deve ser capaz de encontrar os arquivos corretos.To debug project types such as static libraries and DLLs, your Visual Studio project must be able to find the correct files. Quando o código-fonte estiver disponível, você poderá adicionar bibliotecas e DLLs estáticas como projetos separados à mesma solução, para facilitar a depuração.When source code is available, you can add static libraries and DLLs as separate projects to the same solution, to make debugging easier. Para obter informações sobre como criar esses tipos de projeto, consulte criando e usando uma dll (biblioteca de vínculo dinâmico) e criando um usando uma biblioteca estática.For information on creating these project types, see Creating and using a Dynamic Link Library (DLL) and Creating a using a static library. Com o código-fonte disponível, você também pode criar um novo projeto do Visual Studio escolhendo arquivo > novo > projeto a partir do código existente.With source code available, you can also create a new Visual Studio project by choosing File > New > Project From Existing Code.

Para depurar DLLs que são externas ao seu projeto, consulte Depurando projetos de dll.To debug DLLs that are external to your project, see Debugging DLL projects. Se você precisar depurar seu próprio projeto de DLL, mas não tiver acesso ao projeto para o aplicativo de chamada, consulte como depurar de um projeto de dll.If you need to debug your own DLL project, but don't have access to the project for the calling application, see How to debug from a DLL project.

Confira tambémSee also