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_140-based-linux-Rhel8.2-gcc9.2-x86_64.7z

提取文件，将其放置在任意路径，并设置所需的环境变量。

7z x libclang-release_140-based-linux-Rhel8.2-gcc9.2-x86_64.7z
export LLVM_INSTALL_DIR=$PWD/libclang

获取源代码

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

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

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

cd pyside-setup && git checkout 6.5

安装通用依赖项

pip install -r requirements.txt

注意

请记住，您需要使用与Qt安装相同的版本。另外，如果您想要在该版本上工作，使用 git checkout -b 6.5 --track origin/6.5 选项可能更好。

构建和安装（setuptools）

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

检查您的Qt安装路径，以特定使用该版本的 qtpaths 构建 PySide。例如，/opt/Qt/6.5.0/gcc_64/bin/qtpaths。

构建可能需要几分钟，因此建议使用多核CPU。

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

要在当前目录中安装，只需运行：

python setup.py install --qtpaths=/opt/Qt/6.5.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.py