Advanced¶
Fortgeschrittene Benutzer könnten weiter an den Einstellungen der folgenden Optionen interessiert sein, die in den meisten Fällen automatisch von den oben zusammengefassten nicht-fortgeschrittenen CMake-Optionen abgeleitet werden. Um diese Optionen in der CMake-GUI anzuzeigen, drücken Sie die Taste t inccmake (Unix) oder aktivieren Sie das Kontrollkästchen Show Advanced Values (Windows).
-DBASIS_ALL_DOC:BOOL¶
Fordern Sie die Erstellung aller Dokumentationsziele als Teil des ALL targetif BUILD_DOCUMENTATION is ON an.
-DBASIS_COMPILE_SCRIPTS:BOOL¶
Aktivieren Sie die Kompilierung von Python-Modulen. Wenn diese Option aktiviert ist, werden nur die kompilierten .pyc-Dateien installiert.
-DBASIS_COMPILE_MATLAB:BOOL¶
Gibt an, ob MATLAB-Quellen mit dem MATLAB Compiler (mcc) kompiliert werden sollen, falls verfügbar.Wenn auf OFF gesetzt, werden die MATLAB-Quelldateien als Teil der Installation kopiert undein Bash-Skript für die Ausführung von matlab mit der Option -c wird unter Unix bzw. ein Windows NT-Befehlsskript unter Windows generiert. Dies ermöglicht die bequeme Ausführung der in MATLAB implementierten ausführbaren Datei auch ohne alicense für den MATLAB-Compiler. Jede Instanz der erstellten ausführbaren Datei benötigt jedoch eine MATLAB-Lizenz. Darüber hinaus ist der Start der ausführbaren Datei jedes Mal länger, nicht nur beim ersten Start, wie dies bei mcc der Fall ist. executables.It es wird daher empfohlen, diese Option zu aktivieren und nach Möglichkeit eine MATLAB Compilerlicense zu beziehen. Standardmäßig ist diese Option ON.
-DBASIS_DEBUG:BOOL¶
Aktivieren Sie Debugmeldungen während der Build-Konfiguration.
-DBASIS_INSTALL_APIDOC_DIR:PATH¶
Installationsverzeichnis der API-Dokumentation relativ zum Installationspräfix.
-DBASIS_INSTALL_RPATH:BOOL¶
Gibt an, ob BASIS die entsprechende INSTALL_RPATH Eigenschaft von ausführbaren Dateien und freigegebenen Bibliotheken anstelle von CMake festlegen soll. Diese Option ist standardmäßig ON, was dem Basisstandard entspricht. Beachten Sie, dass diese Option vom Projektentwickler oder in der Befehlszeile durch Setzen der variableCMAKE_SKIP_RPATH auf FALSE überschrieben werden kann. Dies geschieht typischerweise in der Konfiguration / Einstellungen.cmake.
-DBASIS_INSTALL_SCHEME:STRING¶
Installationsschema, d. H. Dateisystemhierarchie, die für die Installation der Softwaredateien relativ zum durch -DCMAKE_INSTALL_PREFIX angegebenen Installationspräfix verwendet werden soll.Gültige Werte sind default, usr, opt, oder win. Weitere Informationen finden Sie unter Installationsbaumwie durch das Dateisystemlayout von BASIS definiert.
-DBASIS_INSTALL_SITE_DIR:PATH¶
Installationsverzeichnis der Website relativ zum Installationspräfix.
-DBASIS_INSTALL_SITE_PACKAGES:BOOL¶
Gibt an, ob öffentliche Modulbibliotheken, die in einer Skriptsprache wie asPython oder Perl geschrieben wurden, in den systemweiten Standardspeicherorten für Site-Pakete installiert werden sollen. Diese Option ist standardmäßig deaktiviert, da ansonsten Schreibrechte für diese Verzeichnisse erforderlich sind.
-DBASIS_MCC_FLAGS:STRING¶
Zusätzliche Flags für MATLAB Compiler durch Leerzeichen getrennt.
-DBASIS_MCC_MATLAB_MODE:BOOL¶
Gibt an, ob der MATLAB-Compiler im MATLAB-Modus aufgerufen werden soll. Wenn ON , wird der MATLAB-Compiler innerhalb einer MATLAB-Interpreter-Sitzung aufgerufen, was zur sofortigen Freigabe der MATLAB-Compiler-Lizenz führt, sobald die Kompilierung abgeschlossen ist.Ansonsten ist die Lizenz für einen festen Zeitraum (z.B. 30 min) reserviert.
-DBASIS_MCC_RETRY_ATTEMPTS:INT¶
Anzahl der Wiederholungen der Kompilierung des MATLAB-Compiler-Ziels bei einem Lizenz-Checkout-Fehler.
-DBASIS_MCC_RETRY_DELAY:INT¶
Verzögerung in Sekunden zwischen Wiederholungsversuchen zum Erstellen von MATLAB-Compiler-Zielen, nachdem ein Alicense-Checkout-Fehler aufgetreten ist.
-DBASIS_MCC_TIMEOUT:INT¶
Timeout in Sekunden für den Build eines MATLAB-Compiler-Ziels. Wenn der Build des Ziels nicht innerhalb der angegebenen Zeit abgeschlossen werden konnte, wird der Build unterbrochen.
-DBASIS_MEX_FLAGS:STRING¶
Zusätzliche Flags für das MEX-Skript durch Leerzeichen getrennt.
-DBASIS_MEX_TIMEOUT:INT¶
Timeout in Sekunden für den Build von MEX-Dateien.
-DBASIS_REGISTER:BOOL¶
Gibt an, ob das installierte Paket in der Paketregistrierung von CMake registriert werden soll. Diese Option ist standardmäßig aktiviert, sodass Pakete von CMake gefunden werden, wenn sie von anderen Paketen benötigt werden, die auf diesem Build-Tool basieren.
-DBASIS_SUPERBUILD_MODULES:BOOL¶
Experimental Aktivieren Sie den Superbuild von Projektmodulen. Bei Projekten mit einer großen Anzahl von Modulen kann dies die Konfigurationszeit des Build-Systems erheblich verkürzen, da die Konfiguration jedes Moduls bis zum Build-Schritt verschoben wird.Der Superbuild von Modulen ist standardmäßig deaktiviert.Siehe Superbuild von Modulen für weitere Informationen.
-DBASIS_VERBOSE:BOOL¶
Aktivieren Sie ausführliche Nachrichten während der Build-Konfiguration.
-DBUILD_BASIS_UTILITIES_FOR_<LANG>:BOOL¶
Standardmäßig werden die Basisdienstprogramme für eine bestimmte Programmiersprache nur erstellt, wenn eines der ausführbaren Projekt- oder Bibliotheksziele, das aus Quellcode in der betreffenden Sprache erstellt wurde, diese Dienstprogramme verwendet. Verwenden Sie diese Optionen, um die Erstellung der BASIS-Utilities für die jeweilige Sprache zu erzwingen. Selbst wenn sie nicht vom Projekt selbst verwendet werden, können die generierten Utility-Funktionen und Header- oder Skriptmoduldateien von einem anderen Projekt verwendet werden, um auf die Projektmetadaten wie Name und Version zuzugreifen, indem die jeweiligen projektspezifischen BASIS-Utilities einbezogen werden.
-DBUILD_CHANGELOG:BOOL¶
Fordern Sie die Erstellung des Änderungsprotokolls als Teil des Ziels ALL an. Beachten Sie, dass das Changelog entweder aus dem Subversion-Verlauf generiert wird, wenn der Quellbaum eine SVNworking-Kopie ist, oder aus dem Git-Verlauf, wenn es sich um ein Git-Repository handelt. Andernfalls kann das Änderungsprotokoll nicht generiert werden, und diese Option BASIS.In beachten Sie bei Subversion, dass die Generierung des Changelogs mehrere Minuten dauert und die Eingabe von Benutzeranmeldeinformationen für den Zugriff auf das Subversion-Repository erforderlich sein kann. Es wird empfohlen, diese Option deaktiviert zu lassen und stattdessen das changelog-Ziel getrennt vom Rest des Softwarepakets zu erstellen (siehe Software erstellen).
-DBUILD_MODULES_BY_DEFAULT::BOOL¶
Gibt an, ob Projektmodule (d. h. Teilprojekte) standardmäßig aktiviert werden sollen oder nicht. Diese Option wirkt sich nur aus, wenn sie direkt in der Befehlszeile angegeben wird, wenn cmake bzw.ccmake aufgerufen wird. Andernfalls wird der Standardwert dieser Option für den ersten Build-Systemkonfigurationslauf verwendet, der die MODULE_* -Optionen bereits hinzufügt und auf den entsprechenden Standardwert (TRUE) setzt. Dieser Standardwert kann nicht durch aufeinanderfolgende Konfigurationsläufe überschrieben werden, es sei denn, die MODULE_* -Optionen selbst werden geändert.
-DITK_DIR:PATH