qt_generate_deploy_script

Erzeugt ein benutzerdefiniertes Deployment-Skript.

Der Befehl ist in der Core Komponente des Qt6 Pakets definiert, das so geladen werden kann:

find_package(Qt6 REQUIRED COMPONENTS Core)

Dieser Befehl wurde in Qt 6.5 eingeführt.

Synopse

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

Wenn versionslose Befehle deaktiviert sind, verwenden Sie stattdessen qt6_generate_deploy_script(). Es unterstützt den gleichen Satz an Argumenten wie dieser Befehl.

Beschreibung

Der Befehl erzeugt ein Skript, dessen vollständiger Dateipfad in der durch die Option OUTPUT_SCRIPT benannten Variable gespeichert wird. Dieses Skript wird nur zur Zeit der CMake-Generierung geschrieben. Es ist für die Verwendung mit dem install(SCRIPT) -Befehl vorgesehen, der nach der Installation des Ziels der Anwendung mit install(TARGETS) erfolgen sollte.

Der Befehl erzeugt eine Datei, die für Multi-Config-Generatoren geeignet ist. Erforderliche Includes werden hinzugefügt, so dass die CMake-Deployment-Funktionen und -Variablen von Qt zugänglich sind.

Das Argument TARGET gibt das Ziel an, das vom Skript deployed wird. Dies wirkt sich auf den Dateinamen des generierten Skripts aus, sofern nicht NAME angegeben ist.

Das Argument NAME steuert einen identifizierbaren Teil des automatisch generierten Namens des Deployment-Skripts. Das Argument NAME ist standardmäßig auf custom gesetzt, wenn weder NAME noch TARGET angegeben werden.

Das Argument CONTENT gibt den Code an, der in das Deployment-Skript geschrieben wird. Der Inhalt kann Generatorausdrücke enthalten.

Dieser Befehl ist für die Erstellung von benutzerdefinierten Deployment-Skripten gedacht, die direkt Funktionen der Qt Deployment-API aufrufen. Für weniger komplexe Einsatzzwecke ist es bequemer, qt_generate_deploy_app_script() oder qt_generate_deploy_qml_app_script() zu verwenden.

Beispiel

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