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