PySide6-QML#

pyside6-qml通过直接调用QQmlEngine/QQuickView来模拟Qt的qml运行时工具的一些功能。它允许在不编写加载QML文件（无论是通过QQmlApplicationEngine或QQuickView类）的任何Python代码的情况下进行原型设计。该工具还可以检测实现于Python中的QML类，并将它们注册到QML类型系统中。

用法#

考虑以下示例 扩展QML - 插件示例。本例没有包含初始化QmlEngine并加载QML文件 app.qml 的 main 函数的Python文件。您可以通过以下命令运行此示例：

pyside6-qml examples/qml/tutorials/extending-qml/chapter6-plugins/app.qml -I examples/qml/tutorials/extending-qml/chapter6-plugins/Charts

-I标志用于将 pyside6-qml 指向包含实现QML类的Python文件所在的文件夹。

命令行选项#

以下是 pyside6-qml 的所有命令行选项。

参数#

  • file：此选项指代由 pyside6-qml 加载的QML文件。此选项没有名称或标识符。因此，此选项应该是提供给 pyside6-qml 的第一个选项。例如：

pyside6-qml /path/to/test.qml

选项#

  • –module-paths/-I：指定由空格分隔的文件夹/文件路径，这些路径指向实现QML类的Python文件。默认情况下，搜索递归查找提供给 pyside6-qml 的QML文件的父目录下的所有Python文件并将它们导入。否则，仅搜索模块路径中给出的路径。

  • –verbose/-v：在详细模式下运行 pyside6-qml。在此模式下，pyside6-qml将在处理的不同阶段打印日志消息。

与QML运行时工具相对应的选项#

  • –app-typ/-a：指定要使用哪个应用程序类。它可以取三个值之一 - core, gui, widget。默认值为 gui。

  • –config/-c：加载给定的内置配置。它可以是两个值之一 - default, resizeToItem。此选项仅适用于QtQuick应用。如果使用 default，则视口将调整大小以适应QML中的根项的尺寸。如果使用 resizeToItem，则视口将自动调整根项的大小以适应视口。

  • –list-conf：列出内置配置。pyside6-qml有两个内置配置 - default 和 resizeToItem。有关更多信息，请参阅--config选项。

  • –rhi/-r：指定Qt图形抽象层（RHI）的后端。它可以是以下四个值之一 - vulkan, metal, d3dll, gl。

  • –verbose/-v：列出内置配置。pyside6-qml有两个内置配置 - 默认 和 resizeToItem。有关更多信息，请参阅--config选项。

  • –gles：强制使用GLES（AA_UseOpenGLES）。

  • –desktop：强制使用桌面OpenGL（AA_UseDesktopOpenGL）。

  • –software：强制使用软件渲染(AA_UseSoftwareOpenGL)。

  • –disable-context-sharing：禁用QtQuick Windows的共享GL上下文的使用。