qt_deploy_qt_conf

Créer un fichier qt.conf au moment du déploiement.

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

find_package(Qt6 REQUIRED COMPONENTS Core)

Contrairement à la plupart des autres commandes CMake fournies par Qt, qt_deploy_qt_conf() ne peut être appelée qu'à partir d'un script de déploiement. Elle ne peut pas être appelée directement par le projet.

Cette commande a été introduite dans Qt 6.3.

Syntaxe

qt_deploy_qt_conf(file_path
    [PREFIX prefix]
    [DOC_DIR doc_dir]
    [HEADERS_DIR headers_dir]
    [LIB_DIR lib_dir]
    [LIBEXEC_DIR libexec_dir]
    [BIN_DIR bin_dir]
    [PLUGINS_DIR plugins_dir]
    [QML_DIR qml_dir]
    [ARCHDATA_DIR archdata_dir]
    [DATA_DIR data_dir]
    [TRANSLATIONS_DIR translations_dir]
    [EXAMPLES_DIR examples_dir]
    [TESTS_DIR test_dir]
    [SETTINGS_DIR settings_dir]
)

Description

Utilisez cette commande lorsque vous devez générer un fichier qt.conf lors du déploiement. La valeur par défaut de tout chemin pris en charge par qt.conf peut être remplacée par l’option ..._DIR correspondante. La commande n’écrira un chemin vers le fichier qt.conf généré que s’il diffère de la valeur par défaut. Les valeurs par défaut sont disponibles à la section Remplacement des chemins.

L’argument file_path attend un chemin absolu vers l’emplacement où le fichier qt.conf doit être écrit. Les variables QT_DEPLOY_PREFIX et QT_DEPLOY_BIN_DIR peuvent être utilisées pour spécifier dynamiquement un chemin relatif au répertoire binaire de déploiement, comme le montre l’exemple ci-dessous. Cela permet d’éviter de coder en dur un chemin absolu.

Exemple

# The following script must only be executed at install time
qt_policy(SET QTP0008 NEW)

qt_generate_deploy_script(
    OUTPUT_SCRIPT deploy_script
    CONTENT "
qt_deploy_qt_conf(\"\${QT_DEPLOY_PREFIX}/\${QT_DEPLOY_BIN_DIR}/qt.conf\"
    DATA_DIR \"./custom_data_dir\"
    TRANSLATIONS_DIR \"./custom_translations_dir\"
)
")

install(SCRIPT ${deploy_script})