瑞芯微RK3588 Qt（Debian/Ubuntu）交叉编译完整步骤及建议

RK3588 开发板部署 Qt 环境，主流有板端直接安装（简单）、PC 交叉编译（常用）、SDK 自带 Qt（最稳）三种方案。以下是完整、可落地的步骤。

一、板端（开发板）直接安装 Qt（Debian/Ubuntu）

适合快速验证、小项目、直接在板上开发。

1.1 安装 Qt5 运行 / 开发库

sudo apt update

sudo apt install -y \

qt5-default \

qtbase5-dev \

qtdeclarative5-dev \

qtquickcontrols2-5-dev \

qttools5-dev-tools \

qtcreator \

libqt5multimedia5 \

libqt5svg5

1.2 配置环境变量（解决无法显示）

vi ~/.bashrc

添加：

export QT_QPA_PLATFORM=xcb# X11桌面

# export QT_QPA_PLATFORM=eglfs# 无桌面/纯EGL（推荐RK3588 GPU）

export QT_QPA_PLATFORM_PLUGIN_PATH=/usr/lib/aarch64-linux-gnu/qt5/plugins

export LD_LIBRARY_PATH=/usr/lib/aarch64-linux-gnu:$LD_LIBRARY_PATH

生效：

source ~/.bashrc

1.3 测试

qmake -v

# 显示 Qt version 5.15.2 or 5.15.8...

运行 Qt Creator：

qtcreator

二、PC（Ubuntu）交叉编译环境（推荐）

2.1 准备

宿主机：Ubuntu 20.04 / 22.04

RK3588 SDK（含 aarch64 交叉编译器、sysroot）

开发板与 PC 同网段、SSH 可登录（root / 密码）

2.2 安装交叉工具链（以 Linaro 为例）

# 解压SDK中的工具链（示例）

sudo tar -xf gcc-linaro-10.2.1-2021.10-x86_64_aarch64-linux-gnu.tar.xz -C /opt/

export PATH=/opt/gcc-linaro-10.2.1-2021.10-x86_64_aarch64-linux-gnu/bin:$PATH

2.3 安装 Qt Creator

sudo apt install -y qtcreator

2.4 Qt Creator 配置 RK3588 Kit

1. Tools → Options → Devices

Add → Generic Linux Device

IP、用户名 root、密码

2. Compilers

Add → GCC → C++

Path：/opt/.../aarch64-linux-gnu-g++

ABI：arm-linux-generic-elf-64bit

3. Qt Versions

选择 ARM 版 qmake（SDK 内 sysroot 的 qmake）

例：rk3588_sdk/debian/sysroots/x86_64-linux/bin/qmake

4. Kits（关键）

Name：RK3588

Device：Generic Linux Device

Compiler：RK3588 GCC

Qt Version：RK3588 Qt 5.15.x

Sysroot：SDK 的 sysroot 路径

三、使用厂商 SDK 自带 Qt（最稳定）

以创龙 / Firefly / 正点原子 RK3588 SDK 为例：

# 1. 加载SDK环境

cd rk3588_linux_sdk

source debian/sysroots/environment

# 2. 启动Qt Creator

qtcreator

# 3. 直接选择RK3588 Kit编译、运行、调试（自动SSH部署）

四、RK3588 Qt GPU 加速（EGLFS）

RK3588 Mali-G610，建议用eglfs（无 X11、性能最高）：

# 板端环境变量

export QT_QPA_PLATFORM=eglfs

export QT_QPA_EGLFS_KMS_CONFIG=/etc/eglfs_kms.json

export QT_QPA_EGLFS_ALWAYS_SET_MODE=1

启动：

./your_qt_app -platform eglfs

五、常见问题

无法显示：检查QT_QPA_PLATFORM、权限、DRM/KMS

交叉编译找不到库：确认 sysroot 路径、qmake 是 ARM 版本

GPU 异常：确认 SDK / 内核支持 Mali、[libmali.so](libmali.so) 正常

六、选择建议

快速测试：板端apt install

产品开发：PC 交叉编译 + SDK 自带 Qt + EGLFS

无桌面 / 工业：强制eglfs