pyside6-qml

pyside6-qml 通过直接调用 QQmlEngine/QQuickView 来模拟 Qt 的 qml 运行时工具的一些功能。它使得使用 QML/QtQuick 进行原型设计成为可能，而无需编写任何通过 QQmlApplicationEngine 或 QQuickView 类加载 QML 文件的 Python 代码。该工具还检测在 Python 中实现的 QML 类，并将它们注册到 QML 类型系统中。

用法

考虑示例 Extending QML - Plugins Example。此示例没有包含初始化 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 有两个内置配置 - default 和 resizeToItem。有关更多信息，请参阅选项 --config。

  • –gles: 强制使用GLES (AA_UseOpenGLES)。

  • –desktop: 强制使用桌面版OpenGL (AA_UseDesktopOpenGL)。

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

  • –disable-context-sharing: 禁用QtQuick窗口使用共享的GL上下文。