qt_deploy_qt_conf

Ecrire un fichier qt.conf au moment du déploiement.

La commande est définie dans le composant Core du paquetage Qt6, qui peut être chargé de cette manière :

find_package(Qt6 REQUIRED COMPONENTS Core)

Contrairement à la plupart des autres commandes CMake fournies par Qt XML, qt_deploy_qt_conf() ne peut être appelé 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.

Synopsis

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 de la commande

Utilisez cette commande lorsque vous avez besoin de générer un fichier qt.conf pendant le 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 dans le fichier qt.conf généré que s'il diffère de la valeur par défaut. Les valeurs par défaut peuvent être consultées à l'adresse suivante : Overriding Paths (en anglais).

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