
前言随着国产处理器生态的快速发展龙芯平台的嵌入式应用开发需求日益增长。Qt 作为跨平台 GUI 开发框架在嵌入式 Linux 领域应用广泛。本文基于米联客龙芯 2K2000 开发板从零开始讲解 LoongArch 架构下 Qt 交叉编译环境的完整搭建流程以及 Qt Creator 开发环境配置帮助开发者快速上手龙芯平台的 Qt 应用开发。米联客官方论坛链接为资料下载 FPGAAI数字世界 -开发环境说明:虚拟机使用的是米联客论坛提供的Ubuntu22.04版本开发包为论坛中的2k2000开发包开发板型号为MLK-LS02A-2K2000-i所需用到的QT下载链接为百度网盘具体的硬件参数如下图所示一、开发环境准备1.1 虚拟机环境部署导入方式解压后双击.vmx文件即可添加至 VMware默认开机密码root1.2解压开发包与交叉编译工具链安装把前言提供得QT文件夹中得LoongOS-toolchain.sh脚本复制到虚拟机内执行安装命令sudo ./LoongOS-toolchain.sh安装过程中按3.提示输入y并回车完成后工具链默认安在/opt/LoongOS/v0.1/目录1.3 环境变量加载每次编译前需加载交叉编译环境变量cd /opt/LoongOS/v0.1/source environment-setup-loongarch64-Loongson-linux加载后系统会自动配置好CC、CXX、PATH等环境变量gcc、g、qmake等工具即可直接调用。Qt 命令行交叉编译实战把QT文件夹中附带的test文件夹复制到虚拟机2.1 编译流程说明以 Qt 自带的analogclock示例为例完整编译步骤如下1. 进入工程目录cd ~/test/analogclock2. 生成Makefileqmake3. 移除不兼容的编译参数关键步骤sed -i s/-mtunela264//g Makefile4. 执行编译make -j42.2 关键注意事项-mtunela264参数是针对龙芯 LA264 内核的优化选项在部分工具链版本中可能不被支持导致编译报错。通过sed命令批量移除该参数是通用解决方案。编译完成后会生成可执行文件analogclock该文件为 loongarch64 架构只能在龙芯开发板上运行。2.3 板端运行验证将编译好的程序文件夹拷贝至 U 盘U 盘插入开发板 USB 接口复制程序到桌面添加执行权限并运行chmod x analogclock./analogclock三、Qt Creator 交叉开发环境配置命令行编译适合脚本化构建日常开发推荐使用 Qt Creator IDE配置步骤如下3.1 Qt Creator 安装下载 Qt 在线安装包qt-online-installer-linux-x64-online.run添加执行权限并运行chmodx qt-online-installer-linux-x64-online.run./qt-online-installer-linux-x64-online.run在设置中将镜像源改为中科大源https://mirrors.ustc.edu.cn/qt/提升下载速度按向导完成安装建议安装 Qt 6.x 版本3.2 交叉编译套件配置打开 Qt Creator进入Edit - Preferences - Build Run依次配置以下选项1添加 Qt Version切换到Qt Versions标签页点击Addqmake 路径选择/opt/LoongOS/v0.1/sysroots/x86_64-loongsonsdk-linux/usr/bin/qmake命名为LA-QMAKE2添加交叉编译器切换到Compilers标签页手动添加 GCC 编译器C 编译器路径/opt/LoongOS/v0.1/sysroots/x86_64-loongsonsdk-linux/usr/bin/loongarch64-Loongson-linux/loongarch64-Loongson-linux-gccC 编译器路径/opt/LoongOS/v0.1/sysroots/x86_64-loongsonsdk-linux/usr/bin/loongarch64-Loongson-linux/loongarch64-Loongson-linux-gABI 选择loongarch-linux-generic-elf-64bit3构建 Kit 配置切换到Kits标签页新建构建套件配置核心参数Compiler选择刚才添加的 LA-GCCQt version选择 LA-QMAKESysroot设置为/opt/LoongOS/v0.1/sysroots/loongarch64-Loongson-linux保存并设为可用四、跨平台调试技巧4.1 先 PC 后板卡的开发模式Qt 的跨平台特性允许我们采用 PC 调试 板卡运行 的开发模式在 x86 环境下使用 Desktop 套件开发调试界面逻辑功能验证无误后切换到龙芯交叉编译套件编译生成的二进制文件部署到开发板运行该模式可大幅提升开发效率避免频繁烧写和板端调试的繁琐。4.2 局限性说明涉及硬件操作的功能无法在 PC 端模拟调试例如I2C/SPI 外设读写摄像头、显示屏等硬件设备操作平台专属接口调用 此类功能仍需在板端进行实际调试。总结本文完整介绍了龙芯 2K2000 平台 Qt 交叉编译环境的搭建流程涵盖工具链安装、命令行编译、Qt Creator 配置三个核心环节。掌握这套开发流程后开发者可以快速将现有 Qt 应用迁移到 LoongArch 架构助力国产平台的应用生态建设。