在Firefly RK3399 ProC上手动编译PyQt5 5.15.2：解决ARM64平台pip安装无whl包的终极方案-开发者社区

在Firefly RK3399 ProC上手动编译PyQt5 5.15.2：解决ARM64平台pip安装无whl包的终极方案

当你在Firefly RK3399 ProC这类ARM64架构的开发板上尝试用pip安装PyQt5时，终端里那行"Could not find a version that satisfies the requirement PyQt5"的报错信息，恐怕是每个嵌入式Python开发者都经历过的噩梦。这不是你的操作有问题，而是PyPI官方源中确实缺少针对aarch64架构的预编译whl包。本文将带你深入问题本质，并提供一个经过实战验证的完整解决方案——从源码手动编译PyQt5 5.15.2。

1. 问题诊断与环境准备

1.1 为什么pip安装会失败？

在x86架构的PC上，pip install PyQt5能轻松完成安装，是因为PyPI仓库提供了预编译的wheel包。但到了ARM64平台，情况截然不同：

官方仓库空缺：Riverbank Computing未提供ARM架构的预编译包
第三方源风险：某些非官方源可能提供兼容性存疑的二进制包
系统包局限：apt-get install python3-pyqt5会安装到系统目录，导致虚拟环境无法调用

1.2 开发板环境确认

在开始编译前，请确保你的Firefly RK3399 ProC满足以下基础环境：

# 检查系统架构 uname -m # 预期输出：aarch64 # 查看Ubuntu版本 lsb_release -a # 建议使用Ubuntu 18.04/20.04 LTS # 确认Python版本 python3 --version # 需要Python 3.6+ (本文以Python 3.7为例)

1.3 必备依赖安装

执行以下命令安装基础编译工具链：

sudo apt-get update sudo apt-get install -y \ build-essential \ cmake \ git \ libgl1-mesa-dev \ libgles2-mesa-dev \ libqt5opengl5-dev \ qt5-default \ qtbase5-dev \ qtchooser \ qtdeclarative5-dev

注意：qt5-default包提供了关键的qmake工具，这是后续PyQt5配置阶段必需的组件。

2. 构建隔离的Python环境

2.1 创建虚拟环境

为避免污染系统Python环境，建议使用virtualenv创建隔离空间：

python3 -m pip install --upgrade pip virtualenv python3 -m virtualenv pyqt5_env --python=python3.7 source pyqt5_env/bin/activate

2.2 环境验证

激活虚拟环境后，应看到终端提示符变化：

(pyqt5_env) user@firefly:~$ pip list Package Version ---------- ------- pip 21.3.1 setuptools 59.2.0 wheel 0.37.0

3. SIP编译：PyQt5的基础支撑

3.1 获取正确版本的SIP

PyQt5与SIP版本存在严格对应关系，从Riverbank官网下载匹配组合：

wget https://www.riverbankcomputing.com/static/Downloads/sip/4.19.25/sip-4.19.25.tar.gz tar xzf sip-4.19.25.tar.gz cd sip-4.19.25

3.2 配置与编译参数

针对ARM64平台需要特别指定安装路径：

python configure.py --sip-module=PyQt5.sip \ --bindir=$VIRTUAL_ENV/bin \ --incdir=$VIRTUAL_ENV/include \ --destdir=$VIRTUAL_ENV/lib/python3.7/site-packages

关键参数说明：

参数	作用	ARM64注意事项
`--bindir`	安装sip工具位置	必须指向虚拟环境内
`--incdir`	头文件位置	避免系统目录冲突
`--destdir`	Python包安装路径	确保虚拟环境可访问

3.3 并行编译与安装

利用开发板的四核CPU加速编译：

make -j4 && make install

编译完成后验证：

(pyqt5_env) $ sip --version 4.19.25

4. PyQt5源码编译实战

4.1 获取PyQt5源码包

下载与SIP版本匹配的PyQt5源码：

wget https://www.riverbankcomputing.com/static/Downloads/PyQt5/5.15.2/PyQt5-5.15.2.tar.gz tar xzf PyQt5-5.15.2.tar.gz cd PyQt5-5.15.2

4.2 关键配置选项

运行configure.py时需特别注意：

python configure.py --confirm-license \ --qmake $(which qmake) \ --disable=QtNfc \ --disable=QtBluetooth \ --no-designer-plugin \ --no-qml-plugin

选项优化说明：

--disable=QtNfc：禁用嵌入式开发板通常不需要的NFC模块
--no-designer-plugin：减少不必要的Qt Designer组件
--qmake：显式指定系统qmake路径

4.3 编译过程优化

针对RK3399 ProC的编译技巧：

内存管理：

export MAKEFLAGS="-j2" # 限制并行任务防止OOM

交换空间：

sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile

模块选择：编辑Qt_modules.cfg文件，仅保留必需模块：
```
QtCore = y QtGui = y QtWidgets = y QtNetwork = n # 按需启用
```

4.4 常见编译错误解决

错误1：GL/gl.h: No such file

sudo apt-get install libgl1-mesa-dev libgles2-mesa-dev

错误2：lrelease not found

sudo apt-get install qttools5-dev-tools

错误3：arm64架构识别错误

在configure.py中添加架构检测补丁：

elif platform.machine() == 'aarch64': plat_name = 'linux-aarch64-g++'

5. 虚拟环境集成与测试

5.1 环境变量配置

在虚拟环境的activate脚本末尾添加：

export QT_PLUGIN_PATH="$VIRTUAL_ENV/lib/python3.7/site-packages/PyQt5/Qt/plugins" export QML2_IMPORT_PATH="$VIRTUAL_ENV/lib/python3.7/site-packages/PyQt5/Qt/qml"

5.2 功能验证测试

创建测试脚本pyqt5_test.py：

import sys from PyQt5.QtWidgets import QApplication, QLabel app = QApplication(sys.argv) label = QLabel("<h1>PyQt5 on RK3399 ProC</h1>") label.setStyleSheet("font-size: 24px; color: #2e86c1;") label.show() sys.exit(app.exec_())

运行测试：