QT_DEPLOY_PLUGINS_DIR

Präfix-relatives Unterverzeichnis für die Bereitstellung von Qt-Plugins auf einigen Zielplattformen.

Diese Variable wird durch das von QT_DEPLOY_SUPPORT benannte Skript definiert. Sie sollte nur als Teil der Bereitstellung während der Installation oder als Post-Build-Regel verwendet werden.

Diese Variable wurde in Qt 6.3 eingeführt.

Projekte sollten QT_DEPLOY_PLUGINS_DIR in ihren Deploy-Skripten verwenden, um zu vermeiden, dass ein bestimmtes Verzeichnis, in dem die Plugins bereitgestellt werden, fest kodiert wird.

QT_DEPLOY_PLUGINS_DIR ist standardmäßig auf den Wert plugins eingestellt. Um den Wert von QT_DEPLOY_PLUGINS_DIR zu ändern, setzen Sie ihn im Skript für die Projektbereitstellung, bevor QT_DEPLOY_SUPPORT eingebunden wird.

Der Pfad QT_DEPLOY_PLUGINS_DIR ist relativ zu QT_DEPLOY_PREFIX.

Diese Variable ist bei der Bereitstellung in einem macOS-App-Bundle nicht sinnvoll und sollte in diesem Szenario nicht verwendet werden. Apples Richtlinien für macOS-App-Bundles verlangen, dass alle Plugins im Unterverzeichnis PlugIns des Bundle-Inhalts bereitgestellt werden.

Beispiel

cmake_minimum_required(VERSION 3.16...3.22)
project(MyThings)

# The following CMAKE_INSTALL_*DIR variables are used to initialize their
# QT_DEPLOY_*_DIR counterparts.
set(CMAKE_INSTALL_BINDIR "mybindir")
set(CMAKE_INSTALL_LIBDIR "mylibdir")
set(CMAKE_INSTALL_LIBEXECDIR "mylibexecdir")

find_package(Qt6 REQUIRED COMPONENTS Core)
qt_standard_project_setup()

qt_add_executable(MyApp main.cpp)

set(deploy_script "${CMAKE_CURRENT_BINARY_DIR}/deploy_MyApp.cmake")
file(GENERATE OUTPUT ${deploy_script} CONTENT "

set(QT_DEPLOY_PLUGINS_DIR \"mypluginsdir\")
set(QT_DEPLOY_QML_DIR \"myqmldir\")
set(QT_DEPLOY_TRANSLATIONS_DIR \"i18n\")

include(\"${QT_DEPLOY_SUPPORT}\")

qt_deploy_runtime_dependencies(
    EXECUTABLE \"\${QT_DEPLOY_BIN_DIR}/$<TARGET_FILE_NAME:MyApp>\"
)")

install(SCRIPT ${deploy_script})