Partilhar via


Tarefa ClangCompile

Observação

Essa tarefa só está disponível ao usar o sistema de compilação C++.

Encapsula a ferramenta de compilador do Microsoft C++, clang.exe.

Parâmetros

A tabela a seguir descreve os parâmetros da tarefa ClangCompile.

Parâmetro Descrição
AdditionalIncludeDirectories Parâmetro opcional String[].

Especifica um ou mais diretórios a serem adicionados ao caminho de inclusão, separados por ponto e vírgula no caso de mais de um.

Use -I[path].
AdditionalOptions Parâmetro opcional string.
BufferSecurityCheck Parâmetro opcional string.

A Verificação de Segurança ajuda a detectar saturações de buffer de pilha, uma tentativa de ataque comum à segurança de um programa.

Use fstack-protector.
BuildingInIde Parâmetro opcional bool.
CLanguageStandard Parâmetro opcional string.

Determina o padrão de linguagem C.

Use std=[value] com o valor de c89, c99, c11, gnu99 ou gnu11.
ClangVersion Parâmetro opcional string.
CompileAs Parâmetro opcional string.

Selecione a opção de linguagem de compilação para arquivos .c e .cpp. O padrão detectará com base na extensão .c ou .cpp.

Use -x c, -x c++.
CppLanguageStandard Parâmetro opcional string.

Determina o padrão de linguagem C++.

Use std=[value] com o valor de c++98, c++11, c++1y, gnu++98, gnu++11 ou gnu++1y.
DataLevelLinking Parâmetro opcional bool.

Habilita as otimizações do vinculador para remover dados não utilizados ao emitir cada item de dados em uma seção separada.
DebugInformationFormat Parâmetro opcional string.

Especifica o tipo de informações de depuração geradas pelo compilador.

Nenhum, não produz informação de depuração; portanto, a compilação pode ser mais rápida (use g0).
FullDebug, gere informações de depuração DWARF2 (use g2 -gdwarf-2).
LineNumber, gere somente informações de Número de Linha (use gline-tables-only).
EnableNeonCodegen Parâmetro opcional bool.

Habilita a geração de código para hardware de ponto flutuante NEON. Somente se aplica a arquiteturas arm.
ExceptionHandling Parâmetro opcional string.

Especifica o modelo de tratamento de exceções a ser utilizado pelo compilador.

Desabilitado, desabilite o tratamento de exceções (use fno-exceptions).
Habilitado, habilite o tratamento de exceções (use fexceptions).
UnwindTables, gera todos os dados estáticos necessários, mas não afeta o código gerado (use funwind-tables).
FloatABI Parâmetro opcional string.

Opção de seleção para escolher o ABI de ponto flutuante.

soft, faz com que o compilador gere saídas contendo chamadas da biblioteca para operações de ponto flutuante (use mfloat-abi=soft).
softfp, permite a geração de código usando instruções de ponto flutuante de hardware, mas ainda usa as convenções de chamada de flutuação suave (use mfloat-abi=softfp).
hard, permite a geração de instruções de ponto flutuante e usa convenções de chamada específicas de FPU (use mfloat-abi=hard).
ForcedIncludeFiles Parâmetro opcional String[].

Um ou mais arquivos de inclusão forçados.

Use -include [name].
FunctionLevelLinking Parâmetro opcional bool.

Permite que o compilador empacote funções individuais no formato de funções empacotadas (COMDATs). Necessário para editar e continuar a trabalhar.

Use ffunction-sections.
GccToolChain Parâmetro opcional string.

Caminho da pasta para Cadeia de Ferramenta Gcc.
GNUMode Parâmetro opcional bool.

MSCompatibility Parâmetro opcional bool.

Habilitar compatibilidade total do Microsoft C++.
MSCompatibilityVersion Parâmetro opcional string.

O valor separado por ponto que representa o número de versão do compilador da Microsoft a relatar em _MSC_VER (0 = não definir (padrão)).
MSExtensions Parâmetro opcional bool.

Aceite alguns construtos não padrão para os quais o compilador da Microsoft dá suporte.
MSCompilerVersion Parâmetro opcional string.

O número de versão do compilador da Microsoft para relatar no _MSC_VER (0 = não definir (padrão)).
MSVCErrorReport Parâmetro opcional bool.

Relate erros que o Visual Studio pode usar para analisar informações sobre arquivos e linhas.
ObjectFileName Parâmetro opcional string.

Especifica um nome para substituir o nome do arquivo-objeto padrão. Pode ser um nome de arquivo ou de diretório.

Use /Fo[name].
OmitFramePointers Parâmetro opcional bool.

Inibe a criação de ponteiros de quadros na pilha de chamadas.
Otimização Parâmetro opcional string.

Especifica o nível de otimização para o aplicativo.

