Linux

需求

  • GCC

  • sphinx 用于文档的包(可选)。

  • 根据您的Linux发行版,可能还需要以下依赖项:

    • libgl-dev, python-dev, 和 python-setuptools.

  • 检查Qt for Linux/X11的平台依赖项。

从源代码构建

创建虚拟环境

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

python -m venv testenv
source testenv/bin/activate

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

设置CLANG

如果您的系统中还没有libclang,您可以从Qt服务器下载:

wget https://download.qt.io/development_releases/prebuilt/libclang/libclang-release_18.1.5-based-linux-Rhel8.6-gcc10.3-x86_64.7z

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

7z x libclang-release_18.1.5-based-linux-Rhel8.6-gcc10.3-x86_64.7z
export LLVM_INSTALL_DIR=$PWD/libclang

获取源代码

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

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安装相同的版本。 此外,git checkout -b 6.8 --track origin/6.8 可能是更好的选择, 如果您想继续处理它。

构建和安装 (setuptools)

setuptools 方法使用 setup.py 文件来执行构建、安装和打包步骤。

检查您的Qt安装路径,以专门使用该版本的qtpaths来构建PySide。 例如,/opt/Qt/6.8.0/gcc_64/bin/qtpaths

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

python setup.py build --qtpaths=/opt/Qt/6.8.0/gcc_64/bin/qtpaths --build-tests --ignore-git --parallel=8

要在当前目录安装,只需运行:

python setup.py install --qtpaths=/opt/Qt/6.8.0/gcc_64/bin/qtpaths --build-tests --ignore-git --parallel=8

构建和安装 (cmake)

setuptools 方法在构建和安装项目时包括内部的 CMake 调用,但仅建议在打包项目进行分发构建时使用纯 CMake 方法。

假设 Qt 在 PATH 中,例如,配置步骤可以通过以下方式完成:

cmake -B /path/to/the/build/directory \
      -S /path/to/the/pyside-setup \
      -DCMAKE_INSTALL_PREFIX=/where/to/install \
      -DPython_EXECUTABLE=/path/to/interpreter

注意

如果你想构建一个与Python 3.7+兼容的版本,可以添加-DFORCE_LIMITED_API=yes

然后进行构建:

cmake --build /path/to/the/build/directory --parallel X

其中 X 是您想要使用的进程数量。 最后,安装步骤可以通过以下方式完成:

cmake --install /path/to/the/build/directory

注意

你可以通过使用不同的源目录和选项-S来仅构建pyside6或仅构建shiboken6。

测试安装

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

python examples/widgets/widgets/tetrix/tetrix.py