全志H5,NanopiKP1lus移植QT5.12记录

原创

已于 2025-04-21 11:37:44 修改 · 1.3k 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#QT移植 #nanopi #FBTft

于 2025-04-18 16:30:02 首次发布

机器环境

主机Linux版本:Ubuntu24.04
板卡硬件：NanoPi K1 Plus,全志H5芯片，ARMv8架构，aarch64指令集，屏幕为1.96寸ST7789V屏幕（已移植好framebuffer驱动）

下载QT5.12.0源码

官方下载地址：https://download.qt.io/archive/qt/5.12/
下载qt-everywhere-src-5.12.0.tar.xz源码包
下载qt-opensource-linux-x64-5.12.0.run安装文件用于主机linux环境QT开发

安装交叉编译器

Nanopi_K1_Plus官方wiki教程里有链接，自行下载：
开发板使用教程wiki:https://wiki.friendlyelec.com/wiki/index.php/NanoPi_K1_Plus/zh
内核编译教程wiki:https://wiki.friendlyelec.com/wiki/index.php/Building_U-boot_and_Linux_for_H5/H3/H2%2B/zh
官方推荐编译器:gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu.tar.xz下载地址：https://download.friendlyelec.com/nanopineo2
下载交叉编译器gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu.tar.xz，然后解压编译器:

sudo mkdir -p /opt/FriendlyARM/toolchain
sudo tar xf gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu.tar.xz -C /opt/FriendlyARM/toolchain/

将编译器的路径加入到PATH中，用vi编辑vi ~/.bashrc，在末尾加入以下内容：

$ export PATH=/opt/FriendlyARM/toolchain/gcc-linaro-6.3.1-2017.02-x86_64_aarch64-linux-gnu/bin:$PATH
$ export GCC_COLORS=auto

执行一下~/.bashrc脚本让设置立即在当前shell窗口中生效，注意"."后面有个空格：

$ . ~/.bashrc

安装完成后，你可以快速的验证是否安装成功：

$ aarch64-linux-gnu-gcc -v
gcc version 6.3.1 20170109 (Linaro GCC 6.3-2017.02)

修改qmake.conf文件

将之前下载的qt源码qt-everywhere-src-5.12.0.tar.xz进行解压，我的解压目录如下：/home/image/work/nanopi-k1/qt，将解压目录名称缩短为qt-src-5.12.0，原名称太长，解压完成后源码根目录如下：/home/image/work/nanopi-k1/qt/qt-src-5.12.0
不同的硬件架构对应不同的qmake.conf，在下载的Qt5.12.11源码中的qtbase/mkspecs/目录下有各种不同的平台，H5使用的是linux-aarch64-gun-g++目录下的qmake配置文件。我们先创建一个文件夹aarch64，将linux-aarch64-gun-g++这个目录的文件拷贝到aarch64目录中。之前文件夹作备份。

mkdir aarch64
cd linux-aarch64-gnu-g++/
cp * ../aarch64/

修改前配置文件内容如下：

#
# qmake configuration for building with aarch64-linux-gnu-g++
#

MAKEFILE_GENERATOR      = UNIX
CONFIG                 += incremental
QMAKE_INCREMENTAL_STYLE = sublib

include(../common/linux.conf)
include(../common/gcc-base-unix.conf)
include(../common/g++-unix.conf)

# modifications to g++.conf
QMAKE_CC                = aarch64-linux-gnu-gcc
QMAKE_CXX               = aarch64-linux-gnu-g++
QMAKE_LINK              = aarch64-linux