Personalizar, personalizar a otimização.
Desabilitado, desabilitar a otimização (use O0).
MinSize, otimizar o tamanho (use Os).
MaxSpeed, otimizar para velocidade (use O2).
Full, otimizações dispendiosas (use O3).
PositionIndependentCode Parâmetro opcional bool.

Gere um código independente da posição (PIC) para ser usado em uma biblioteca compartilhada.
PrecompiledHeader Parâmetro opcional string.

Habilita a criação ou o uso de um cabeçalho pré-compilado durante o build.
PrecompiledHeaderFile Parâmetro opcional string.

Especifica o nome do arquivo de cabeçalho a ser usado para o arquivo de cabeçalho pré-compilado. Esse arquivo também será adicionado a Arquivos de Inclusão Forçados durante o build.
PrecompiledHeaderOutputFileDirectory Parâmetro opcional string.

Especifica o diretório para o cabeçalho pré-compilado gerado. Este diretório também será adicionado a Diretórios de Inclusão Adicionais durante o build.
PrecompiledHeaderCompileAs Parâmetro opcional string.

Selecione a opção de linguagem de compilação para o arquivo de cabeçalho pré-compilado.

Use -x c-header, -x c++-header.
PreprocessorDefinitions Parâmetro opcional String[].

Define símbolos de pré-processamento para o arquivo de origem.

Use -D.
RuntimeLibrary Parâmetro opcional string.

Especifique a biblioteca de runtime para vinculação.

Use as opções MSVC /MT, /MTd, /MD, /MDd.

MultiThreaded, faz com que seu aplicativo utilize a versão multithread e estática da biblioteca em tempo de execução.
MultiThreadedDebug, define _DEBUG e _MT. Essa opção também faz com que o compilador coloque o nome da biblioteca LIBCMTD.lib no arquivo .obj para que o vinculador use LIBCMTD.lib para resolver símbolos externos.
MultiThreadedDLL, faz com que o aplicativo use a versão específica de multithread e a versão específica de DLL da biblioteca em tempo de execução. Define _MT e _DLL e faz com que o compilador coloque o nome da biblioteca MSVCRT.lib no arquivo .obj.
MultiThreadedDebugDLL, define _DEBUG, _MT e _DLL e faz com que o aplicativo use a versão específica de multithread e a versão específica de DLL da biblioteca em tempo de execução. Também faz com que o compilador coloque o nome da biblioteca MSVCRTD.lib no arquivo .obj.
RuntimeTypeInfo Parâmetro opcional bool.

Adiciona um código para verificar os tipos de objeto C++ no runtime (informações de tipo de runtime).

Use frtti, fno-rtti.
ShowIncludes Parâmetro opcional bool.

Gera uma lista de arquivos de inclusão com a saída do compilador.

Use -H.
Fontes Parâmetro obrigatório ITaskItem[].
StrictAliasing Parâmetro opcional bool.

Considere as regras de alias mais rígidas. Um objeto de um tipo nunca será considerado como residente do mesmo endereço que um objeto de um tipo diferente.
Sysroot Parâmetro opcional string.

Caminho da pasta para o diretório raiz para cabeçalhos e bibliotecas.
TargetArch Parâmetro opcional string.

Arquitetura de Destino.
ThumbMode Parâmetro opcional string.

Gerar um código que pode ser executado em microarquiteturas thumb. Somente se aplica a arquiteturas arm.

Thumb, gere código Thumb (use mthumb).
ARM, gere código Arm (use marm).
Desabilitado, opção não aplicável à plataforma escolhida.
TrackerLogDirectory Parâmetro opcional string.

Diretório de Log do Rastreador.
TreatWarningAsError Parâmetro opcional bool.

Trata todos os avisos do compilador como erros.

Para um novo projeto, talvez seja melhor usar /WX em todas as compilações. Resolver todos os avisos assegurará o menor número possível de defeitos de código difíceis de localizar.
UndefinePreprocessorDefinitions Parâmetro opcional String[].

Especifica uma ou mais exclusões de definição do pré-processador.

Use -U [macro].
UndefineAllPreprocessorDefinitions Parâmetro opcional bool.

Exclua as definições de todos os valores do pré-processador definidos anteriormente.

Use -undef.
UseMultiToolTask Parâmetro opcional bool.

Compilação de multiprocessador.
UseShortEnums Parâmetro opcional bool.

O tipo enum usa somente o número de bytes exigido pelo conjunto de entrada de valores possíveis.
Verbose Parâmetro opcional bool.

Mostrar os comandos a serem executados e usar a saída detalhada.
WarningLevel Parâmetro opcional string.

Selecione o rigor que você deseja que o compilador aplique aos erros de código. Outros sinalizadores devem ser adicionados diretamente às Opções Adicionais (se /w, /Weverything).

TurnOffAllWarnings, desabilita todos os avisos do compilador (use w).
EnableAllWarnings, habilita todos os avisos, incluindo os que estão desabilitados por padrão (use Wall).

Confira também

Referência de tarefas