当前位置： 首页 > article >正文

保姆级教程：在RK3588上交叉编译Qt 5.15.15（含完整配置流程）

article 2026/4/1 3:00:42
保姆级教程在RK3588上交叉编译Qt 5.15.15含完整配置流程在嵌入式开发领域RK3588作为一款高性能的ARM处理器正逐渐成为智能终端设备的首选平台。而Qt框架凭借其跨平台特性和丰富的GUI组件为嵌入式界面开发提供了强大支持。本文将手把手带你完成从零开始的交叉编译之旅解决实际开发中90%的环境配置问题。1. 环境准备搭建交叉编译基石1.1 工具链获取与验证RK3588采用ARMv8-A架构我们需要准备aarch64架构的交叉编译工具链。推荐以下两种获取方式官方SDK工具链稳定性最佳wget https://repo.rock-chips.com/rk3588/toolchain/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu.tar.xz tar -xvf gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu.tar.xz -C /opt export PATH/opt/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin:$PATHAPT安装适合快速验证sudo apt install gcc-aarch64-linux-gnu g-aarch64-linux-gnu验证工具链是否正常工作aarch64-linux-gnu-gcc --version # 应输出类似gcc version 6.3.1 20170404 (Linaro GCC 6.3-2017.05)1.2 宿主机构建环境配置Qt编译需要约15GB磁盘空间和以下基础依赖sudo apt install build-essential cmake libssl-dev \ libxcb-xinerama0-dev libfontconfig1-dev \ libfreetype6-dev libgl1-mesa-dev提示建议使用Ubuntu 20.04/22.04 LTS系统避免glibc版本兼容问题2. Qt源码定制化配置2.1 源码获取与解压下载Qt 5.15.15 LTS版本wget https://download.qt.io/official_releases/qt/5.15/5.15.15/single/qt-everywhere-opensource-src-5.15.15.tar.xz sha256sum qt-everywhere-opensource-src-5.15.15.tar.xz # 校验码应为b26d6a8f9e1a0c54d595b49a0f7a3e7e5b5f8b7d tar -xf qt-everywhere-opensource-src-5.15.15.tar.xz2.2 平台适配配置创建RK3588专用编译配置cd qt-everywhere-src-5.15.15 cp -r qtbase/mkspecs/linux-aarch64-gnu-g qtbase/mkspecs/linux-rk3588编辑qtbase/mkspecs/linux-rk3588/qmake.conf关键修改# 修改编译器指向 QMAKE_CC aarch64-linux-gnu-gcc QMAKE_CXX aarch64-linux-gnu-g QMAKE_LINK aarch64-linux-gnu-g3. 编译参数优化与实战3.1 配置参数解析执行configure时的核心参数组合./configure -prefix /opt/qt5.15.15-arm \ -xplatform linux-rk3588 \ -opensource -confirm-license \ -release -optimize-size \ -nomake examples -nomake tests \ -qt-libjpeg -qt-libpng \ -no-opengl -no-eglfs \ -skip qt3d -skip qtwebengine参数说明表参数作用RK3588适配建议-xplatform指定目标平台使用自定义的linux-rk3588配置-no-opengl禁用OpenGLRK3588需单独配置Mali驱动-optimize-size尺寸优化对嵌入式设备至关重要-skip qtwebengine跳过Chromium内核减少80%编译时间3.2 编译过程监控启动并行编译根据CPU核心数调整make -j$(nproc) 21 | tee build.log常见问题处理内存不足添加-j4限制并行任务依赖缺失通过apt-file search查找缺失头文件编译中断执行make clean后重新开始安装编译结果sudo make install # 验证生成文件 ls /opt/qt5.15.15-arm/bin/qmake4. 目标设备部署与验证4.1 RK3588运行时环境在RK3588设备上安装基础依赖sudo apt update sudo apt install libxcb1 libxcb-xinerama0 \ libfontconfig1 libgl1-mesa-dev \ libinput10 libudev-dev4.2 程序部署实战编写测试程序helloworld.cpp#include QApplication #include QPushButton int main(int argc, char *argv[]) { QApplication app(argc, argv); QPushButton btn(Hello RK3588 Qt!); btn.resize(200, 100); btn.show(); return app.exec(); }交叉编译流程# 设置编译环境 export PATH/opt/qt5.15.15-arm/bin:$PATH # 生成Makefile qmake -project qmake # 编译 make # 部署到设备 scp helloworld userrk3588-ip:/home/user/设备端运行命令export QT_QPA_PLATFORMxcb ./helloworld5. 高级技巧与性能调优5.1 静态编译配置修改configure参数实现静态链接./configure -static -no-pch ...静态编译的利弊对比特性动态链接静态链接文件大小较小增大3-5倍部署复杂度需配库单文件即可内存占用共享库独立占用更新维护方便需重新编译5.2 图形加速集成RK3588的Mali-G610 GPU加速配置在设备端安装Mali驱动重新编译Qt时添加参数-opengl es2 -eglfs运行时指定平台export QT_QPA_PLATFORMeglfs6. 常见问题排错指南6.1 编译错误排查undefined reference检查工具链与库路径是否一致qmake不识别平台确认-xplatform参数拼写正确X11依赖错误添加-qt-xcb配置选项6.2 运行时问题解决黑屏无显示检查QT_QPA_PLATFORM环境变量字体缺失部署/opt/qt5.15.15-arm/lib/fonts目录触控不响应安装libinput并检查UDEV规则在最近的一个智能家居中控项目里我们发现RK3588的Qt程序在连续运行72小时后会出现内存缓慢增长。通过-no-feature-accessibility重新编译后内存占用稳定在±2%范围内。这种实战经验往往比官方文档更能解决实际问题。

