QT_DEPLOY_PREFIX

デプロイのベースとなる場所。

この変数は、QT_DEPLOY_SUPPORT で指定されたスクリプトによって定義されます。この変数は、インストール時のデプロイメントまたはビルド後ルールの一環としてのみ使用してください。

注:これは 低レベルのデプロイ API 変数であり、qt_generate_deploy_app_script などの高レベルな API コマンドでは対応できない、高度なユースケースでのみ使用してください。

この変数は Qt 6.3 で導入されました。

QT_DEPLOY_PREFIX デプロイのベースディレクトリを指定します。他のQT_DEPLOY_..._DIR 変数は、この場所を基準として扱われるものとします。QT_DEPLOY_PREFIX の値は相対パスでも絶対パスでもあり得るため、プロジェクト側では特定の状況においてどちらか一方を前提にしてはなりません。 相対パスは、インストール時にビルドツール(ninja、make など)から見て、現在の作業ディレクトリを基準とするものとみなされます。

デフォルト値は$ENV{DESTDIR}${CMAKE_INSTALL_PREFIX} であり、これは CMake がインストール時に使用するベースディレクトリです。 これが空の文字列として評価される場合、デフォルト値は代わりにドット (.) になります。これは、ポストビルドルールの一部としてデプロイする場合、一般的に適切な値です。この 2 段階のフォールバックロジックにより、プロジェクトはQT_DEPLOY_PREFIX が空の文字列ではないと想定できるため、${QT_DEPLOY_PREFIX}/${QT_DEPLOY_BIN_DIR} のようなパスの一部として安全に使用できます。

QT_DEPLOY_PREFIX の値を変更するには、「コマンドラインでのcmakeの呼び出し」に記載されているように、プロジェクトでカスタムCMAKE_INSTALL_PREFIXを設定します。

また、環境変数DESTDIRを使用することで、最終的なインストール先、ひいてはデプロイ先を変更することもできます。

プロジェクトでこの変数を使用する必要が生じることはほとんどありません。一般的なシナリオでは、デプロイスクリプトは作業ディレクトリがすでにベースのインストール場所に設定されていることを前提とし、プレフィックスを基準としたQT_DEPLOY_..._DIR 変数を使用するだけで済みます。

QT_DEPLOY_SUPPORT、QT_DEPLOY_BIN_DIR、QT_DEPLOY_LIBEXEC_DIR、QT_DEPLOY_LIB_DIR、QT_DEPLOY_PLUGINS_DIR、QT_DEPLOY_QML_DIR、およびQT_DEPLOY_TRANSLATIONS_DIRも参照してください。

© 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.