Compartilhar via


Definições do projeto para uma configuração de depuração do C++

Você pode alterar as configurações do projeto para uma configuração de depuração C ou Visual C++ na caixa de diálogo Páginas de Propriedades, conforme discutido em Como definir configurações de depuração e versão. As tabelas a seguir mostram onde localizar configurações relacionadas ao depurador na caixa de diálogo Páginas de Propriedades.

Aviso

As configurações de projeto de depuração na categoria de Propriedades de Configuração/Depuração para aplicativos do Windows Store e componentes que são escritos em C++ são diferentes.Consulte Iniciar uma sessão de depuração de um aplicativo da Store no Visual Studio (VB, C#, C++ e XAML) no Centro de Desenvolvimento do Windows.

Especifique qual depurador usar na caixa de listagem Depurador a iniciar. Sua escolha afetará as propriedades visíveis.

Cada configuração de propriedade de depuração é automaticamente gravada e salva no arquivo “por usuário” (.vcxproj.user) para sua solução sempre que você salve sua solução.

A pasta propriedades de configuração (categoria de depuração)

Configuração

Descrição

Depurador a iniciar

Especifica o depurador para executar, com as seguintes opções:

  • Depurador Local do Windows

  • Depurador Remoto do Windows

  • Depurador do navegador da Web

  • Depurador de serviço Web

Comando (Depurador Local do Windows)

Especifica o comando para iniciar o programa que você está depurando no computador local.

Comando Remoto (Depurador Remoto do Windows)

O caminho para o .exe no computador remoto. Digite o caminho exatamente como você o digitaria no computador remoto.

Argumentos do Comando (Depurador Local do Windows e Depurador Remoto do Windows)

  • Especifica argumentos para o comando especificado anteriormente.

Você pode usar os seguintes operadores de redirecionamento nesta caixa:

< file

Lê o stdin do arquivo.

> file

Grava stdout no arquivo.

>> file

Acrescenta o stdout ao arquivo.

2> file

Grava stderr no arquivo.

2>> file

Acrescenta o stderr ao arquivo.

2> &1

Envia a saída de stderr (2) para a mesma localidade que o stdout (1).

1> &2

Envia a saída de stdout (1) para a mesma localidade que o stderr (2).

Na maioria dos casos, esses operadores serão aplicáveis somente para aplicativos de console.

Diretório de trabalho

Especifica o diretório de trabalho do programa que está sendo depurado, relativo ao diretório do projeto onde o EXE está localizado. Se você deixar isso em branco, o diretório de trabalho será o diretório do projeto. A depuração remota, o diretório do projeto será no servidor remoto.

Anexar (Depurador Local do Windows e Depurador Remoto do Windows)

Especifica se inicia ou anexa ao aplicativo. A configuração padrão é Não.

Nome do Servidor Remoto (Depurador Remoto do Windows)

Especifica o nome de um computador (diferente do seu) no qual você deseja depurar um aplicativo.

A macro de compilação RemoteMachine é definida com o valor desta propriedade; para obter mais informações, consulte Macros para comandos e propriedades de compilação.

Conexão (Depurador Remoto do Windows)

Permite que você alterne entre tipos de conexão padrão e sem autenticação para depuração remota. Especifique um nome do computador remoto na caixa de Nome do Servidor Remoto. Tipos de conexão incluem o seguinte:

  • Remoto sem Autenticação do Windows

  • Remoto sem Autenticação (nativo somente)

Observação   Depuração remota sem a autenticação pode deixar o computador remoto vulnerável às violações de segurança. O modo de Autenticação do Windows é mais seguro.

Para obter mais informações, consulte Configuração de depuração remota.

URL HTTP (depurador de serviço Web e depurador de navegador da Web)

Especifica a URL no qual o projeto que você está depurar está localizado.

Tipo de Depurador

Especifica o tipo de depurador a ser usado: Apenas Nativo, Gerenciado Somente, Somente GPU, Misto, Automático (padrão) ou Script.

  • Apenas Nativo é para código C++ não gerenciado.

  • Gerenciado Somente é para código executado sob o common language runtime (código gerenciado).

  • Misto invoca depuradores para código gerenciado e não gerenciado.

  • Automático determina o tipo do depurador com base no compilador e as informações de EXE.

  • Script chama um depurador para scripts.

  • Somente GPU é para o código C++ AMP que é executado em um dispositivo GPU ou no rasterizador de referência de DirectX. Consulte Depurando código de GPU.

Ambiente (Depurador Local do Windows)

Especifica variáveis de ambiente para o programa que você está depurando. Use a sintaxe padrão da variável de ambiente (por exemplo, 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. Quando você clica na coluna de configurações, uma opção "Editar..." aparece. Clique nesse link para editar variáveis de ambiente.

Ambiente de Mesclagem (Depurador Local do Windows)

Determina se as variáveis que são especificadas na caixa Ambiente serão mescladas com o ambiente definido pelo sistema operacional. A configuração padrão é Sim.

Depuração de SQL (todos, com exceção do Depurador do Conjunto de MPI)

Permite a depuração de procedimentos SQL do seu aplicativo Visual C++. A configuração padrão é Não.

Tipo de Acelerador de Depuração (somente depuração de GPU)

Especifica o dispositivo GPU a ser usado para depuração. A instalação de drivers de dispositivo para dispositivos compatíveis com GPU adicionará outras opções. A configuração padrão é “GPU - emulador de software.”

Comportamento de ponto de interrupção padrão GPU (somente depuração de GPU)

Especifica se um evento de ponto de interrupção deve ser gerado para cada thread em um warp SIMD. A configuração padrão é gerar o evento do ponto de interrupção apenas uma vez por encurvamento.

Acelerador Padrão do AMP (somente depuração de GPU)

Especifica o acelerador padrão de AMP ao depurar o código de GPU. Escolha Acelerador de software WARP para investigar se um problema é causado por hardware ou por um driver em vez de por seu código.

Diretório de Implantação (Depurador Remoto do Windows)

Especifica o caminho no computador remoto onde a saída do projeto será copiada antes da inicialização. O caminho pode ser um compartilhamento de rede no computador remoto, ou pode ser um caminho para uma pasta no computador remoto. A configuração padrão está vazia, o que significa que a saída do projeto não é copiada para um compartilhamento de rede. Para ativar a implantação de arquivos, você também deve marcar a caixa de seleção Implementar na caixa de diálogo Gerenciador de Configurações. Para obter mais informações, consulte Como criar e editar configurações de teste.

Arquivos adicionais para implantar (depurador remoto do Windows)

Se a propriedade do diretório de implantação estiver definida, esta é uma lista delimitada por ponto-e-vírgula de arquivos adicionais a serem copiados para o diretório de implantação. A configuração padrão está vazia, o que significa que nenhum arquivo adicional é copiado para o diretório de implantação. Para ativar a implantação de arquivos, você também deve marcar a caixa de seleção Implementar na caixa de diálogo Gerenciador de Configurações. Para obter mais informações, consulte Como criar e editar configurações de teste.

Implantar Bibliotecas de Runtime do Visual C++ Debug (Depurador Remoto do Windows)

Se a propriedade do diretório de implantação estiver definida, isso especifica se as bibliotecas em tempo de execução de depuração do Visual C++ da plataforma atual devem ser copiadas para o compartilhamento de rede. A configuração padrão é Sim.

Pasta C/C++ (Categoria geral)

Configuração

Descrição

Formato de Informação de Depuração (/Z7, /Zd, Zi, /ZI)

Especifica o tipo de informação de depuração a ser criada para o projeto.

A opção padrão (/ZI) cria um banco de dados (PDB) do programa no formato Editar e Continuar compatível. Para obter mais informações, consulte /Z7, /Zd, /Zi, /ZI (formato de informação de depuração).

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

Configuração

Descrição

Otimização

Especifica se o compilador deve otimizar o código que produz. A otimização altera o código que é executado. O código otimizado não corresponde ao código-fonte. Portanto, a depuração é difícil.

A opção padrão (Desabilitado (/0d) suprime a otimização. 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.

Pasta do vinculador (categoria de depuração)

Configuração

Descrição

Gerar informações de depuração (/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.

Gerar arquivo de banco de dados de programa (/PDB:name)

Especifique o nome de um arquivo de PDB nesta caixa. Você deve selecionar ZI ou /Zi para obter o formato de informações de depuração.

Segmentar Símbolos Privados (/PDBSTRIPPED:filename)

Especifique o nome de um arquivo de PDB nesta caixa, caso não queira incluir símbolos particulares no arquivo de PDB. Esta opção cria um segundo arquivo (PDB) de banco de dados do programa quando você compila a imagem do programa com qualquer uma das opções de compilador ou vinculador que gera um arquivo PDB, como /DEBUG, /Z7, /Zd. Ou /Zi. Este segundo arquivo PDB omite os símbolos que você não desejaria enviar aos seus clientes. Para obter mais informações, consulte /PDBSTRIPPED (remover símbolos privados).

Gerar arquivo de mapa (/MAP)

Informe ao vinculador para gerar um arquivo de mapa durante a vinculação. A configuração padrão é Não. Para obter mais informações, consulte /MAP (gerar mapfile).

Nome de Arquivo de Mapa(/MAP:nome)

Se você escolher Gerar Arquivo de Mapa, poderá especificar o arquivo de mapa nesta caixa. Para obter mais informações, consulte /MAP (gerar mapfile).

Exportações de Mapa (/MAPINFO:EXPORTS)

Inclui funções exportadas no arquivo de mapa. A configuração padrão é Não. Para obter mais informações, consulte /MAPINFO (incluir informações em mapfile).

Assembly Depurável (/ASSEMBLYDEBUG)

Especifica configurações para a opção de /ASSEMBLYDEBUG de vinculador. Os valores possíveis são os seguintes:

  • Nenhum atributo debuggable emitido.

  • Execução de rastreamento e desativação de otimizações (/ASSEMBLYDEBUG). Essa é a configuração padrão,

  • Nenhum acompanhamento em tempo de execução e otimizações habilitadas(/ASSEMBLYDEBUG:DISABLE).

  • <Herdar do pai ou padrões de projeto>.

  • Para obter mais informações, consulte /ASSEMBLYDEBUG (Adicionar DebuggableAttribute).

Você pode alterar essas configurações na pasta Propriedades de Configuração (categoria Depuração) programaticamente usando a interface Microsoft.VisualStudio.VCProjectEngine.VCDebugSettings. Para obter mais informações, consulte VCDebugSettings.

Consulte também

Referência

/ASSEMBLYDEBUG (Adicionar DebuggableAttribute)

Outros recursos

Depurando código nativo

Configurações de depuração e preparação

Criando e gerenciando projetos do Visual C++

Macros para compilar comandos e propriedades