/Gm (habilitar recompilação manual)

  • Artigo

Preterido. Habilita recompilação mínima, que determina se os arquivos de origem C++ que incluem definições de classe C++ alteradas (armazenadas nos arquivos de cabeçalho (.h)) precisam ser recompilados.

Sintaxe

/Gm

Comentários

/Gm foi preterido. Ele pode não disparar um build para determinados tipos de alterações de arquivo de cabeçalho. Você pode remover essa opção de seus projetos com segurança. Para aprimorar os tempos de build, recomendamos que você use cabeçalhos pré-compilados e opções de build incrementais e paralelas. Para obter uma lista de opções do compilador preteridas, consulte a seção Opções do compilador preteridas e removidas em Opções do compilador listadas por categoria.

O compilador armazena as informações de dependência entre arquivos de origem e definições de classe no arquivo .idb do projeto durante a primeira compilação. (Informações sobre dependência dizem que arquivo de origem depende da definição de classe e em qual arquivo .h a definição está localizada.) Compilações subsequentes usam as informações armazenadas no arquivo .idb para determinar se um arquivo de origem precisa ser compilado, mesmo que inclua um arquivo .h modificado.

Observação

A recompilação mínima conta com definições de classe que não mudem entre os arquivos incluídos. As definições de classe devem ser globais para um projeto (deve haver apenas uma definição de uma determinada classe), pois as informações de dependência no arquivo .idb são criadas para todo o projeto. Se você tiver mais de uma definição para uma classe no seu projeto, desabilite a recompilação mínima.

Como o vinculador incremental não tem suporte para metadados do Windows incluídos em arquivos .obj usando a opção /ZW (Windows Runtime Compilation), a opção /Gm é incompatível com /ZW.

Para definir esta opção do compilador no ambiente de desenvolvimento do Visual Studio

  1. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.

  2. Selecione a página de propriedades Propriedades da Configuração>C/C++>Geração de Código.

  3. Modifique a propriedade Habilitar Recompilação Mínima.

Para definir essa opção do compilador via programação

Confira também

Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC