Bancos de dados de compilação: reproduza a unidade de tradução com falha antes de alterar cabeçalhos

O que é

Com um gerador compatível, a variável CMAKE_EXPORT_COMPILE_COMMANDS do CMake produz o arquivo compile_commands.json, que contém as invocações do compilador para as unidades de tradução. A documentação limita esse recurso aos geradores Makefile e Ninja e menciona dificuldades com unity builds. O banco de dados descreve comandos de compilação; ele não indica que a aplicação inteira foi linkada ou executada. CMake compilation database

Por que importa

Um agente pode estragar um arquivo correto ao reagir a diagnósticos gerados com o caminho de include, o modo de linguagem ou o conjunto de macros errados. Antes de adicionar ramificações de compatibilidade, compare o contexto do diagnóstico com o comando que o build realmente usa. Este método, que é uma proposta, trata o contexto do compilador como evidência.

Como aplicar

• Identifique o arquivo-fonte específico e a configuração de build ativa. Localize a entrada correspondente no banco de dados de compilação e leia o diretório de trabalho e os argumentos do compilador.
• Depois de trocar de toolchain ou de alterar opções relevantes, regenere o banco de dados pela configuração normal do CMake do projeto. Evite editar à mão o arquivo gerado como correção duradoura.
• Reproduza o diagnóstico da unidade de tradução a partir do diretório registrado, em um ambiente de build descartável. Preserve as fronteiras dos argumentos ao lidar com caminhos que contêm espaços.
• Compare as configurações do editor com esse comando: diretórios de include, cabeçalhos gerados, padrão da linguagem e definições são bons primeiros candidatos. Registre qualquer diferença deliberada, em vez de presumir que as duas ferramentas usam valores padrão idênticos.
• Depois de corrigir o contexto, execute de novo a verificação direcionada e o build real do projeto. Se o diagnóstico persistir, reduza o problema no código-fonte mantendo as mesmas flags relevantes.

Armadilhas

Um cabeçalho pode ser incluído por várias unidades de tradução com macros diferentes; um único comando inferido não consegue representar todos os usos. Quando um arquivo tem várias entradas, também é preciso escolher a configuração desejada. Unity builds podem combinar arquivos-fonte de maneiras que uma ferramenta que trabalha por arquivo não modela. Não descreva um painel limpo no editor como um build bem-sucedido, nem um banco de dados de compilação como um lockfile completo de dependências.