ClangCompile 任务
注意
仅当使用 C++ 生成系统时,此任务才可用。
包装 Microsof C++ 编译器工具 (clang.exe)。
参数
下表介绍了 ClangCompile 任务的参数。
参数 | 描述 |
---|---|
AdditionalIncludeDirectories | 可选的 string[] 参数。 指定一个或多个要添加到包含路径中的目录;存在多个目录时,请用分号分隔。 请使用 -I[path] 。 |
AdditionalOptions | 可选的 string 参数。 |
BufferSecurityCheck | 可选的 string 参数。 安全检查有助于检查堆栈缓冲区是否超负荷运行,它是一种常见的尝试攻击程序安全的命令。 请使用 fstack-protector 。 |
BuildingInIde | 可选的 bool 参数。 |
CLanguageStandard | 可选的 string 参数。 确定 C 语言标准。 将 std=[value] 与 c89、c99、c11、gnu99 或 gnu11 的值搭配使用。 |
ClangVersion | 可选的 string 参数。 |
CompileAs | 可选的 string 参数。 选择 .c 和 .cpp 文件的编译语言选项。 默认值将基于 .c 或 .cpp 扩展名进行检测。 使用 -x c 、-x c++ 。 |
CppLanguageStandard | 可选的 string 参数。 确定 C++ 语言标准。 将 std=[value] 与 c++98、c++11、c++1ygnu++98、gnu++11 或 gnu++1y 的值搭配使用。 |
DataLevelLinking | 可选的 bool 参数。 启用链接器优化,通过在一个独立的分区中发出每个数据项来删除未使用的数据。 |
DebugInformationFormat | 可选的 string 参数。 指定编译器生成的调试信息的类型。 None,不生成任何调试信息,编译更加快速(使用 g0 )。FullDebug,生成 DWARF2 调试信息。(使用 g2 -gdwarf-2 )。LineNumber,仅生成行号信息(使用 gline-tables-only )。 |
EnableNeonCodegen | 可选的 bool 参数。 针对 NEON 浮点硬件启用代码生成。 仅适用于 ARM 架构。 |
ExceptionHandling | 可选的 string 参数。 指定将由编译器使用的异常处理模型。 Disabled,禁用异常处理(使用 fno-exceptions )。Enabled,启用异常处理(使用 fexceptions )。UnwindTables,生成任何所需的静态数据,但不会影响生成的代码(使用 funwind-tables )。 |
FloatABI | 可选的 string 参数。 选择浮点 ABI 选项。 soft,可使编译器生成包含浮点运算库调用的输出(使用 mfloat-abi=soft )。softfp,允许使用硬件浮点指令生成代码,但仍然使用软浮点调用约定(使用 mfloat-abi=softfp )。hard,允许生成浮点指令,并使用 FPU 专用调用约定(使用 mfloat-abi=hard )。 |
ForcedIncludeFiles | 可选的 string[] 参数。 一个或多个强制包含文件。 请使用 -include [name] 。 |
FunctionLevelLinking | 可选的 bool 参数。 允许编译器以打包函数 (COMDAT) 形式对各个函数进行打包。 需进行此操作后才能编辑并继续工作。 请使用 ffunction-sections 。 |
GccToolChain | 可选的 string 参数。 Gcc 工具链的文件夹路径。 |
GNUMode | 可选的 bool 参数。 |
MSCompatibility | 可选的 bool 参数。 启用 Microsoft C++ 完全兼容性。 |
MSCompatibilityVersion | 可选的 string 参数。 句点分隔的值,表示要在 _MSC_VER 中报告的 Microsoft 编译器版本号(0 = 不定义(默认))。 |
MSExtensions | 可选的 bool 参数。 接受 Microsoft 编译器支持的一些非标准构造。 |
MSCompilerVersion | 可选的 string 参数。 要在 _MSC_VER 中报告的 Microsoft 编译器版本号(0 = 不定义(默认))。 |
MSVCErrorReport | 可选的 bool 参数。 报告 Visual Studio 可用于分析文件和行信息的错误。 |
ObjectFileName | 可选的 string 参数。 指定一个名称以替代默认对象文件名;可以是文件或目录名。 请使用 /Fo[name] 。 |
OmitFramePointers | 可选的 bool 参数。 禁止在调用堆栈上创建帧指针。 |
优化 | 可选的 string 参数。 指定应用程序的优化级别。 Custom,自定义优化。 Disabled,禁用优化(使用 O0 )。MinSize,针对大小进行优化(使用 Os )。MaxSpeed,针对速度进行优化(使用 O2 )。Full,成本高昂的优化(使用 O3 )。 |
PositionIndependentCode | 可选的 bool 参数。 生成位置无关代码 (PIC) 以便在共享库中使用。 |
PrecompiledHeader | 可选的 string 参数。 在生成期间启用创建或使用预编译标头。 |
PrecompiledHeaderFile | 可选的 string 参数。 指定用于预编译标头文件的标头文件名。 此文件也会在生成期间被添加到“强制包含文件”。 |
PrecompiledHeaderOutputFileDirectory | 可选的 string 参数。 指定生成的预编译标头的目录。 此目录也会在生成期间被添加到“附加包含目录”。 |
PrecompiledHeaderCompileAs | 可选的 string 参数。 选择预编译标头文件的编译语言选项。 使用 -x c-header 、-x c++-header 。 |
PreprocessorDefinitions | 可选的 string[] 参数。 定义源文件的预处理符号。 请使用 -D 。 |
RuntimeLibrary | 可选的 string 参数。 指定运行时库以进行链接。 使用 MSVC /MT 、/MTd 、/MD 、/MDd 开关。MultiThreaded,使应用程序使用多线程静态版本运行时库。 MultiThreadedDebug,定义 _DEBUG 和 _MT。 此选项还会让编译器将库名称 LIBCMTD.lib 放置到 .obj 文件中,以便链接器将使用 LIBCMTD.lib 来解析外部符号。 MultiThreadedDLL,使应用程序使用特定于多线程和 DLL 的运行时库版本。 定义 _MT 和 _DLL,并使编译器将库名 MSVCRT.lib 放入 .obj 文件中。 MultiThreadedDebugDLL,定义 _DEBUG、_MT 和 _DLL,并使应用程序使用特定于调试多线程和 DLL 的运行时库版本。 它还会让编译器将库名称 MSVCRTD.lib 放入 .obj 文件中。 |
RuntimeTypeInfo | 可选的 bool 参数。 添加在运行时检查 C++ 对象类型(运行时类型信息)的代码。 使用 frtti 、fno-rtti 。 |
ShowIncludes | 可选的 bool 参数。 生成包含文件的列表及编译器输出。 请使用 -H 。 |
源 | 必需的 ITaskItem[] 参数。 |
StrictAliasing | 可选的 bool 参数。 假设使用最严格的别名规则。 一种类型的对象将始终不会被假定驻留在与另一种类型的对象相同的位置。 |
Sysroot | 可选的 string 参数。 标头和库的根目录的文件夹路径。 |
TargetArch | 可选的 string 参数。 目标体系结构。 |
ThumbMode | 可选的 string 参数。 生成执行 Thumb 微架构的代码。 仅适用于 ARM 架构。 Thumb,生成 Thumb 代码(使用 mthumb )。ARM,生成 Arm 代码(使用 marm )。Disabled,此选项不适用于所选平台。 |
TrackerLogDirectory | 可选的 string 参数。 跟踪器日志目录。 |
TreatWarningAsError | 可选的 bool 参数。 将所有编译器警告视为错误。 对于新项目,最好在所有编译中使用 /WX ;对所有警告进行解析可确保将可能难以发现的代码缺陷减至最少。 |
UndefinePreprocessorDefinitions | 可选的 string[] 参数。 指定取消定义一个或多个预处理器。 请使用 -U [macro] 。 |
UndefineAllPreprocessorDefinitions | 可选的 bool 参数。 取消以前定义的所有预处理器值。 请使用 -undef 。 |
UseMultiToolTask | 可选的 bool 参数。 多处理器编译。 |
UseShortEnums | 可选的 bool 参数。 枚举类型仅用作可能值的输入集需要的字节数。 |
详细 | 可选的 bool 参数。 显示要运行的命令,并使用详细输出。 |
WarningLevel | 可选的 string 参数。 选择编译器对代码错误的严格程度。 其他标记应直接添加到附加选项(使用 /w 、/Weverything )。TurnOffAllWarnings,禁用所有编译器警告(使用 w )。EnableAllWarnings,启用所有警告,包括默认情况下禁用的那些警告(使用 Wall )。 |