qt_deploy_qt_conf

デプロイ時に qt.conf ファイルを作成します。

このコマンドは、Qt6 パッケージのCore コンポーネントに定義されており、次のように読み込むことができます:

find_package(Qt6 REQUIRED COMPONENTS Core)

Qt が提供する他のほとんどの CMake コマンドとは異なり、qt_deploy_qt_conf() はデプロイメントスクリプトからのみ呼び出すことができます。プロジェクトから直接呼び出すことはできません。

このコマンドは Qt 6.3 で導入されました。

注: 通常、このコマンドを直接呼び出す必要はありません。このコマンドは、他の上位レベルのコマンドによって内部的に使用されますが、よりカスタマイズされたデプロイメントロジックを実装したいプロジェクトにとっては有用である可能性があります。

概要

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

説明

デプロイ中に`qt.conf` ファイルを生成する必要がある場合に、このコマンドを使用します。qt.conf でサポートされているパスのデフォルト値は、対応する `..._DIR ` オプションで上書きできます。このコマンドは、生成される `qt.conf ` ファイルへのパスがデフォルト値と異なる場合にのみ、そのパスを書き込みます。デフォルト値については、「パスの上書き」を参照してください。

file_path 引数には、qt.conf ファイルを書き込む先の絶対パスを指定する必要があります。QT_DEPLOY_PREFIXおよびQT_DEPLOY_BIN_DIR変数を使用すると、以下の例に示すように、デプロイ用バイナリディレクトリを基準とした相対パスを動的に指定できます。これにより、絶対パスのハードコーディングを回避できます。

例

注：以下の例では 、生成されたスクリプトの実行時に `${QT_DEPLOY_PREFIX} ` および `${QT_DEPLOY_BIN_DIR} ` が展開されることを想定しています。これは、QTP0008 が`NEW` に設定されている場合にのみ機能します。OLD の動作では、引数が転送される際に両方の参照が展開されるため、生成されたスクリプトには最終的に `qt_deploy_qt_conf("//qt.conf")` が含まれることになります。

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

qt_generate_deploy_app_script()、qt_deploy_runtime_dependencies()、およびQTP0008も参照してください。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.