qt_generate_deploy_script

Génère un script de déploiement personnalisé.

La commande est définie dans le composant Core du paquetage Qt6, qui peut être chargé comme suit :

find_package(Qt6 REQUIRED COMPONENTS Core)

Cette commande a été introduite dans Qt 6.5.

Synopsis

qt_generate_deploy_script(
    OUTPUT_SCRIPT <var>
    [TARGET target]
    [NAME script_name]
    [CONTENT content]
)

Si les commandes sans version sont désactivées, utilisez qt6_generate_deploy_script() à la place. Elle prend en charge le même ensemble d'arguments que cette commande.

Description de la commande

Cette commande génère un script dont le chemin complet sera stocké dans la variable nommée par l'option OUTPUT_SCRIPT. Ce script n'est écrit qu'au moment de la génération de CMake. Il est destiné à être utilisé avec la commande install(SCRIPT), qui doit intervenir après que la cible de l'application ait été installée avec install(TARGETS).

La commande se charge de générer un fichier nommé de manière appropriée pour les générateurs multi-config. Les includes nécessaires sont ajoutés afin que les fonctions et variables de déploiement CMake de Qt soient accessibles.

L'argument TARGET spécifie la cible qui sera déployée par le script. Cela affecte le nom de fichier du script généré, à moins que NAME ne soit spécifié.

L'argument NAME contrôle une partie identifiable du nom généré automatiquement par le script de déploiement. L'argument NAME prend par défaut la valeur custom si aucun des arguments NAME et TARGET n'est fourni.

L'argument CONTENT spécifie le code qui est écrit dans le script de déploiement. Le contenu peut contenir des expressions de générateur.

Cette commande est destinée à générer des scripts de déploiement personnalisés qui appellent directement des fonctions de l'API de déploiement de Qt. Pour des déploiements moins complexes, il est plus pratique d'utiliser qt_generate_deploy_app_script() ou qt_generate_deploy_qml_app_script().

Exemple

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

find_package(Qt6 REQUIRED COMPONENTS Core)
qt_standard_project_setup()

qt_add_executable(MyApp main.cpp)

install(TARGETS MyApp
    BUNDLE  DESTINATION .
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)

qt_generate_deploy_script(
    TARGET MyApp
    OUTPUT_SCRIPT deploy_script
    CONTENT "
qt_deploy_runtime_dependencies(
    EXECUTABLE $<TARGET_FILE:MyApp>
)
")
install(SCRIPT ${deploy_script})