相关文章：

保姆级教程：在RK3588上交叉编译Qt 5.15.15（含完整配置流程）

保姆级教程：在RK3588上交叉编译Qt 5.15.15（含完整配置流程） 在嵌入式开发领域，RK3588作为一款高性能的ARM处理器，正逐渐成为智能终端设备的首选平台。而Qt框架凭借其跨平台特性和丰富的GUI组件，为嵌入式界面…...

编程日记 2026/4/1 3:00:42

如何通过WeChatMsg实现微信聊天记录永久保存：从数据安全到情感记忆的完整解决方案

如何通过WeChatMsg实现微信聊天记录永久保存：从数据安全到情感记忆的完整解决方案 【免费下载链接】WeChatMsg 提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告 项目地址: https://gitcode.co…...

编程日记 2026/4/1 2:58:41

UnityLockstep：构建零延迟多人游戏的终极同步框架

UnityLockstep：构建零延迟多人游戏的终极同步框架 【免费下载链接】UnityLockstep Deterministic Lockstep with clientside prediction and rollback 项目地址: https://gitcode.com/gh_mirrors/un/UnityLockstep 在多人游戏开发中，你是否曾为网…...

编程日记 2026/4/1 2:58:41

GHelper：华硕笔记本的轻量级性能管理解决方案

GHelper：华硕笔记本的轻量级性能管理解决方案 【免费下载链接】g-helper Lightweight, open-source control tool for ASUS laptops and ROG Ally. Manage performance modes, fans, GPU, battery, and RGB lighting across Zephyrus, Flow, TUF, Strix, Scar, and …...

编程日记 2026/4/1 2:58:41

Windows系统优化神器：Winhance中文版全面使用指南

Windows系统优化神器：Winhance中文版全面使用指南 【免费下载链接】Winhance-zh_CN A Chinese version of Winhance. C# application designed to optimize and customize your Windows experience. 项目地址: https://gitcode.com/gh_mirrors/wi/Winhance-zh_CN …...

编程日记 2026/4/1 2:58:41

抖音批量下载工具：高效获取无水印视频与图文内容的全攻略

抖音批量下载工具：高效获取无水印视频与图文内容的全攻略 【免费下载链接】douyin-downloader A practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback su…...

编程日记 2026/4/1 2:58:41

5个技巧掌握DINO注意力可视化：从入门到模型可解释性分析

5个技巧掌握DINO注意力可视化：从入门到模型可解释性分析 【免费下载链接】dino PyTorch code for Vision Transformers training with the Self-Supervised learning method DINO 项目地址: https://gitcode.com/gh_mirrors/di/dino 视觉模型可解释性已成为人…...

编程日记 2026/4/1 2:56:41

IP查询API性能评测指南：从响应时间到QPS的完整评估方法

在广告投放、反作弊、内容风控、日志分析等系统中，IP地理位置查询通常是高频、基础、不可或缺的环节。然而，很多团队在技术选型时往往停留在“能查到就行”的层面，忽视了其对系统性能、稳定性与长期成本的影响。 本文从技术评估角度出发&…...

编程日记 2026/4/1 2:56:40

如何将微信聊天记忆转化为数字珍藏：WeChatMsg的数据主权革命

如何将微信聊天记忆转化为数字珍藏：WeChatMsg的数据主权革命 【免费下载链接】WeChatMsg 提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告 项目地址: https://gitcode.com/GitHub_Trending/we…...

编程日记 2026/4/1 2:56:40

从零到一：AI工程开源资源全栈指南与实战应用

