qt_generate_deploy_script

生成自定义部署脚本。

此命令定义在Qt6包的Core组件中，可以通过以下方式加载：

find_package(Qt6 REQUIRED COMPONENTS Core)

此命令是在Qt 6.5中引入的。

摘要

qt_generate_deploy_script(
    OUTPUT_SCRIPT <var>
    [TARGET target]
    [NAME script_name]
    [CONTENT content]
)

如果禁用了无版本命令，则使用qt6_generate_deploy_script()代替。它支持与该命令相同的参数集。

描述

该命令生成一个脚本，其完整文件路径将存储在名为OUTPUT_SCRIPT的变量中。该脚本仅在CMake生成时编写。它打算与install(SCRIPT)命令一起使用，该命令应该在应用程序的目标安装到使用install(TARGETS)之后。

该命令负责生成适合多配置生成器的文件名。添加必要的包含语句，以便Qt的CMake部署函数和变量可用。

TARGET参数指定了将由脚本部署的目标。除非指定NAME，否则它会影响生成的脚本文件名。

NAME参数控制部署脚本自动生成的名称中的可识别部分。NAME参数默认为custom，如果既没有提供NAME也没有提供TARGET。

CONTENT参数指定要将代码写入部署脚本的内容。内容可以包含生成器表达式。

该命令旨在生成调用Qt部署API函数的直接自定义部署脚本。对于更简单的部署目的，使用qt_generate_deploy_app_script()或qt_generate_deploy_qml_app_script()更方便。

示例

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

find_package(Qt6 REQUIRED COMPONENTS Core)
qt_standard_project_setup()

qt_add_executable(MyApp main.cpp)

install(TARGETS MyApp
    BUNDLE  DESTINATION .
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)

qt_generate_deploy_script(
    TARGET MyApp
    OUTPUT_SCRIPT deploy_script
    CONTENT "
qt_deploy_runtime_dependencies(
    EXECUTABLE $<TARGET_FILE_NAME:MyApp>
)
")
install(SCRIPT ${deploy_script})

另请参阅qt_generatedeploy_app_script()和qt_generate_deploy_qml_app_script()。