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.) |