【平头哥Sipeed LicheeRV 86开发板试用体验】QT初体验

查看报错的源码，发现这个函数应该是unix下特有的，我在Windows下编译，但是实际上启用了Q_OS_UNIX的宏。从qtbasesrccorelibglobalqsystemdetection.h文件来看，如果未指定平台，则会默认Unix，而定义Q_OS_WIN宏的条件，是要定义Q_OS_WIN32、Q_OS_WIN64、Q_OS_WINRT其中至少一个宏，而这三个宏在定义条件如下：
#elif !defined(SAG_COM) && (!defined(WINAPI_FAMILY)|| WINAPI_FAMILY==WINAPI_FAMILY_DESKTOP_APP) && (defined(WIN64) ||defined(_WIN64) || defined(__WIN64__))
#  define Q_OS_WIN32
#  define Q_OS_WIN64
#elif !defined(SAG_COM) && (defined(WIN32) ||defined(_WIN32) || defined(__WIN32__) || defined(__NT__))
#  ifdefined(WINAPI_FAMILY)
#    ifndefWINAPI_FAMILY_PC_APP
#      defineWINAPI_FAMILY_PC_APP WINAPI_FAMILY_APP
#    endif
#    ifdefined(WINAPI_FAMILY_PHONE_APP) &&WINAPI_FAMILY==WINAPI_FAMILY_PHONE_APP
#      defineQ_OS_WINRT
#    elifWINAPI_FAMILY==WINAPI_FAMILY_PC_APP
#      defineQ_OS_WINRT
#    else
#      defineQ_OS_WIN32
#    endif
#  else
#    define Q_OS_WIN32
#  endif
Win32、win64看起来应该是在编译的时候传入的参数，最终找到qtbasemkspecscommong++-win32.conf文件中定义了_WIN32宏，这个文件又被qtbasemkspecswin32-g++qmake.conf文件包含，我的编译选线里面指定了-platformwin32-g++，按道理这个宏应该在编译的时候已经定义了才对，为什么实际编译的时候被使能的是Q_OS_UNIX宏呢？？？
51期间的记录仅上述两点，实际上后来我尝试了很多办法，包括直接指定Windows的编译宏等，结局非常凄惨，就和一个谎言需要无数个谎言来掩盖类似，绕开一个编译错误的动作导致了后面出现更多的编译报错，直接钻进了牛角尖。后来还尝试过在Linux下编译，configure确实没有报错，但是编译的时候出现了其他错误，尝试解决也是以失败告终，在这里消耗了大约1天多的时间，直接清空了假期余额，因此这件事情也向后拖了很长时间。
后来在一个周末比较空闲的时间，打算继续研究一下，在查看qtbaseconfigure.bat文件时，发现以下代码：
if "%PLATFORM:g++=%" == "%PLATFORM%" (
    if"%MAKE%" == "" (
        if not"%jom.exe%" == "" (
            setMAKE=jom
        ) else (
            setMAKE=nmake
        )
    )
    set tmpl=win32
) else (
    if"%MAKE%" == "" (
        setMAKE=mingw32-make
    )
    set tmpl=unix
)
大意是如果指定的平台已g++结尾，就走else的逻辑，我指定的平台为win32-g++，所以按Unix编译了？看了下还支持win32-msvc平台，我电脑上安装过vs，刚好有msvc的工具链，因此打算切换到msvc，使用-platformwin32-msvc参数，依然出现上述错误，在网上收罗解决办法的时候，翻到了下面这篇文章：
Windows10+MSVC(VS2022)从源码编译QT5.12.11
里面提到要使用x64 Native Tools Command Prompt for VS 2022Current命令行执行编译编译指令，尝试之后果然没有报错了！！（充分说明了查找资料也是初级技术人员的一项必不可少的能力），编译过程在下面的章节记录。

• Windows下编译QT源码 - 2
  
  
  
  
  • 重新解压qt源码，修改交叉编译工具链名称。这里要注意库编译为动态还是静态（我还不理解啥意思），摘抄文章如下：
    