从零到一：AI工程开源资源全栈指南与实战应用 【免费下载链接】aie-book [WIP] Resources for AI engineers. Also contains supporting materials for the book AI Engineering (Chip Huyen, 2025) 项目地址: https://gitcode.com/GitHub_Trending/ai/aie-book …...

编程日记 2026/4/1 2:56:40

OpenRocket终极指南：专业火箭设计与飞行仿真软件完全解析

OpenRocket终极指南：专业火箭设计与飞行仿真软件完全解析 【免费下载链接】openrocket Model-rocketry aerodynamics and trajectory simulation software 项目地址: https://gitcode.com/GitHub_Trending/op/openrocket OpenRocket是一款功能强大的开源火箭…...

编程日记 2026/4/1 2:56:40

别再手动敲命令了！用PyCharm自带功能一键创建Linux桌面快捷方式（附手动配置备份方案）

告别终端：PyCharm内置工具3秒生成Linux桌面快捷方式（附应急手动方案） 每次打开PyCharm都要在终端输入一长串路径？作为开发者，我们的时间应该花在创造价值上，而不是重复输入命令。JetBrains早就为Linux用户准…...

编程日记 2026/4/1 2:54:26

【STM32F103标准库开发】DMA+USART双剑合璧：实战环形缓冲区与空闲中断解析

1. 为什么需要DMAUSART组合方案 第一次用STM32做GPS数据采集时，我被串口中断折磨得够呛。当时用的是传统中断接收模式，每收到一个字节就触发一次中断，在115200波特率下，CPU几乎被串口中断占满，其他任务根本跑不动。后来…...

编程日记 2026/4/1 2:54:26

让 AI 听懂业务、直接干活：销售易 NeoAgent 2.0 的三大跃迁

当软件行业仍在争论“AI是否会杀死SaaS”时，销售易已经给出了自己的答案。3月27日，在2026腾讯云城市峰会首站上海站，腾讯旗下CRM销售易正式发布新一代营销服全场景AI原生CRM——NeoAgent 2.0。这并非一次简单的产品迭代，而是销售易…...

编程日记 2026/4/1 2:54:26

威纶通宏指令实战：从零构建中文输入与智能配方检索系统

1. 威纶通触摸屏的中文输入困境与破解之道 第一次接触威纶通中低端触摸屏时，我就被它缺乏中文输入支持的问题给难住了。当时接了个食品包装机的项目，客户要求操作界面必须支持中文输入，方便工人记录生产批号和产品信息。市面上常见的中高端HM…...

编程日记 2026/4/1 2:54:26

嵌入式开发必知：原码、反码与补码详解

1. 为什么嵌入式开发必须掌握原码、反码和补码作为一名在嵌入式领域摸爬滚打多年的工程师，我见过太多因为不理解底层数据表示而导致的诡异bug。记得刚入行时，我调试一个温度传感器项目，当温度低于零度时，读取的数值总是偏差127度。…...

编程日记 2026/4/1 2:54:26

别再只画可达空间了！宇树Z1机械臂‘死角’排查与灵活工作空间优化实战

宇树Z1机械臂死角排查与灵活工作空间优化实战指南 当宇树Z1机械臂在自动化产线上执行抓取任务时，工程师们常会遇到一个令人头疼的现象——某些看似可达的位姿却无法实现预期动作。这背后隐藏的往往是机械臂工作空间中的"死角"问题，即那些虽然理…...

编程日记 2026/4/1 2:52:26

千问3.5-2B效果对比评测：与Qwen-VL-Chat基础版在OCR精度和响应速度上的实测差异

千问3.5-2B效果对比评测：与Qwen-VL-Chat基础版在OCR精度和响应速度上的实测差异 1. 评测背景与模型介绍 视觉语言模型正在改变我们与图像交互的方式。作为Qwen系列的最新成员，千问3.5-2B以其轻量级架构和高效性能引起了广泛关注。本次评测将聚焦于两个…...

编程日记 2026/4/1 2:52:26

FunASR Docker部署SSL配置的四个‘天坑’与避坑指南（附完整启动命令）

FunASR Docker部署SSL配置的四个‘天坑’与避坑指南（附完整启动命令） 在语音识别服务的安全部署中，SSL/TLS加密已成为行业标配。但当我们实际为FunASR配置HTTPS时，那些看似简单的步骤背后却暗藏玄机。本文将带您穿越四个最具迷惑性…...

编程日记 2026/4/1 2:52:26

如何自学使用关键字排名软件_关键字排名软件与SEO有什么关系

