QT_DEPLOY_QML_DIR

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

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.

Diese Variable wurde in Qt 6.3 eingeführt.

Projekte sollten in ihren Bereitstellungsskripten „ QT_DEPLOY_QML_DIR “ verwenden, um eine feste Programmierung eines bestimmten Verzeichnisses zu vermeiden, in dem QML-Module bereitgestellt werden sollen.

QT_DEPLOY_QML_DIR Der Standardwert ist ` qml`. Um den Wert von ` QT_DEPLOY_QML_DIR` zu ändern, legen Sie ihn im Bereitstellungsskript des Projekts fest, bevor ` QT_DEPLOY_SUPPORT ` eingebunden wird.

Der Pfad „ QT_DEPLOY_QML_DIR “ ist relativ zu „QT_DEPLOY_PREFIX“.

Diese Variable ist bei der Bereitstellung in einem macOS-App-Bundle nicht relevant und sollte in diesem Szenario nicht verwendet werden. Die Richtlinien von Apple für macOS-App-Bundles verlangen, dass alle Plugins im Unterverzeichnis „ PlugIns “ des Bundle-Inhalts bereitgestellt werden, während alle anderen nicht-binären Dateien im Allgemeinen im Unterverzeichnis „ Resources “ abgelegt werden sollten. Die verschiedenen Teile eines QML-Moduls müssen daher an unterschiedlichen Orten innerhalb des App-Bundles bereitgestellt werden.

Beispiel

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

find_package(Qt6 REQUIRED COMPONENTS Quick)
qt_standard_project_setup()

qt_add_executable(MyApp main.cpp)
qt_add_qml_module(MyApp
    URI myapp
    QML_FILES main.qml
)

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

set(QT_DEPLOY_QML_DIR \"myqmldir\")

include(\"${QT_DEPLOY_SUPPORT}\")

qt_deploy_qml_imports(
    TARGET MyApp
    PLUGINS_FOUND plugins_found
)
qt_deploy_runtime_dependencies(
    EXECUTABLE \"\${QT_DEPLOY_BIN_DIR}/$<TARGET_FILE_NAME:MyApp>\"
    ADDITIONAL_MODULES \${plugins_found}
)")

install(SCRIPT ${deploy_script})