Windows

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

需求

  • MSVC2022 用于 Windows 上的 Python 3，

  • OpenSSL（可选用于SSL支持，Qt必须已使用相同的SSL库进行配置）。

  • sphinx 用于文档的包（可选）。

  • 检查Qt for Windows的平台依赖项。

注意

微软商店提供的Python与PySide不兼容。请使用https://www.python.org/downloads/获取Python解释器。

在Windows 10上从源代码构建

创建虚拟环境

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

python -m venv testenv
call testenv\Scripts\activate

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

设置CLANG

libclang 可以从 Qt 服务器下载。 例如，libclang-release_18.1.5-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.8：

cd pyside-setup && git checkout 6.8

安装通用依赖项：

pip install -r requirements.txt

用于构建文档：

pip install -r requirements-doc.txt

注意

请记住，您需要使用与您的Qt安装相同的版本

构建PySide

检查您的Qt安装路径，以专门使用该版本的qtpaths来构建PySide。 例如，C:\Qt\6.8.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/tetrix.py