QT_DEPLOY_QML_DIR

Sous-répertoire relatif au préfixe pour le déploiement des plugins QML sur certaines plateformes cibles.

Cette variable est définie par le script dont le nom est spécifié par QT_DEPLOY_SUPPORT. Elle ne doit être utilisée que dans le cadre du déploiement lors de l'installation ou d'une règle post-compilation.

Cette variable a été introduite dans Qt 6.3.

Les projets doivent utiliser QT_DEPLOY_QML_DIR dans leurs scripts de déploiement afin d’éviter de coder en dur un répertoire particulier sous lequel déployer les modules QML.

QT_DEPLOY_QML_DIR La valeur par défaut est qml. Pour modifier la valeur de QT_DEPLOY_QML_DIR, définissez-la dans le script de déploiement du projet avant d’inclure QT_DEPLOY_SUPPORT.

Le chemin QT_DEPLOY_QML_DIR est relatif à QT_DEPLOY_PREFIX.

Cette variable n’a pas de sens lors du déploiement dans un bundle d’application macOS et ne doit pas être utilisée dans ce cas de figure. Les directives d’Apple relatives aux bundles d’applications macOS exigent que tous les plugins soient déployés dans le sous-répertoire PlugIns du contenu du bundle, et que tous les autres fichiers non binaires se trouvent généralement dans le sous-répertoire Resources. Les différentes parties d’un module QML doivent donc être déployées à des emplacements distincts au sein du bundle d’application.

Exemple

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})