创建Qt编译文章

Qt库编译-银河麒麟-RK3588.md

@@ -0,0 +1,61 @@
+# RK3588实机编译Qt5.15.13
+
+## 目录
+
+- [RK3588实机编译Qt5.15.13](#rk3588实机编译qt51513)
+  - [目录](#目录)
+  - [一、准备工作](#一准备工作)
+  - [二、编译安装](#二编译安装)
+    - [2.1 配置Qt(configure)](#21-配置qtconfigure)
+    - [2.2 编译](#22-编译)
+    - [2.3 安装](#23-安装)
+  - [附录A：常见编译错误](#附录a常见编译错误)
+    - [1. QBasicMutex::lockInternal(int)重定义](#1-qbasicmutexlockinternalint重定义)
+
+## 一、准备工作
+
+- 下载Qt源码包（本文以5.15.13为例，如需编译其它版本，下载对应版本的源代码即可，注意版本不同时，命令中的版本号与实际版本同步），下载Qt源码包[Qt5.15.13源码链接](https://download.qt.io/archive/qt/5.15/5.15.13/single/)
+
+- 通过以下命令行解压源代码至编译目录（需足够的磁盘空间，一般在用户目录新建）
+   > sudo xz -d qt-everywhere-src-5.15.13.tar.xz
+   > sudo tar -xvf qt-everywhere-src-5.15.13.tar
+- 安装编译环境
+  > sudo apt-get install build-essential perl python git
+- 安装依赖库
+  > sudo apt-get install libx11-*
+  > sudo apt-get install libx11*
+  >
+  > sudo apt-get install libxcb-*
+  > sudo apt-get install libxcb*
+  >
+  > sudo apt-get install libxkbcommon-dev
+  > sudo apt-get install libxkbcommon-x11-dev
+  > sudo apt-get install libxcb-xinerama0
+  > sudo apt-get install '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev
+
+## 二、编译安装
+
+### 2.1 配置Qt(configure)
+
+切换至解压出来的Qt目录中，运行以下命令（如果权限不足，使用sudo执行），注意其中的-prefix参数为最终Qt库的安装目录（/home/firefly/Qt5.15.13），应根据实际环境进行修改，在命令行中执行修改后的命令：
+> ./configure -prefix /home/firefly/Qt5.15.13 -confirm-license -opensource -release -make libs -xplatform linux-aarch64-gnu-g++ -pch -qt-libjpeg -qt-libpng -qt-zlib -no-sse2 -no-openssl -no-cups -no-glib -no-dbus -xcb -no-separate-debug-info -opengl es2 -egl -eglfs -qpa xcb -linuxfb -recheck-all -skip webengine -nomake examples -nomake tests -shared -skip purchasing -skip quick3d -skip sensors -skip speech -skip datavis3d -skip andriodextras -skip gamepad
+
+### 2.2 编译
+
+配置成功后，运行以下命令编译代码（-j8表示使用8线程并行编译，可根据需要或实际情况修改该数值）：
+> sudo make -j8
+
+### 2.3 安装
+
+编译成功后，运行以下命令打包安装Qt库，打包安装后的库可直接压缩后在其它同样或类似环境中解压使用
+> sudo make install
+
+## 附录A：常见编译错误
+
+### 1. QBasicMutex::lockInternal(int)重定义
+
+- 错误描述：
+    > qmutex_linux.cpp:multiple definition of 'QBasicMutex::lockInternal(int)', 
+- 解决问题:
+  > As in qmutex.cpp it directly" #include qmutex_linux.cpp", as a result the content of qmutex_linux.cpp will be part of qmutex.cpp.And in the thread.pro, the SOURCES +=qmutex.cpp qmutex_linux.cpp, then during link, the two file have same symbols will be detected.When I delete qmutex_linux.cpp from SOURCES, there is no problem any more.
+  [参考文章](https://blog.csdn.net/qq_43417144/article/details/130680388)