ClangCompile-Aufgabe

Hinweis

Diese Aufgabe ist nur verfügbar, wenn Sie das C++-Buildsystem verwenden.

Umschließt das Microsoft C++-Compilertool (clang.exe).

Parameter

In der folgenden Tabelle werden die Parameter der Aufgabe ClangCompile beschrieben:

Parameter	Beschreibung
AdditionalIncludeDirectories	Optionaler string[] -Parameter. Gibt mindestens ein Verzeichnis an, das dem include-Pfad hinzugefügt werden soll. Verwenden Sie Semikolons als Trennzeichen, wenn mehrere Verzeichnisse vorhanden sind. Verwenden Sie -I[path].
AdditionalOptions	Optionaler string-Parameter
BufferSecurityCheck	Optionaler string-Parameter Die Sicherheitsprüfung hilft bei der Erkennung von Überläufen des Stapelpuffers. Hierbei handelt es sich um gängige Versuche, die Sicherheit eines Programms zu gefährden. Verwenden Sie fstack-protector.
BuildingInIde	Optionaler bool-Parameter.
CLanguageStandard	Optionaler string-Parameter Bestimmt den C-Sprachstandard. Verwenden Sie std=[value] mit einem der folgenden Werte: c89, c99, c11, gnu99 oder gnu11.
ClangVersion	Optionaler string-Parameter
CompileAs	Optionaler string-Parameter Wählen Sie die Kompilierungssprachenoption für C- und CPP-Dateien aus. Der Standardwert erkennt basierend auf der Erweiterung ".c" oder ".cpp". Verwenden Sie -x c, -x c++.
CppLanguageStandard	Optionaler string-Parameter Bestimmt den C++-Sprachstandard Verwenden Sie std=[value] mit einem der folgenden Werte: c++98, c++11, c++1y, gnu++98, gnu++11 oder gnu++1y.
DataLevelLinking	Optionaler bool-Parameter. Ermöglicht Linker-Optimierungen, nicht verwendete Daten zu entfernen, indem jedes Datenelement in einem separaten Feld ausgegeben wird.
DebugInformationFormat	Optionaler string-Parameter Gibt den Typ der Debuginformationen an, die vom Compiler generiert werden. None: Generiert keine Debuginformationen, sodass die Kompilierung ggf. schneller erfolgt. (Verwenden Sie g0.) FullDebug: Generiert DWARF2-Debuginformationen. (Verwenden Sie g2 -gdwarf-2.) LineNumber: Generiert nur Informationen zur Zeilennummer. (Verwenden Sie gline-tables-only.)
EnableNeonCodegen	Optionaler bool-Parameter. Aktiviert die Codegenerierung für NEON-Gleitkomma-Hardware. Dies gilt nur für die ARM-Architektur.
ExceptionHandling	Optionaler string-Parameter Gibt das Ausnahmebehandlungsmodell an, das vom Compiler verwendet wird. Disabled: Deaktiviert die Ausnahmebehandlung. (Verwenden Sie fno-exceptions.) Enabled: Die Ausnahmebehandlung wird aktiviert. (Verwenden Sie fexceptions.) UnwindTables: Generiert alle erforderlichen Statistikdaten, aber ohne Auswirkungen auf den generierten Code. (Verwenden Sie funwind-tables.)
FloatABI	Optionaler string-Parameter Wählen Sie eine Option aus, um die Gleitkomma-ABI auszuwählen. soft: Sorgt dafür, dass der Compiler eine Ausgabe mit Bibliotheksaufrufen für Gleitkommavorgänge generiert. (Verwenden Sie mfloat-abi=soft.) softfp: Ermöglicht die Generierung von Code unter Verwendung hardwarebasierter Gleitkomma-Anweisungen, verwendet jedoch weiterhin die Konventionen für den soft-float-Aufruf. (Verwenden Sie mfloat-abi=softfp.) hard: Ermöglicht die Generierung von Gleitkomma-Anweisungen und verwendet FPU-spezifische Aufrufkonventionen. (Verwenden Sie mfloat-abi=hard.)
ForcedIncludeFiles	Optionaler string[] -Parameter Mindestens eine erzwungene Includedatei. Verwenden Sie -include [name].
FunctionLevelLinking	Optionaler bool-Parameter. Ermöglicht dem Compiler, einzelne Funktionen in Form von kompilierten Funktionen (COMDATs) zu kompilieren. Zur Bearbeitung erforderlich, funktionieren weiterhin. Verwenden Sie ffunction-sections.
GccToolChain	Optionaler string-Parameter Ordnerpfad zur Gcc-Toolkette.
GNUMode	Optionaler bool-Parameter.
MSCompatibility	Optionaler bool-Parameter. Ermöglicht vollständige Microsoft C++-Kompatibilität.
MSCompatibilityVersion	Optionaler string-Parameter Ein durch Punkte getrennter Wert, der die Versionsnummer des Microsoft-Compilers darstellt, die in _MSC_VER gemeldet wird (0 = nicht definieren (Standard)).
MSExtensions	Optionaler bool-Parameter. Dient zum Akzeptieren einiger Nicht-Standardkonstrukte, die vom Microsoft-Compiler unterstützt werden.
MSCompilerVersion	Optionaler string-Parameter Die Versionsnummer des Microsoft-Compilers, die in _MSC_VER gemeldet wird (0 = nicht definieren (Standard)).
MSVCErrorReport	Optionaler bool-Parameter. Dient zum Melden von Fehlern, die Visual Studio zum Analysieren von Datei- und Zeileninformationen verwenden kann.
ObjectFileName	Optionaler string-Parameter Gibt einen Namen an, um den Standardnamen der Objektdatei zu überschreiben. Dies kann ein Datei- oder Verzeichnisname sein. Verwenden Sie /Fo[name].
OmitFramePointers	Optionaler bool-Parameter. Unterdrückt die Erstellung von Framezeigern im Anrufstapel.
Optimierung	Optionaler string-Parameter Gibt die Optimierungsstufe für die Anwendung an. Custom: Benutzerdefinierte Optimierung. Disabled: Deaktiviert die Optimierung. (Verwenden Sie O0.) MinSize: Größenoptimierung. (Verwenden Sie Os.) MaxSpeed: Geschwindigkeitsoptimierung. (Verwenden Sie O2.) Full: Aufwändige Optimierungen. (Verwenden Sie O3.)
PositionIndependentCode	Optionaler bool-Parameter. Generieren von positionsunabhängigem Code (Position Independent Code, PIC) für die Verwendung in einer freigegebenen Bibliothek.
PrecompiledHeader	Optionaler string-Parameter Ermöglicht die Erstellung oder Verwendung eines vorkompilierten Headers während der Erstellung.
PrecompiledHeaderFile	Optionaler string-Parameter Gibt den Namen einer Headerdatei an, die als vorkompilierte Headerdatei verwendet werden soll. Diese Datei wird während des Erstellungsvorgangs auch zu Erzwungene Includedateien hinzugefügt.
PrecompiledHeaderOutputFileDirectory	Optionaler string-Parameter Gibt das Verzeichnis für den generierten vorkompilierten Header an. Dieses Verzeichnis wird während des Erstellungsvorgangs auch zu Zusätzliche Includeverzeichnisse hinzugefügt.
PrecompiledHeaderCompileAs	Optionaler string-Parameter Dient zum Auswählen der Kompilierungssprachenoption für die vorkompilierte Headerdatei. Verwenden Sie -x c-header, -x c++-header.
PreprocessorDefinitions	Optionaler string[] -Parameter Definiert Präprozessorsymbole für Ihre Quelldatei. Verwenden Sie -D.
RuntimeLibrary	Optionaler string-Parameter Dient zum Angeben der zu verknüpfenden Laufzeitbibliothek. Zu verwendende Schalter: MSVC /MT, /MTd, /MD, /MDd. MultiThreaded: Bewirkt, dass die Anwendung die statische Multithread-Version der Laufzeitbibliothek verwendet. MultiThreadedDebug: Definiert „_DEBUG“ und „_MT“. Diese Option führt auch dazu, dass der Compiler den Bibliotheksnamen "LIBCMTD.lib" in der .obj-Datei positioniert, sodass der Linker "LIBCMTD.lib" für das Auflösen externer Symbole verwendet. MultiThreadedDLL: Bewirkt, dass Ihre Anwendung die Multithread- und DLL-spezifische Version der Laufzeitbibliothek verwendet. Definiert „_MT“ und „_DLL“ und bewirkt, dass der Compiler den Bibliotheksnamen "MSVCRT.lib" in der OBJ-Datei platziert. MultiThreadedDebugDLL: Definiert „_DEBUG“, „_MT“ und „_DLL“ und bewirkt, dass Ihre Anwendung die Multithread- und DLL-spezifische Debugversion der Laufzeitbibliothek verwendet. Außerdem wird verursacht, dass der Compiler den Bibliotheksnamen "MSVCRTD.lib" in der .obj-Datei positioniert.
RuntimeTypeInfo	Optionaler bool-Parameter. Fügt Code für die Überprüfung der C++-Objekttypen während der Laufzeit hinzu (Laufzeit-Typinformationen). Verwenden Sie frtti, fno-rtti.
ShowIncludes	Optionaler bool-Parameter. Generiert eine Liste der Includedateien mit Compilerausgabe. Verwenden Sie -H.
Sources	Erforderlicher ITaskItem[] -Parameter.
StrictAliasing	Optionaler bool-Parameter. Annehmen der strengsten Aliasingregeln. Bei einem Objekt eines Typs wird niemals davon ausgegangen, dass es sich an derselben Adresse wie ein Objekt eines anderen Typs befindet.
Sysroot	Optionaler string-Parameter Ordnerpfad zum Stammverzeichnis für Header und Bibliotheken.
TargetArch	Optionaler string-Parameter Zielarchitektur
ThumbMode	Optionaler string-Parameter Generieren Sie Code, der für die Thumb-Mikroarchitektur ausgeführt wird. Dies gilt nur für die ARM-Architektur. Thumb: Generiert Thumb-Code. (Verwenden Sie mthumb.) ARM: Generiert ARM-Code. (Verwenden Sie marm.) Disabled: Die Option ist für die ausgewählte Plattform nicht gültig.
TrackerLogDirectory	Optionaler string-Parameter Nachverfolgungsprotokollverzeichnis
TreatWarningAsError	Optionaler bool-Parameter. Behandelt alle Compilerwarnungen als Fehler. Bei einem neuen Projekt kann es empfehlenswert sein, /WX in allen Kompilierungen zu verwenden. Die Auflösung aller Warnungen stellt sicher, dass möglichst wenig schwer zu findende Codefehler vorhanden sind.
UndefinePreprocessorDefinitions	Optionaler string[] -Parameter Gibt mindestens eine aufgehobene Präprozessordefinition an. Verwenden Sie -U [macro].
UndefineAllPreprocessorDefinitions	Optionaler bool-Parameter. Hebt die Definition aller zuvor definierten Präprozessorwerte auf. Verwenden Sie -undef.
UseMultiToolTask	Optionaler bool-Parameter. Kompilierung mit mehreren Prozessoren
UseShortEnums	Optionaler bool-Parameter. Dieser Enumerationstyp verwendet nur so viele Bytes, wie das Eingabeset an möglichen Werten erfordert.
Ausführlich	Optionaler bool-Parameter. Befehle zum Ausführen und Verwenden der ausführlichen Ausgabe anzeigen.
WarningLevel	Optionaler string-Parameter Wählen Sie aus, wie streng der Compiler bei Codefehlern sein soll. Weitere Flags sollten direkt zu Zusätzliche Optionen hinzugefügt werden. (Verwenden Sie /w, /Weverything.) TurnOffAllWarnings: Deaktiviert alle Compilerwarnungen. (Verwenden Sie w.) EnableAllWarnings: Aktiviert alle Warnungen, einschließlich standardmäßig deaktivierter Warnungen. (Verwenden Sie Wall.)

Weitere Informationen

Referenz zu MSBuild-Tasks