Sondas de compilação cruzada do CMake: distinguir compilar, vincular e executar

O que é

A compilação cruzada separa a máquina que executa as ferramentas de build da máquina que vai executar o resultado. A documentação de toolchains do CMake descreve as raízes de busca do alvo e as configurações de CMAKE_FIND_ROOT_PATH_MODE. Para toolchains que não conseguem vincular um executável comum durante as verificações do compilador, CMAKE_TRY_COMPILE_TARGET_TYPE permite solicitar, em vez disso, uma verificação com biblioteca estática. CMake toolchains manual

Por que importa

Uma sonda de configuração que falha não é, por si só, prova de que o alvo não possui determinado recurso. A sonda pode ter encontrado uma biblioteca do host, exigido um ambiente de execução do alvo ou deixado de incluir um linker script. Antes de substituir uma capacidade medida por um valor de cache presumido, os agentes devem identificar em qual etapa a sonda falhou.

Como aplicar

• Anote o host de build, a arquitetura do alvo, o compilador, o sysroot e o ambiente de execução pretendido. Mantenha o arquivo de toolchain junto com as instruções de build.
• Leia a sonda exata que falhou e classifique-a como verificação de compilação, de link ou de execução. Registre o comando e o diagnóstico, excluindo credenciais e variáveis de ambiente não relacionadas.
• Confirme que as bibliotecas e os headers vêm da árvore do alvo, enquanto os geradores de código que precisam rodar durante o build são executáveis no host.
• Se uma verificação do compilador não consegue vincular sem suporte específico da plataforma, considere uma sonda com biblioteca estática apenas para a afirmação que a compilação, por si só, basta para estabelecer. Não a rotule como um teste bem-sucedido de link de executável.
• Proponha um smoke test no alvo que exercite o recurso originalmente em dúvida. Use um alvo autorizado ou um emulador documentado e registre separadamente se a execução foi possível.

Armadilhas

O fato de o compilador aceitar uma declaração não comprova a disponibilidade em tempo de execução. Preencher previamente uma resposta no cache pode ser adequado quando ela deriva de evidência confiável do alvo, mas registre sua origem e seu escopo. Trocar o sysroot ou o compilador pode invalidar respostas antigas. Para uma toolchain alterada, crie uma árvore de build separada em vez de tratar resultados de sondas em cache sem relação com ela como fatos portáveis.