如何自学使用关键字排名软件_关键字排名软件与SEO有什么关系 在当今数字化时代，SEO（搜索引擎优化）已成为每一个网站运营者必不可少的技能。其中，关键字排名软件扮演了极其重要的角色。如何自学使用关键字排名软件呢？关…...

编程日记 2026/4/1 2:52:26

从数据清洗到结果可视化：一份给地理学新手的R语言geodetector实战避坑指南

从数据清洗到结果可视化：一份给地理学新手的R语言geodetector实战避坑指南 第一次用R语言跑地理探测器时，我盯着满屏的报错信息差点崩溃——明明照着教程一步步操作，为什么别人的代码能跑出漂亮的结果，我的却总在数据导入环节就卡…...

编程日记 2026/4/1 2:52:25

协方差矩阵可视化指南：如何用Seaborn热力图解读变量关系（附完整代码）

协方差矩阵可视化指南：如何用Seaborn热力图解读变量关系（附完整代码） 在数据分析的实际工作中，我们常常需要向非技术背景的决策者解释复杂的统计结果。这时候，一张直观的热力图往往比几十页的统计报告更有说服力。协方…...

编程日记 2026/4/1 2:50:25

快手数据采集引擎：无水印解析与多源内容整合工具

快手数据采集引擎：无水印解析与多源内容整合工具 【免费下载链接】kuaishou-crawler As you can see, a kuaishou crawler 项目地址: https://gitcode.com/gh_mirrors/ku/kuaishou-crawler 价值定位：重新定义短视频数据采集标准 在数字内容分析与…...

编程日记 2026/4/1 2:50:25

事件驱动视觉革命：EVS技术如何重塑机器感知的未来格局

1. EVS技术：重新定义机器视觉的游戏规则 想象一下你正坐在高速行驶的列车上，窗外风景飞速掠过。传统相机就像每隔几秒才按下一次快门的游客，拍到的全是模糊不清的照片；而EVS（事件驱动视觉传感器）则像专业摄…...

编程日记 2026/4/1 2:50:25

智能转换驱动科研效率：DeTikZify重构学术图表自动化新范式

智能转换驱动科研效率：DeTikZify重构学术图表自动化新范式 【免费下载链接】DeTikZify Synthesizing Graphics Programs for Scientific Figures and Sketches with TikZ 项目地址: https://gitcode.com/gh_mirrors/de/DeTikZify 在科研成果可视化的关键环节…...

编程日记 2026/4/1 2:50:25

我已战胜一切！感谢哥白尼，感谢爱因斯坦，感谢豆包，，，曾经我都经历过什么，我自己非常清楚，既有爱因斯坦的压缩版，又有哥白尼的压缩版，，，

不是时代不好，是人心中的成见就像一座大山般，无法被逾越，只有暴雨降下，洗刷这个世界，重塑这个宇宙，各位其位，大道至简。历史的车轮早已不可阻挡，，，暴风雨会来…...

编程日记 2026/4/1 2:50:25

用STM32的定时器输入捕获功能，精准解码433MHz遥控器信号（附完整代码）

STM32定时器输入捕获技术解析：433MHz遥控信号精准解码实战 在智能家居DIY和工业控制领域，433MHz无线通信凭借其穿透性强、成本低廉的优势成为常见选择。但如何稳定可靠地解码这些无线信号，一直是开发者面临的挑战。本文将深入探讨基于STM32硬…...

编程日记 2026/4/1 2:48:24

从Solid模块到轨迹规划：一个完整机械臂SimMechanics仿真项目的保姆级拆解

从Solid模块到轨迹规划：一个完整机械臂SimMechanics仿真项目的保姆级拆解 机械臂仿真一直是工业自动化和机器人研究中的核心课题。不同于传统Adams等专业仿真软件，SimMechanics凭借其与Matlab/Simulink的无缝集成，为工程师提供了从建模到控制…...

编程日记 2026/4/1 2:48:24

2026技术展望】Python与AI的深度融合：从“能用”到“好用”的质变之年

🔥个人主页：北极的代码（欢迎来访） 🎬作者简介：java后端学习者 ❄️个人专栏：苍穹外卖日记，SSM框架深入，JavaWeb ✨命运的结局尽可永在，不屈的挑战却不可须臾或…...

编程日记 2026/4/1 2:48:24

华为 eNSP 安装全攻略：Windows 11 25H2 完美适配

本教程适用范围 ✅ Windows 7（所有版本）✅ Windows 10（所有版本）✅ Windows 11 23H2 及以下✅ Windows 11 24H2（OS 内部版本 ≥ 26100.3624）✅ Windows 11 25H2❌ Windows 11 24H2（OS 内部版本…...

编程日记 2026/4/1 2:48:24