Optionen¶
-C <initial-cache>
Laden Sie ein Skript vor, um den Cache zu füllen.
Wenn cmake zum ersten Mal in einem leeren Build-Baum ausgeführt wird, wird aCMakeCache erstellt.txt-Datei und füllt sie mit anpassbaren Einstellungen für das Projekt. Diese Option kann verwendet werden, um eine Datei anzugeben, aus der Cache-Einträge geladen werden sollen, bevor die Scmake-Listendateien des Projekts zum ersten Mal durchlaufen werden. Die geladenen Einträge haben Vorrang vor den Standardwerten des Projekts. Die angegebene Datei sollte ein CMake-Skript sein, das SET-Befehle enthält, die die CACHE-Option verwenden, keine Datei im Cache-Format.
-D <var>:<type>=<value>
Erstellen Sie einen Cmake-Cache-Eintrag.
Wenn cmake zum ersten Mal in einem leeren Build-Baum ausgeführt wird, wird aCMakeCache erstellt.txt-Datei und füllt sie mit anpassbaren Einstellungen für das Projekt. Diese Option kann verwendet werden, um eine Einstellung anzugeben, die Vorrang vor dem Standardwert des Projekts hat. Die Option kann für beliebig viele Cache-Einträge wiederholt werden.
-U <globbing_expr>
Entfernen Sie übereinstimmende Einträge aus dem CMake-Cache.
Diese Option kann verwendet werden, um eine oder mehrere Variablen aus dem Makecache zu entfernen.txt-Datei, globbing Ausdrücke mit * und ? aresupported. Die Option kann für so viele Cache-Einträge wiederholt werden wiewunsch.
Verwenden Sie mit Vorsicht, Sie können Ihren CMakeCache erstellen.txt funktioniert nicht.
-G <generator-name>
Geben Sie einen Build-Systemgenerator an.
CMake unterstützt möglicherweise mehrere native Build-Systeme auf bestimmten Plattformen. Ein Generator ist für die Erzeugung eines bestimmten verantwortlichbausystem. Mögliche Generatornamen werden im Abschnitt Generatoren angegeben.
-T <toolset-name>
Geben Sie den Toolset-Namen an, falls vom Generator unterstützt.
Einige CMake-Generatoren unterstützen einen Toolset-Namen, der dem Build-System zur Auswahl eines Compilers gegeben werden soll. Dies wird nur bei bestimmten Generatoren unterstützt:
Visual Studio >= 10Xcode >= 3.0
Zulässige Toolset-Namen finden Sie in der Dokumentation zum systemeigenen Build-System.
-A <platform-name>
Geben Sie den Plattformnamen an, falls vom Generator unterstützt.
Einige CMake-Generatoren unterstützen einen Plattformnamen, der dem Build-System gegeben werden muss, um einen Compiler oder ein SDK auszuwählen. Dies wird nur bei bestimmten Generatoren unterstützt:
Visual Studio >= 8
Zulässige Plattformnamen finden Sie in der Dokumentation zum systemeigenen Build-System.
-Wno-dev
Entwickler-Warnungen unterdrücken.
Unterdrückt Warnungen, die für den Autor von theCMakeLists bestimmt sind.txt-Dateien.
-Wdev
Entwicklerwarnungen aktivieren.
Aktivieren Sie Warnungen, die für den Autor der CMakeLists bestimmt sind.txtfiles.
-E
CMake-Befehlsmodus.
Für echte Plattformunabhängigkeit bietet CMake eine Liste von Befehlen, die auf allen Systemen verwendet werden können. Führen Sie mit -E Hilfe für die usageinformation. Verfügbare Befehle sind: chdir, compare_files, kopieren, copy_directory, copy_if_different, echo, echo_append, env, Umwelt, make_directory, md5sum, entfernen, remove_directory, umbenennen, Schlaf, tar, Zeit, berühren, touch_nocreate. Darüber hinaus sind einige plattformspezifische Befehlesind verfügbar. Unter Windows: delete_regv, write_regv. OnUNIX: create_symlink.
-L
Listet nicht erweiterte zwischengespeicherte Variablen auf.
List cache variables führt CMake aus und listet alle Variablen aus dem CMake-Cache auf, die nicht als INTERN oder ERWEITERT markiert sind. Dies zeigt effektiv die aktuellen CMake-Einstellungen an, die dann mit der Option -D geändert werden können. Das Ändern einiger Variablen kann dazu führen, dass weitere Variablen erstellt werden. Wenn A angegeben ist, wird esauch erweiterte Variablen anzeigen. Wenn H angegeben ist, wird alsodisplay Hilfe für jede Variable.
--build <dir>
Erstellen Sie einen von CMake generierten Projektbinärbaum.
Dies abstrahiert die Befehlszeilenschnittstelle eines nativen Build-Tools mit den folgenden Optionen:
<dir> = Project binary directory to be built.--target <tgt> = Build <tgt> instead of default targets.--config <cfg> = For multi-configuration tools, choose <cfg>.--clean-first = Build target 'clean' first, then build. (To clean only, use --target 'clean'.)--use-stderr = Ignored. Behavior is default in CMake >= 3.0.-- = Pass remaining options to the native tool.
Führen Sie cmake –build ohne Optionen für schnelle Hilfe aus.
-N
Nur Ansichtsmodus.
Lädt nur den Cache. Führen Sie configure und generatesteps nicht aus.
-P <file>
Skriptmodus verarbeiten.
Verarbeitet die angegebene cmake-Datei als Skript, das in der CMakelanguage geschrieben ist. Es wird kein Schritt zum Konfigurieren oder Generieren ausgeführt und der Cache wird nicht geändert. Wenn Variablen mit -D definiert werden, muss dies vor dem Argument -P stehen.
--find-package
Im pkg-config-ähnlichen Modus ausführen.
Suchen Sie ein Paket mit find_package() und drucken Sie die resultierenden flagsto stdout . Dies kann verwendet werden, um cmake anstelle von pkg-config zu verwenden, um installierte Bibliotheken in einfachen Makefile-basierten Projekten oder inautoconf-basierten Projekten (über share / aclocal / cmake .m4).
--graphviz=
Graphviz von Abhängigkeiten generieren, siehe CMakeGraphVizOptions .cmake für mehr.
Generieren Sie eine Graphviz-Eingabedatei, die alle Bibliotheks- und ausführbaren Abhängigkeiten im Projekt enthält. Siehe die Dokumentation forCMakeGraphVizOptions .cmake für weitere Details.
--system-information
Dump-Informationen zu diesem System.
Dump eine breite Palette von Informationen über das aktuelle System. Wenn runfrom oben in einem Binärbaum für ein CMake-Projekt ausgeführt wird, werden zusätzliche Informationen wie Cache, Protokolldateien usw. ausgegeben.
--debug-trycompile
Löschen Sie den try_compile-Build-Baum nicht. Nur nützlich für jeweils ein try_compile .
Löschen Sie nicht die für try_compilecalls erstellten Dateien und Verzeichnisse. Dies ist nützlich beim Debuggen fehlgeschlagener try_compiles. Es kann jedoch die Ergebnisse der Try-Compiles ändern, da alter Müll von einem früheren Try-Compile dazu führen kann, dass ein anderer Test entweder falsch besteht oder fehlschlägt. Diese Option wird am besten für jeweils einen Kompilierungsversuch und nur beim Debuggen verwendet.
--debug-output
Versetzen Sie cmake in einen Debug-Modus.
Drucken Sie während des Cmake-Laufs zusätzliche Inhalte wie Stack-Traces mit message (send_error) -Aufrufen.
--trace
Setzen Sie cmake in den Trace-Modus.
Gibt eine Ablaufverfolgung aller getätigten Anrufe aus und von wo aus withmessage(send_error ) aufruft.
--warn-uninitialized
Warnt vor nicht initialisierten Werten.
Gibt eine Warnung aus, wenn eine nicht initialisierte Variable verwendet wird.
--warn-unused-vars
Warnung vor nicht verwendeten Variablen.
Finden Sie Variablen, die deklariert oder gesetzt, aber nicht verwendet werden.
--no-warn-unused-cli
Warnen Sie nicht vor Befehlszeilenoptionen.
Finden Sie keine Variablen, die in der Befehlszeile deklariert, aber nicht verwendet werden.
--check-system-vars
Finden Sie Probleme mit der Variablennutzung in Systemdateien.
Normalerweise werden nicht verwendete und nicht initialisierte Variablen nur in CMAKE_SOURCE_DIR und CMAKE_BINARY_DIR gesucht. Dieses Flag weist CMake an, auch vor anderen Dateien zu warnen.
--help,-help,-usage,-h,-H,/?
Nutzungsinformationen drucken und beenden.
Verwendung beschreibt die grundlegende Befehlszeilenschnittstelle und ihre Optionen.
--version,-version,/V
Programmname /Versionsbanner anzeigen und beenden.
Wenn eine Datei angegeben wird, wird die Version in sie geschrieben.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-full
Alle Hilfe-Handbücher ausdrucken und beenden.
Alle Handbücher sind in einem für Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-manual <man>
Drucken Sie ein Hilfehandbuch und beenden Sie es.
Das angegebene Handbuch ist in einem für Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-manual-list
Verfügbare Hilfehandbücher auflisten und beenden.
Die Liste enthält alle Handbücher, für die Sie Hilfe erhalten, indem Sie die Option --help-manual gefolgt von einem Handbuchnamen verwenden.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-command <cmd>
Hilfe für einen Befehl drucken und beenden.
Die cmake-commands(7) manuelle Eingabe für <cmd> wird in einem für Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-command-list
Befehle mit Hilfe auflisten und beenden.
Die Liste enthält alle Befehle, für die Sie Hilfe benötigen, indem Sie die Option --help-command gefolgt von einem Befehlsnamen verwenden.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-commands
Cmake-Befehle manuell drucken und beenden.
Das cmake-commands(7) Handbuch ist in einem für den Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-module <mod>
Hilfe für ein Modul drucken und beenden.
Der cmake-modules(7) manuelle Eintrag für <mod> wird in einem für Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-module-list
Module mit Hilfe auflisten und beenden.
Die Liste enthält alle Module, für die Sie Hilfe erhalten, indem Sie die Option --help-module gefolgt von einem Modulnamen verwenden.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-modules
cmake-modules manual drucken und beenden.
Das cmake-modules(7) Handbuch ist in einem lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-policy <cmp>
Hilfe für eine Richtlinie drucken und beenden.
Der cmake-policies(7) manuelle Eintrag für <cmp> wird in einem für Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-policy-list
Richtlinien mit verfügbarer Hilfe auflisten und beenden.
Die Liste enthält alle Richtlinien, für die Sie Hilfe erhalten, indem Sie die Option --help-policy gefolgt von einem Richtliniennamen verwenden.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-policies
cmake-Richtlinien manuell drucken und beenden.
Das cmake-policies(7) Handbuch ist in einem vom Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-property <prop>
Hilfe für eine Eigenschaft drucken und beenden.
Die cmake-properties(7) manuellen Einträge für <prop> werden in einem für Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-property-list
Eigenschaften mit Hilfe auflisten und beenden.
Die Liste enthält alle Eigenschaften, für die Sie Hilfe benötigen, indem Sie die Option --help-property gefolgt von einem Eigenschaftsnamen verwenden.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-properties
cmake-properties manuell drucken und beenden.
Das cmake-properties(7) Handbuch ist in einem vom Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-variable <var>
Hilfe für eine Variable drucken und beenden.
Die cmake-variables(7) manuelle Eingabe für <var> wird in einem für Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-variable-list
Variablen mit Hilfe auflisten und beenden.
Die Liste enthält alle Variablen, für die Sie Hilfe benötigen, indem Sie die Option --help-variable gefolgt von einem Variablennamen verwenden.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.
--help-variables
cmake-Variablen manuell drucken und beenden.
Das cmake-variables(7) Handbuch ist in einem vom Menschen lesbaren Textformat gedruckt.Die Hilfe wird auf eine benannte <f>ile gedruckt, falls angegeben.