QT静态库的编译需要注意编译选项/MD 、 /MT要和开发项目中引用的其他库相匹配。如果要修改此编译选项，可以在QT源文件根目录下的qtbasemkspecscommonmsvc-desktop.conf 中修改
QMAKE_CFLAGS_RELEASE    = $$QMAKE_CFLAGS_OPTIMIZE -MD
QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO+= $$QMAKE_CFLAGS_OPTIMIZE -Zi -MD
QMAKE_CFLAGS_DEBUG      = -Zi -MDd
或者
QMAKE_CFLAGS_RELEASE    = $$QMAKE_CFLAGS_OPTIMIZE -MT
QMAKE_CFLAGS_RELEASE_WITH_DEBUGINFO+= $$QMAKE_CFLAGS_OPTIMIZE -Zi -MT
QMAKE_CFLAGS_DEBUG      = -Zi -MTd

• 打开msvc对应的命令行（x86 Native Tools Command Prompt for VS     2022 Current，编译64位库则打开x64 Native Tools Command Prompt for VS     2022 Current），切换到qt源码解压目录下，注意可能直接cd到解压目录会失败，可以逐级切换目录。
  

这次使用的指令为 configure -static -release -mp -opensource -confirm-license-platform win32-msvc -xplatform linux-aarch64-gnu-g++ -prefixD:QtQt5.12.105.12.10xuantie_900_mingw_v2.2.5 -nomake examples -nomake tests-no-opengl -no-iconv -no-assimp-no-qt3d-profile-jobs -no-qt3d-profile-gl -skipqtvirtualkeyboard  -skip qtwebengine -skip qtlocation  ，依然需要在qt解压出来的文件夹根目录下执行。
configure执行的结果如下：

（上述指令红色部分是后面发现问题之后加的，到后面其实我重新解压编译了一次，用的指令如下 configure -prefix D:QtQt5.12.105.12.10xuantie_900_mingw_v2.2.5-opensource -confirm-license -release -strip -shared -xplatformlinux-aarch64-gnu-g++ -platform win32-msvc -optimized-qmake -c++std c++11--rpath=no -pch -skip qt3d -skip qtactiveqt -skip qtandroidextras -skipqtcanvas3d -skip qtconnectivity -skip qtdatavis3d -skip qtdoc -skip qtgamepad-skip qtlocation -skip qtmacextras -skip qtnetworkauth -skip qtpurchasing -skipqtremoteobjects -skip qtscript -skip qtscxml -skip qtsensors -skip qtspeech-skip qtsvg -skip qttools -skip qttranslations -skip qtwayland -skipqtwebengine -skip qtwebview -skip qtwinextras -skip qtx11extras -skipqtxmlpatterns -make libs -make examples -nomake tools -nomake tests -gui-widgets -dbus-runtime --glib=no --iconv=no --pcre=qt --zlib=qt -no-openssl--freetype=qt --harfbuzz=qt -no-opengl -linuxfb --xcb=no --libpng=qt--libjpeg=qt --sqlite=qt -plugin-sql-sqlite -recheck-all）

• 接下来执行nmake
  

在编译过程中，遇到的错误以及对应的解决办法如下：

• 在编译过程中出现如下错误
  

看起来是在调用python时，命令行将指令中文件夹名称中的空格截断了。改动现有的文件目录比较麻烦，我直接重装了python，这次安装的目录就比较简单了，确保没有空格。继续执行nmake，不再报该错误。

• 编译过程中出现如下错误：
  

