QT_DEPLOY_PREFIX

Basisverzeichnis für eine Bereitstellung.

Diese Variable wird durch das Skript definiert, dessen Name durch QT_DEPLOY_SUPPORT angegeben wird. Sie sollte ausschließlich im Rahmen der Bereitstellung während der Installation oder einer Post-Build-Regel verwendet werden.

Hinweis: Hierbei handelt es sich um eine Low-Level-Variable der Bereitstellungs-API, die nur in fortgeschrittenen Anwendungsfällen verwendet werden sollte, die nicht durch die übergeordneten API-Befehle wie z. B. ` qt_generate_deploy_app_script` abgedeckt sind.

Diese Variable wurde in Qt 6.3 eingeführt.

QT_DEPLOY_PREFIX Liefert das Basisverzeichnis für die Bereitstellung. Die anderen Variablen von „ QT_DEPLOY_..._DIR “ sollten als relativ zu diesem Speicherort behandelt werden. Der Wert von „ QT_DEPLOY_PREFIX “ kann relativ oder absolut sein, daher sollten Projekte in keiner Situation von der einen oder anderen Form ausgehen. Ein relativer Pfad wird voraussichtlich relativ zum aktuellen Arbeitsverzeichnis behandelt, wie es das Build-Tool (ninja, make usw.) zum Zeitpunkt der Installation sieht.

Der Standardwert ist $ENV{DESTDIR}${CMAKE_INSTALL_PREFIX}, also der Basisordner, den CMake während der Installation verwendet. Wenn dies zu einer leeren Zeichenkette führt, ist der Standardwert stattdessen ein Punkt (.), was im Allgemeinen der geeignete Wert ist, wenn die Bereitstellung als Teil einer Post-Build-Regel erfolgt. Diese zweistufige Fallback-Logik stellt sicher, dass Projekte davon ausgehen können, dass QT_DEPLOY_PREFIX keine leere Zeichenkette ist, sodass sie sicher als Teil eines Pfads wie ${QT_DEPLOY_PREFIX}/${QT_DEPLOY_BIN_DIR} verwendet werden kann.

Um den Wert von QT_DEPLOY_PREFIX zu ändern, kann das Projekt mit einem benutzerdefinierten CMAKE_INSTALL_PREFIX konfiguriert werden, wie unter „Aufruf von cmake über die Befehlszeile“ beschrieben.

Die Umgebungsvariable DESTDIR kann ebenfalls verwendet werden, um den endgültigen Installations- und damit den Bereitstellungsort zu ändern.

Projekte sollten diese Variable nur selten verwenden müssen. In typischen Szenarien sollten Deployment-Skripte davon ausgehen, dass das Arbeitsverzeichnis bereits auf den Basisinstallationsort gesetzt ist, und lediglich die zum Präfix relativen „ QT_DEPLOY_..._DIR “-Variablen verwenden.

Siehe auch QT_DEPLOY_SUPPORT, QT_DEPLOY_BIN_DIR, QT_DEPLOY_LIBEXEC_DIR, QT_DEPLOY_LIB_DIR, QT_DEPLOY_PLUGINS_DIR, QT_DEPLOY_QML_DIR und QT_DEPLOY_TRANSLATIONS_DIR.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.