Windows上的入门#

Qt库必须使用与Python和PySide相同的MSVC版本构建,这可以在使用在线安装程序时选择。

需求#

  • MSVC2022 或 (MSVC2019) 用于Windows上的Python 3,

  • OpenSSL(可选的SSL支持,Qt必须使用相同的SSL库配置)。

  • 文档的sphinx包(可选)。

  • 检查Windows上的Qt的平台依赖。

注意

Microsoft Store提供的Python与PySide不兼容。请使用https://www.pythonlang.cn/downloads/获取Python解释器。

Windows 10上从源编织#

创建虚拟环境#

venv模块允许您创建Python环境的本地、可写入副本,其中可以安装任意模块,并且在使用后可以删除。

python -m venv testenv
call testenv\Scripts\activate

这将创建并使用一个新的虚拟环境,命令提示符的变化将指示其改变。

设置CLANG#

可以从Qt服务器下载libclang,例如,libclang-release_140-based-windows-vs2019_64.7z

请注意,自版本12起,来自LLVM的预构建Windows二进制文件不再包含CMake配置文件;因此,它们不能再使用。

提取文件,并将其放置在任何所需的路径上,例如,c:,并设置所需的环境变量

set LLVM_INSTALL_DIR=c:\libclang
set PATH=C:\libclang\bin;%PATH%

获取PySide#

可以通过以下方式克隆官方仓库:

git clone https://code.qt.io/pyside/pyside-setup

检出我们想要构建的版本,例如,6.5

cd pyside-setup && git checkout 6.5

安装通用依赖项

pip install -r requirements.txt

注意

请注意,您需要使用与您的Qt安装相同的版本

构建PySide#

检查您的Qt安装路径,以特别使用该版本的qtpaths来构建PySide。例如,C:\Qt\6.5.0\msvc2019_64\bin\qtpaths.exe

构建可能需要几分钟,因此建议使用多个CPU核心

python setup.py build --qtpaths=c:\path\to\qtpaths.exe --openssl=c:\path\to\openssl\bin --build-tests --ignore-git --parallel=8

创建调试构建#

  • 安装Python时选择自定义安装,并勾选调试二进制文件和库的选项

  • 使用venv创建虚拟环境并传递调试二进制文件

    python_d.exe -m venv testenv_d
    
  • 使用python_d.exe来调用setup.py

注意

确保你在python setup.py install中添加--debug选项以生成调试构建

安装 PySide

要在此目录下安装,只需运行

python setup.py install --qtpaths=c:\path\to\qtpaths.exe  --openssl=c:\path\to\openssl\bin --build-tests --ignore-git --parallel=8

测试安装#

您可以执行其中一个示例来验证过程是否正常工作。请记住正确设置 Qt 和 PySide 的环境变量

python examples/widgets/widgets/tetrix.py