d:/private_toolchain/xuantie-900-gcc-linux-5.10.4-glibc-mingw-v2.2.5/bin/../lib/gcc/riscv64-unknown-linux-gnu/10.2.0/../../../../riscv64-unknown-linux-gnu/bin/ld.exe:E:/qt-everywhere-src-5.15.1/qtdeclarative/lib/libQt5Qml.a(qv4typedarray.obj):in function `unsigned long long atomicExchange(char*,QV4::Value)':
qv4typedarray.cpp:(.text._Z14atomicExchangeItEyPcN3QV45ValueE[_Z14atomicExchangeItEyPcN3QV45ValueE]+0x16):undefined reference to `__atomic_exchange_2'
在网上收罗了一下资料（参考 https://twd2.me/archives/10597 ），缺少的这个函数是RV64的对8位整数和16位整数的原子操作，类似的函数还有__atomic_exchange_4（32位）和__atomic_exchange_8（64位），出现这个问题可主动指定lib文件（-latomic）解决，我报错的这个地方在qtdeclarativetoolsqml目录下（此时已经是使用刚编译出来的qmake在编译了），需要修改该目录下的makefile文件，在LIBS变量中加入 -latomic。继续编译，不再报__atomic_exchange_2等函数的错误。
在后续的编译中，还需要按这种方式修改如下文件：
qtdeclarativetoolsqmltestrunnerMakefile

• 编译过程中出现如下错误：
  

d:/private_toolchain/xuantie-900-gcc-linux-5.10.4-glibc-mingw-v2.2.5/bin/../lib/gcc/riscv64-unknown-linux-gnu/10.2.0/../../../../riscv64-unknown-linux-gnu/bin/ld.exe:E:/qt-everywhere-src-5.15.1/qtdeclarative/lib/libQt5Qml.a(YarrInterpreter.obj):in function `.L433':
YarrInterpreter.cpp:(.text._ZN3JSC4Yarr11byteCompileERNS0_11YarrPatternEPN3WTF20BumpPointerAllocatorEPNS_6NoLockE+0x3b8):undefined reference to `JSC::Yarr::wordUnicodeIgnoreCaseCharCreate()'
收罗到如下解决办法（  https://forum.qt.io/topic/32634/unresolved-external-symbol-attempting-to-build-5-2/4 ）：
in "qtqtdeclarativesrcqml", check the file"RegExpJitTables.h"
if it's empty, delete it (it's autogenerated with python)
上述办法是针对5.2版本的qt，我现在使用的是5.15.1，这个文件的路径在qtdeclarativesrcqml.generatedRegExpJitTables.h。实际上我在删除这个文件之后依然报错，发现创建的还是一个空文件，直接进入到qtdeclarativesrcqml目录，手动执行pythonE:/qt-everywhere-src-5.15.1/qtdeclarative/src/3rdparty/masm/yarr/create_regex_tables> .generatedRegExpJitTables.h 命令，才成功创建这个文件（创建出来的文件是由一个超大的数组开头 static const char_wordcharData[65536]）。
（文章里面还提到另一个办法是从git下载源码，但是我未尝试）。

• 在编译过程中遇到如下错误：
  

