PyQt Designer和QML插件
项目描述
PyQt6的wheel不提供Qt Designer等工具,这些工具曾包含在旧的二进制安装程序中。本软件包旨在提供这些工具,以便在单独的包中使用,而官方PyQt6 wheel则专注于满足PyQt6应用程序的依赖项。
支持Windows和Linux。如果将在Linux而不是Windows上应用以下说明,请相应地调整路径等。macOS支持不完整,但如有兴趣讨论,请参阅 问题#12。
安装
yourenv/Scripts/pip.exe install pyqt6-tools~=6.4
通常使用 pip install 安装pyqt6-tools。在大多数情况下,您应使用 virtualenv 或 venv 创建隔离环境以安装依赖项。上述命令假定在目录 yourenv 中有一个环境。 ~=6.4 指定与6.4兼容的版本,这是为PyQt6 6.4构建的pyqt6-tools的最新版本。如果您使用的是不同的PyQt6版本,请指定它而不是6.4。PyPI保留了一个所有可用版本的列表。
- 注意
从pyqt6-tools v3版本开始,该软件包已被拆分为四个部分。包装器仍然在这里,但插件位于pyqt6-plugins中,一些Qt应用程序辅助工具在qt6-tools中,应用程序在qt6-applications中。
使用方法
提供了一个程序,可用作Scripts/pyqt6-tools.exe。为Designer、QML场景和QML测试运行器提供了子命令。这些包装器命令提供了与启动底层程序相关的附加功能。更大的Qt应用程序集作为Scripts/qt6-tools.exe程序的下级命令可用。在两种情况下,传递--help将列出可用的子命令。
此外,下面列出的每个pyqt6-tools子命令都包括一个参数来运行一个基本示例,用于检查插件是否工作。这些示例不是作为良好代码示例的意图。
每个子命令都会从您的当前工作目录向上搜索文件系统树,以找到.env文件并在找到时加载它。如果找到,环境变量DOT_ENV_DIRECTORY将设置为包含.env文件的目录。使用这个额外的变量,您可以根据.env位置指定路径。
PYQTDESIGNERPATH=${PYQTDESIGNERPATH};${DOT_ENV_DIRECTORY}/path/to/my/widgets
Designer
有一个Scripts/pyqt6-tools.exe designer.exe入口点,可以帮助从命令行参数或.env文件填充PYQTDESIGNERPATH。未知参数将传递给原始Qt Designer程序。
Usage: pyqt6-tools designer [OPTIONS]
Options:
-p, --widget-path DIRECTORY Paths to be combined with PYQTDESIGNERPATH
--example-widget-path Include the path for the pyqt6-tools example
button (c:\users\sda\testenv\lib\site-
packages\pyqt6_plugins)
--designer-help Pass through to get Designer's --help
--test-exception-dialog Raise an exception to check the exception
dialog functionality.
--qt-debug-plugins / --no-qt-debug-plugins
Set QT_DEBUG_PLUGINS=1
--help Show this message and exit.
如果您想从Designer中查看生成的代码,可以运行Scripts/pyqt6-tools.exe installuic,它将复制pyuic6.exe,这样Designer就会使用它并显示生成的Python代码。请注意,这将启用使用C++菜单项进行查看,而Python菜单项将损坏。如果没有进行此调整,C++选项显示C++代码,而Python选项显示PySide2代码。pyqt6必须已经安装,否则此脚本将无法找到要复制的原始pyuic6.exe。
除了官方Designer插件的标准功能外,这还提供了一个异常对话框供您的Python代码使用。否则,Designer在Windows上遇到Python异常时会静默崩溃。
QML插件
QML插件也已包含在内。将来可能会提供工具来处理将插件复制到需要它的每个目录。目前,这必须手动完成。
site-packages/pyqt6_tools/Qt/bin/plugins/pyqt6qmlplugin.dll
QML场景
Usage: pyqt6-tools qmlscene [OPTIONS]
Options:
-p, --qml2-import-path DIRECTORY
Paths to be combined with QML2_IMPORT_PATH
--qmlscene-help Pass through to get QML scene's --help
--qt-debug-plugins / --no-qt-debug-plugins
Set QT_DEBUG_PLUGINS=1
--run-qml-example Run the pyqt6-tools QML example
--help Show this message and exit.
QML测试运行器
Usage: pyqt6-tools qmltestrunner [OPTIONS]
Options:
-p, --qml2-import-path DIRECTORY
Paths to be combined with QML2_IMPORT_PATH
--qmltestrunner-help Pass through to get QML test runner's --help
--qt-debug-plugins / --no-qt-debug-plugins
Set QT_DEBUG_PLUGINS=1
--test-qml-example Test the pyqt6-tools QML example
--help Show this message and exit.
特别感谢
感谢MacStadium为我提供了一个用于开发和测试最终pyqt6-tools平台的macOS系统。这仍然是“正在进行中”。请参阅问题#12。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。
源分发
构建分发
pyqt6_tools-6.4.2.3.3-py3-none-any.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | dfeea682e64fb757f447328742402682eaba9784faf25ceedbd6e38e3d8871b7 |
|
MD5 | f0e3ccc4379a1dfbf2c0382e7725ae4d |
|
BLAKE2b-256 | 82bcdcea094a26697ba76ae73dec030dd4070836b1e7e810d304d4917518423b |