QT_DEPLOY_PLUGINS_DIR

一部のターゲットプラットフォーム上でQtプラグインを展開するための、プレフィックスを基準としたサブディレクトリ。

この変数は、QT_DEPLOY_SUPPORT で指定されたスクリプトによって定義されます。これは、インストール時の展開処理、またはビルド後のルールの一環としてのみ使用すべきです。

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

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

プロジェクトでは、プラグインをデプロイする特定のディレクトリをハードコーディングしないよう、デプロイスクリプト内で `QT_DEPLOY_PLUGINS_DIR ` を使用する必要があります。

QT_DEPLOY_PLUGINS_DIR デフォルト値は `plugins` です。QT_DEPLOY_PLUGINS_DIR の値を変更するには、QT_DEPLOY_SUPPORT がインクルードされる前に、プロジェクトのデプロイスクリプトで設定してください。

QT_DEPLOY_PLUGINS_DIR のパスは、QT_DEPLOY_PREFIXを基準としています。

この変数は、macOSアプリバンドルへのデプロイ時には意味を持たないため、そのシナリオでは使用しないでください。AppleのmacOSアプリバンドルに関するガイドラインでは、すべてのプラグインをバンドルコンテンツ内のPlugIns サブディレクトリにデプロイすることが求められています。

例

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

# The following CMAKE_INSTALL_*DIR variables are used to initialize their
# QT_DEPLOY_*_DIR counterparts.
set(CMAKE_INSTALL_BINDIR "mybindir")
set(CMAKE_INSTALL_LIBDIR "mylibdir")
set(CMAKE_INSTALL_LIBEXECDIR "mylibexecdir")

find_package(Qt6 REQUIRED COMPONENTS Core)
qt_standard_project_setup()

qt_add_executable(MyApp main.cpp)

set(deploy_script "${CMAKE_CURRENT_BINARY_DIR}/deploy_MyApp.cmake")
file(GENERATE OUTPUT ${deploy_script} CONTENT "

set(QT_DEPLOY_PLUGINS_DIR \"mypluginsdir\")
set(QT_DEPLOY_TRANSLATIONS_DIR \"i18n\")

include(\"${QT_DEPLOY_SUPPORT}\")

qt_deploy_runtime_dependencies(
    EXECUTABLE \"\${QT_DEPLOY_BIN_DIR}/$<TARGET_FILE_NAME:MyApp>\"
)")

install(SCRIPT ${deploy_script})

関連項目： QT_DEPLOY_SUPPORT、QT_DEPLOY_PREFIX、QT_DEPLOY_BIN_DIR、QT_DEPLOY_LIBEXEC_DIR、QT_DEPLOY_LIB_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.