qt_am_add_systemui_wrapper

注意：此命令处于技术预览阶段，未来版本可能会更改。

概述

qt_am_add_systemui_wrapper(
    target
    [EXECUTABLE appman-executable]
    [MAIN_QML_FILE main.qml]
    [CONFIG_YAML config.yaml ...]
    [EXTRA_ARGS ...]
    [EXTRA_FILES ...]
    [EXTRA_FILES_GLOB ...]
    [INSTALL_DIR install-dir]
)

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

描述

在构建目录中生成一个.bat（Windows）或.sh（macOS、Linux）包装器，以便轻松运行由target引用的QML基于的系统UI，在桌面或Qt Creator中运行。它还会自动将从源代码到构建目录所需文件：这些是MAIN_QML_FILE、任何CONFIG_YAML文件以及所有EXTRA_FILES。

EXTRA_FILES中的任何目录都将递归复制。默认情况下，文件类型限于*.qml *.js qmldir *.json *.yaml *.png *.jpg *.svg，但您可以通过EXTRA_FILES_GLOB提供自定义glob模式（有关详细信息，请参阅CMake的file(GLOB)命令）。

如果还想让此命令自动生成所有文件的安装规则，您可以指定目标目录通过INSTALL_DIR。默认情况下，不会创建安装规则。

如果您想使用应用程序管理器的自定义构建，您可以通过使用EXECUTABLE来实现。否则，将使用当前Qt构建的appman二进制文件。

所有EXTRA_ARGS将在从包装器脚本运行EXECUTABLE时附加到命令行。

对于非常简单的设置，只需指定MAIN_QML_FILE就足够了。如果您已经有了一个am-config.yaml，您可以通过CONFIG_YAML引用它。如果您的main.qml已经在YAML配置文件中设置，则不需要在此再次指定。

警告：请注意，随着您项目的不断复杂化，此命令将无法扩展。它仅用于帮助您入门，而无需深入了解CMake。

示例

以下是从applicationmanager/minidesk示例的摘录，展示如何在那里使用此功能

qt6_am_add_systemui_wrapper(minidesk
    INSTALL_DIR "${INSTALL_EXAMPLEDIR}"
    CONFIG_YAML am-config.yaml
    EXTRA_FILES apps system-ui
    EXTRA_ARGS --verbose
)