In file included fromdeclarativemapsqdeclarativepolylinemapitem.cpp:38:
declarativemapsqdeclarativepolylinemapitem_p_p.h:381:17:error: 'const char* MapPolylineShaderLineStrip::vertexShader() const' marked'override', but does not override
  381 |     const char *vertexShader() const override{
这个问题，后来发现是各个模块之间有依赖导致的，我在configure的时候加了-noopengl，而这里的qtlocation模块对opengl模块有依赖，所以编译报错，重新configure一次，加上 -noqtlocation，然后重新nmake即可。
在漫长的等待之后，编译终于完成了。
执行nmake install，将编译的文件安装到 -prefix指定的目录。

• 配置qt     creator，创建测试工程
  
  
  
  
  • 配置qt creator
    

参考这篇文章《windows下Qt13源码编译-QtCreator配置linux arm交叉编译环境》。

• 创建测试工程
  

在配置完kit（构建套件）之后，使用creator新建一个测试项目，在选择kit时勾选上我们刚刚配置好的套件，然后随便敲点代码，准备编译工程。

• 编译工程
  

直接点击运行或者构建，将会出现失败，对比了正常构建和失败构建的输出如下：

很明显是因为没有在工具链的目录下找到make程序导致的，但是此时已经通过qmake创建了makefile文件，我们可以直接进入到工程所在目录，然后直接执行make指令，即可完成程序的编译，我这边成功生成test可执行文件。
（后来不知道为啥就能直接找到make程序了，此时直接点击构建即可创建出test可执行程序，无需手动执行make指令了）

• 运行
  

将编译生成的测试程序上传到开发板并执行，得到如下错误提示：

原因是因为 libstdc++.so.6库的版本不够高，因此需要更新库文件，我直接将下载的工具链中的库文件（位于工具链目录riscv64-unknown-linux-gnulib64v_xtheadlp64d目录下）更新到开发板上。

然后将libstdc++.so.6软连接到这个库文件即可。

重新执行测试程序，得到如下错误：
./test: error while loading shared libraries:ld-linux-riscv64v_xthead-lp64d.so.1: cannot open shared object file: No suchfile or directory
这看起来是库文件缺失导致的报错，将工具链中的库文件更新到开发板上

重新执行测试程序，得到如下错误：

前面两行是因为在编译qt源码时，configure没有加-no-iconv，在没加的情况下编译后，qt会使用QIconvCodec类进行编码的转换，而qt本身不再使用该类，所以不要使用该库，因此重新configure一次然后重新编译即可。
当然也可以下载去这个网址http://ftp.gnu.org/gnu/libiconv/下载libiconv源码，配置（./configure --prefix=E:libiconv-1.17libiconv-1.17build --host=riscv64-unknown-linux-gnu-gcc）编译后安装，将产生的libiconv.so复制到开发板上。
编译完成后重新构建测试工程，将得到的可执行文件上传并执行，出现找不到qt库的错误，将缺失的库上传到开发板，重新执行，最终出现BUS ERROR的错误。

查询了资料，说error bus基本上可以肯定是板子上运行的qt库和编译器使用的qt库不一致造成的。那么最好的办法就是将交叉编译的qt库文件直接拷贝到开发板上，并设置其路径。
直接将整个编译出来的文件拷贝到SD卡的目录下

并设置qt的环境变量如下：
export QT_ROOT=/mnt/UDISK/qtlib
export QT_QPA_PLATFORM_PLUGIN_PATH=$QT_ROOT/plugins
export QT_QPA_PLATFORM=linuxfb:tty=/dev/fb0
export QT_PLUGIN_PATH=$QT_ROOT/plugins
exportLD_LIBRARY_PATH=$QT_ROOT/lib:$QT_ROOT/plugins/platforms
export QML2_IMPORT_PATH=$QT_ROOT/qml
export QT_QPA_FONTDIR=/resources/fonts
这些环境变量的设置可加入到 /etc/profile 文件中，并通过重启或者执行 source /etc/profile 的方式使其生效。

在配置完成后，重新执行测试程序（测试程序的功能为点击一个按钮，会更新一个文本框）。
界面得以显示，但是文字都没有显示出来，点击测试按钮，本应该更新文字，但是文本框依然空白，控制台输出如下信息：
Note that Qt no longer ships fonts. Deploy some (from https://dejavu-fonts.github.io/ forexample) or switch to fontconfig.
看这意思，是因为缺少字符库导致的，在开发板全局搜索 fonts，找到如下两个路径：
/resources/fonts
/usr/share/directfb-examples/fonts
将第一个路径加入到环境变量中 （ export QT_QPA_FONTDIR=/resources/fonts/ ），重新执行程序，终于正常显示了，效果如下：

直接上一个官方炫酷一点的例程（官方例程需要编译example模块才会生成），路径在编译安装路径下"exampleswidgetsanimationanimatedtilesanimatedtiles"，执行的效果如视频，还是非常的丝滑的。

ff94f4ac7bfcea354411d5a2d578ade2

0