aarch64 linux 安装pyside

### 如何在 aarch64 架构的 Linux 系统中安装 PySide #### 已知环境准备 为了成功安装 PySide，在 aarch64 的 Linux 系统上需要确保开发工具链已正确配置。例如，对于基于 Arch Linux 的发行版，可以使用 `pacman` 来安装必要的软件包[^1]。 ```bash sudo pacman -S python pyside6 pycharm-community-edition ``` 如果目标是安装 PySide2，则可以通过 Python 的官方资源获取支持的二进制文件或源码编译方式来完成安装[^2]。 --- #### 安装步骤说明 ##### 方法一：通过 pip 安装预构建的 PySide 软件包 PySide 提供了针对不同平台优化过的轮子（wheels），可以直接通过 `pip` 下载并安装： ```bash pip install PySide6 ``` 需要注意的是，某些情况下可能由于硬件架构差异导致无法找到适合 aarch64 平台的 wheel 文件。此时可尝试从源码进行编译安装。 --- ##### 方法二：从源码编译安装 PySide 当预构建版本不可用时，可以从源码自行编译适用于特定系统的 PySide 库。以下是具体操作流程： 1. **克隆仓库** 首先从 Qt 官方 GitHub 仓库下载最新版本的 PySide 源代码： ```bash git clone https://code.qt.io/pyside/pyside-setup.git cd pyside-setup ``` 2. **创建虚拟环境** 推荐在一个隔离环境中执行后续过程以避免污染全局 Python 环境。 ```bash python3 -m venv env_pyside source env_pyside/bin/activate ``` 3. **安装依赖项** 编译前需满足若干依赖条件，包括但不限于 CMake 和其他开发工具集。 ```bash sudo apt-get update && sudo apt-get install -y \ cmake \ libgl1-mesa-dev \ mesa-common-dev \ build-essential \ qtbase5-dev \ qtchooser \ qt5-qmake \ qttools5-dev-tools ``` 4. **运行构建脚本** 利用项目自带的 `setup.py` 开始编译工作，并指定自定义参数如 qmake 路径等。 ```bash python setup.py install --qmake=/usr/lib/qt5/bin/qmake --parallel=8 --build-tests ``` 上述命令中的选项含义分别为： - `--qmake`: 显式指明使用的 qmake 可执行路径； - `--parallel`: 控制并发线程数加速编译速度； - `--build-tests`: 同步生成测试套件以便验证功能完整性。 --- #### 处理常见问题 在实际部署过程中可能会遇到一些典型错误，比如缺少必要组件或者不兼容的内核版本等问题。下面列举几个解决方案作为参考： 1. **解决内核版本冲突** 如果发现当前系统所采用的内核与预期不符，应当调整至匹配的目标版本号。例如 iTOP-RK3568 设备推荐使用 kernel 4.19.232，其对应的十六进制表示形式为 `413E8` 或者十进制数值 `267240`[^3]。 修改 `/usr/local/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu/aarch64-linux-gnu/libc/usr/include/linux/version.h` 文件内的宏定义部分即可实现同步更新。 2. **修复打包后的程序崩溃现象** 当利用 pyinstaller 将含 PySide GUI 组件的应用导出成独立可执行体之后，往往会出现启动失败的情况。这主要是因为缺失了一些额外的支持性动态链接库所致[^4]。 此类情形可通过两种途径加以缓解： - 手动拷贝所需共享对象到最终产物所在位置； ```bash cp -r $(find / -name "qtwebengine_locales") ./dist/app/ cp -r $(find / -name "platforms") ./dist/app/ find / -name "*.so*" | grep resources | xargs -I {} cp {} ./dist/app/ ``` - 借助 pyinstaller 自身的数据注入机制预先嵌入这些资产； ```python from PyInstaller.utils.hooks import collect_data_files datas = [] hiddenimports = ["shiboken2"] # 添加 qtwebengine_locales 目录及其内容 locales_path = "/path/to/qtwebengine_locales" datas += [(locales_path, 'qtwebengine_locales')] # 加入 platforms 子目录结构 platform_dir = "/path/to/platforms" datas += [(platform_dir, 'platforms')] ``` --- #### 总结 综上所述，在 aarch64 类型的 Linux 发行版里布置好完整的 PySide 运行环境并非难事，只需按照既定指南逐步推进便可顺利完成任务。无论是借助现成分发包还是亲手打造专属实例都能达成目的。