ubuntu18.04编译qt5.14.2源码

ubuntu18.04编译qt5.14.2源码

文章目录

• ubuntu18.04编译qt5.14.2源码
• • @[toc]
  • 1 前言
  • 2 参考文档
  • 3 下载源码
  • • 3.1 方法1
    • 3.2 方法2
    • 3.3 方法3
  • 4 ubuntu编译qt源码
  • • 4.1 环境准备
    • 4.2 设置交换分区大小
    • 4.3 编译源码
    • 4.4 添加环境变量
    • 4.5 验证编译结果
    • 4.6 编译帮助文档（qch）
    • 4.7 编译QtCreator
  • 5 help
  • • 5.1 顶层安装目录
    • 5.2 安装目录布局微调
    • 5.3 Configure 元选项
    • 5.4 构建选项
    • 5.5 构建环境
    • 5.6 组件选择
    • 5.7 核心选项
    • 5.8 日志后端
    • 5.9 网络选项
    • 5.10 图形、打印、控件选项
    • 5.11 平台后端
    • 5.12 输入后端
    • 5.13 图像格式
    • 5.14 数据库选项
    • 5.15 Qt3D 选项
    • 5.16 其他图像格式选项
    • 5.17 多媒体选项
    • 5.18 QtQuick3D 选项
    • 5.19 TextToSpeech 选项
    • 5.20 WebEngine 选项
  • 6 问题记录
  • • 6.1 `WARNING: QDoc will not be compiled,`
    • 6.2 `WARNING: QtWebEngine will not be built.`
    • 6.3 `Note: Disabling X11 Accessibility Bridge: D-Bus or AT-SPI is missing.`
    • 6.4 `Project ERROR: Building QtQml requires Python.`
    • 6.5 `class numeric_limits<QT_PREPEND_NAMESPACE(qfloat16)>`
    • 6.6 内存不足`No space left on device`
    • 6.7 `error: ‘runtime_error’ is not a member of ‘std’`
    • 6.8 `error: ‘int32_t’ was not declared in this scope`
    • 6.9 `Project ERROR: Missing archive files from QtWebEngineCore linking pri`
    • 6.10 `WARNING: Static builds of QtWebEngine are not supported.`
    • 6.11 编译帮助文档报错`Error parsing JSON at 1:1: illegal value`
    • 6.12 `ninja: build stopped: subcommand failed.`
    • 6.13 `error: xpath_grammar. hh: No such file or directory`
    • 6.14 缺少ninja报错
    • 6.15 `style.SortIncludes = false;`
    • 6.16 ubuntu22.04编译qtwebengine后无法打开html
    • 6.17 `undefined reference to pthread_create`

1 前言

本文演示了在ubuntu中编译Qt5.14.2源码，包含了Qt库、Qt帮助文档、QtWebEngine、qtcreator等，支持动态编译、静态编译；

编译Qt源码最重要的是需要看支持环境；

1. 第一步：系统是否支持，不支持的系统也可以编译，不过编译过程中会出现各种问题，解决起来很复杂，例如在ubuntu22.04中编译Qt5.14.2就可以编译，但是问题很多；
2. 第二步：编译器、构建工具、依赖库版本是否支持，最好选择推荐版本或者相差不大版本，否则肯定出问题，并且官方文档说的版本不一定可靠，有些版本不能按qt官方文档来；
3. 第三步：新手不要编译QtWebEngine，编译时间长、硬件要求高、问题多；
4. 第四步：先完成动态编译再考虑静态编译，静态编译问题比动态编译多；
5. 满足了这几步后，基本上90%问题就没有了。

2 参考文档

系统版本：

• 适用于 Linux/X11 的 Qt |第 5.15 期

• 适用于 Linux/X11 的 Qt |第 5.14 季度

• 支持的平台 |第 5.14 季度

• 支持的平台 |第 5.15 期

构建Qt源码：

• Qt for X11 要求 |第 5.14 季度

• 从Git构建Qt 5 - Qt Wiki

• 从Git构建Qt 6 - Qt Wiki

• Building Qt Sources | Qt 5.15

• Building Qt Sources | Qt 6.8

Qt构建选项：

• Qt 配置选项 |第 5.15 期

构建Qtcreator：

• 从 Git 构建 Qt Creator - Qt Wiki

• 在 Ubuntu 22.04 上从 Git 构建 Qt Creator - Qt Wiki

构建Qt帮助文档：

• 为 QDoc 安装 Clang |QDoc 手册 5.14.2
• 构建 Qt 文档 - Qt Wiki

构建QtWebEngine：

• QtWebEngine - Qt Wiki

• QtWebEngine/Qt5Build - Qt Wiki

• QtWebEngine/Chromium版本 - Qt Wiki

• chromium Linux构建说明

clang下载：

• Index of /development_releases/prebuilt/libclang/qt
• LLVM 下载页面
• 发布 ·llvm/llvm 项目

3 下载源码

3.1 方法1

• 进入github下载；
• 或者使用git clone https://github.com/qt/qt5.git或者git clone https://code.qt.io/qt/qt5.git下载；
• 然后使用git tags查看版本；
• 使用git checkout v5.14.2切换版本；
• 使用perl init-repository下载子仓库，或者使用git submodule update --init --recursive ；

3.2 方法2

• 进入Index of /official_releases/qt下载新版本qt源码；

• 或者进入Index of /archive/qt下载旧版本qt源码；

• 不过国内被屏蔽了，可能无法访问；

• 如下所示，下载源码；

  

3.3 方法3

• 安装Qt时勾选source；

• 然后进入Qt安装路径下，src文件夹内就是源码。

  

4 ubuntu编译qt源码

• 注意：使用ubuntu22.04编译Qt源码正常，但是编译QtWebEngine后无法加载html，并且编译源码过程中报错比较多。

4.1 环境准备

# 高版本系统需要将python改成python2，将g++改为g++-7或者g++-9
sudo apt-get install build-essential perl python3 python git g++ 
sudo ln /usr/bin/python2 /usr/bin/python  # 将python2创建链接为python，防止找不到
# Libxcb 的
sudo apt-get install '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev
# Qt WebKit（Qt WebKit）
sudo apt-get install flex bison gperf libicu-dev libxslt-dev ruby
# Qt Web引擎
sudo apt-get install libxcursor-dev libxcomposite-dev libxdamage-dev libxrandr-dev libxtst-dev libxss-dev libdbus-1-dev libevent-dev libfontconfig1-dev libcap-dev libpulse-dev libudev-dev libpci-dev libnss3-dev libasound2-dev libegl1-mesa-dev gperf bison nodejs flex 
#Qt多媒体
sudo apt-get install libasound2-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-good1.0-dev libgstreamer-plugins-bad1.0-dev
# QDoc文档生成(注意版本)
sudo apt install clang libclang-dev
#或者指定使用-9版本
sudo apt install clang-9 libclang-9-dev

# 完整依赖
sudo apt install libfontconfig1-dev libfreetype6-dev libx11-dev libx11-xcb-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev libxcb1-dev libxcb-glx0-dev libxcb-keysyms1-dev libxcb-image0-dev libxcb-shm0-dev libxcb-icccm4-dev libxcb-sync-dev libxcb-xfixes0-dev libxcb-shape0-dev libxcb-randr0-dev libxcb-render-util0-dev  libxkbcommon-dev libxkbcommon-x11-dev libatspi2.0-dev

4.2 设置交换分区大小

• 当多线程编译时，内存和交换分区消耗会很大，以16线程编译为例子，26G略显不足；

• 当内存不足是，容易导致ninja报错。

• 在 Ubuntu 上设置 swap（交换分区/交换文件）大小，可以按照以下步骤操作：

  1. 查看当前 swap 情况

     swapon --show
     free -h
     

  2. 关闭并删除现有 swap（如果需要调整大小）

     sudo swapoff -a
     sudo rm /swapfile
     

  3. 创建新的 swap 文件（以 4G 为例）

     sudo fallocate -l 4G /swapfile
     sudo chmod 600 /swapfile
     sudo mkswap /swapfile
     sudo swapon /swapfile
     

  4. 设置开机自动挂载：编辑 /etc/fstab 文件，添加如下内容（如果已存在则修改）：

     /swapfile none swap sw 0 0
     

  5. 再次确认 swap

     swapon --show
     free -h
     

  6. 可选：调整 swappiness（影响 swap 使用频率）

     sudo sysctl vm.swappiness=10
     

• 如果设置sudo swapon /swapfile时报错：swapon: /swapfile: read swap header failed则从头再设置。

4.3 编译源码

mkdir build
cd build
export LLVM_INSTALL_DIR=/usr/lib/llvm-9 # 设置llvm环境变量（临时）,也可以加入.bashrc文件
# 编译静态库（不编译QtWebEngine）
../configure -developer-build -opensource -nomake examples -nomake tests -skip qtwebengine --prefix=/opt/qt5.14.2/ -static  -release  -force-debug-info -separate-debug-info 
# 编译动态库（不编译QtWebEngine）
../configure -developer-build -opensource -nomake examples -nomake tests -skip qtwebengine --prefix=/opt/qt5.14.2/  -release -force-debug-info -separate-debug-info 
# 编译动态库（编译QtWebEngine）
../configure -developer-build -opensource -nomake examples -nomake tests --prefix=/opt/qt5.14.2/  -release -force-debug-info -separate-debug-info
#加速编译，如果ninja报错了就改成-j1显示错误信息
export NINJAJOBS="-j8"
make -j8
make install

4.4 添加环境变量

export PATH="/opt/qt5.14.2/bin:$PATH"
export LD_LIBRARY_PATH="/opt/qt5.14.2/lib:$LD_LIBRARY_PATH"

4.5 验证编译结果

• 准备一个Qt程序源码；

• test.pro

  QT       += core gui
  greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
  CONFIG += c++17
  SOURCES +=  main.cpp
  

• main.cpp

  #include <QApplication>
  #include <QWidget>
  
  int main(int argc, char* argv[])
  {
      QApplication a(argc, argv);
  
      QWidget w;
      w.show();
      return a.exec();
  }
  

• 运行/opt/qt5.14.2/bin/qmake Test.pro命令生成Makefile文件；

• 运行make编译；

• 运行./Test运行程序；

• 使用ldd ./Test查看可执行程序依赖，如下图所示依赖中没有Qt库，证明静态编译成功；

  

• 如下图所示：QtWebEngine编译运行成功，演示代码

  

4.6 编译帮助文档（qch）

• 编译前提：

  • 查看构建要求：构建 Qt 文档 - Qt Wiki
  • Qt源码构建完成，并且构建了qttools子工程；
  • 使用ls /opt/qt5.14.2/bin查看编译后成功生成了qdoc可执行程序；

• 构建命令：

  # 进入qt源码路径
  mkdir build
  cd build
  # 不是必要，如果报错，则更具报错信息使用-skip跳过对应子工程
  ../configure -opensource -make libs -skip qtwebengine -skip qttools -skip qtdeclarative --prefix=/opt/qt5.14.2/ 
  
  make docs
  make install_docs
  

• 编译成功后如下所示：

  

  

4.7 编译QtCreator

• 编译前提：

  • github下载源码
  • 或者Index of /archive/qtcreator、Index of /official_releases/qtcreator下载源码；
  • 然后查看源码中的README.md中的编译说明；

  

  • 注意：如果编译Qt源码时没有编译QtWebEngine则无法编译QtCreator；
  • 使用sudo apt install cmake cmake-gui安装cmake；
  • 由于ubuntu中apt安装默认最高只有10，而使用clang10以下版本会报错；
  • 进入github下载clang+llvm-11.1.0-x86_64-linux-gnu-ubuntu-16.04.tar.xz
  • 解压到本地；

• 开始编译：

  • 将qtcreator源码中的CMakeLists.txt拖进cmake中，点击【Configure】，选择Makefile；

    

  • 将Clang-DIR、LLVM_DIR设置为解压的clang路径；

  

  • 修改CMAKE_INSTALL_PREFIX设置安装路径；
  • 点击【Configure】【Generate】;
  • 然后打开终端进入qtcreator/build路径；
  • 运行make、make install；
  • 打开.bashrc，添加环境变量；

  export PATH="/opt/qtcreator/bin:$PATH"
  export LD_LIBRARY_PATH="/opt/qtcreator/lib:$LD_LIBRARY_PATH"
  

• 验证结果；

  • 编译完成后进入bin文件夹；
  • 运行./qtcreator；

  

5 help

用法： configure [options] [assignments]

Configure 支持在命令行中像 VAR=value 这样的变量赋值。每个大写的库名（可通过 -list-libraries 获取）支持后缀 _INCDIR、_LIBDIR、_PREFIX（INCDIR=PREFIX/include, LIBDIR=PREFIX/lib）、_LIBS，以及在 Windows 和 Darwin 上的 _LIBS_DEBUG 和 _LIBS_RELEASE。例如：
ICU_PREFIX=/opt/icu42 ICU_LIBS=“-licui18n -licuuc -licudata”。

也可以操作任何 QMAKE_* 变量，以修正 mkspec 中 Qt 自身构建的值，例如：QMAKE_CXXFLAGS+=-g3。

注意，_LIBS 和 QMAKE_* 赋值操作的是列表，因此包含元字符（尤其是空格）的项需要按照 qmake 规则加引号。此外，整个赋值还需要按照 shell 规则加引号。推荐内部使用单引号，外部使用双引号。

5.1 顶层安装目录

5.2 安装目录布局微调

• （除 -sysconfdir 外，所有目录应位于 -prefix/-hostprefix 下）

其余选项的约定：当选项说明后跟有值列表时，含义如下：

• yes 表示仅有该选项；其他值为该选项的可能前缀，例如 -no-gui。
• 也可以赋值，如 --gui=yes。
• 值按未指定时的尝试顺序排列；auto 是 yes/no 的简写。
• 单独的 yes 和 no 表示无自动检测的二元选项。

5.3 Configure 元选项

5.4 构建选项

5.5 构建环境

5.6 组件选择

Qt 自带部分第三方库的捆绑副本。若自动检测系统库失败，则默认使用这些副本。

5.7 核心选项

5.8 日志后端

5.9 网络选项

5.10 图形、打印、控件选项

5.11 平台后端

5.12 输入后端

5.13 图像格式

5.14 数据库选项

5.15 Qt3D 选项

5.16 其他图像格式选项

5.17 多媒体选项

5.18 QtQuick3D 选项

5.19 TextToSpeech 选项

5.20 WebEngine 选项

6 问题记录

6.1 WARNING: QDoc will not be compiled,

• 报错信息：

  WARNING: QDoc will not be compiled, probably because libclang could not be located.   This means that you cannot build the Qt documentation.
  

• 问题原因：找不到libclang路径

• 解决办法：

  • 使用sudo apt install clang libclang-dev安装libclang；
  • 在运行…/configure构建命令前，使用export LLVM_INSTALL_DIR=/usr/lib/llvm-14命令添加环境变量，可以先使用ls /usr/lib/llvm*命令查看路径下是否有llvm安装目录。

6.2 WARNING: QtWebEngine will not be built.

• 报错信息：

  Note: The following modules are not being compiled in this configuration:
  webenginecore
  webengine
  webenginewidgets
  
  WARNING: Tool flex is required to build QtWebEngine.
  
  WARNING: Python version 2 (2.7.5 or later) is required to build QtWebEngine.
  
  WARNING: QtWebEngine will not be built.
  WARNING: QtPdf will not be built.
  

• 问题原因：缺少flex依赖；

• 解决办法：使用sudo apt install flex python2安装依赖；

6.3 Note: Disabling X11 Accessibility Bridge: D-Bus or AT-SPI is missing.

• 报错信息：

  Note: Disabling X11 Accessibility Bridge: D-Bus or AT-SPI is missing.
  

• 问题原因：缺少libdbus-1-dev或者libatspi2.0-dev；

• 解决办法：使用命令sudo apt install libdbus-1-dev libatspi2.0-dev安装依赖，如果不存在，就使用sudo apt install libatspi命令，按Tab键查看可安装的版本；

6.4 Project ERROR: Building QtQml requires Python.

• 报错信息：执行make、make install后报错如下

  sh: 1: python: not found
  Project ERROR: Building QtQml requires Python.
  make: *** [Makefile:352: module-qtdeclarative-install_subtargets] Error 3
  

• 问题原因：编译QtQml找不到python；

• 解决办法：

  • 使用sudo apt install python或者sudo apt install python2安装；
  • 安装后使用python --version或者python2 --version看是否安装成功；
  • 如果python --version无法显示版本，而python2 --version可以显示版本；
  • 则使用sudo ln /usr/bin/python2 /usr/bin/python创建链接；

6.5 class numeric_limits<QT_PREPEND_NAMESPACE(qfloat16)>

• 报错信息：执行make时报错如下

  class numeric_limits<QT_PREPEND_NAMESPACE(qfloat16)> : public numeric_limits<float>
  5.14.2/qtbase/include/QtCore/../../src/corelib/global/qfloat16.h:295:7: error: ‘numeric_limits’ is not a class template
  295 | class numeric_limits<QT_PREPEND_NAMESPACE(qfloat16)> : public numeric_limits<float>
  |       ^~~~~~~~~~~~~~
  

• 解决办法：打开qtbase/src/corelib/global/qglobal.h，添加#include <limits>；

  #ifdef __cplusplus
  #  include <type_traits>
  #  include <cstddef>
  #  include <utility>
  #  include <limits>
  #endif
  

6.6 内存不足No space left on device

• 报错信息：执行make编译到一半报错如下

  cannot write PCH file: No space left on device
  

• 问题原因：系统内存不足。

6.7 error: ‘runtime_error’ is not a member of ‘std’

• 报错信息：执行make install时报错如下

  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/platform/default/bidi.cpp: In member function ‘void mbgl::BiDi::mergeParagraphLineBreaks(std::set<long unsigned int>&)’:
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/platform/default/bidi.cpp:63:24: error: ‘runtime_error’ is not a member of ‘std’
  63 |             throw std::runtime_error(std::string("ProcessedBiDiText::mergeParagraphLineBreaks: ") +
  |                        ^~~~~~~~~~~~~
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/platform/default/bidi.cpp: In member function ‘std::vector<std::__cxx11::basic_string<char16_t> > mbgl::BiDi::processText(const u16string&, std::set<long unsigned int>)’:
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/platform/default/bidi.cpp:98:20: error: ‘runtime_error’ is not a member of ‘std’
  98 |         throw std::runtime_error(std::string("BiDi::processText: ") + u_errorName(errorCode));
  |                    ^~~~~~~~~~~~~
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/platform/default/bidi.cpp: In member function ‘std::u16string mbgl::BiDi::getLine(std::size_t, std::size_t)’:
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/platform/default/bidi.cpp:109:20: error: ‘runtime_error’ is not a member of ‘std’
  109 |         throw std::runtime_error(std::string("BiDi::getLine (setLine): ") + u_errorName(errorCode));
  |                    ^~~~~~~~~~~~~
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/platform/default/bidi.cpp:125:20: error: ‘runtime_error’ is not a member of ‘std’
  125 |         throw std::runtime_error(std::string("BiDi::getLine (writeReordered): ") +
  |                    ^~~~~~~~~~~~~
  make[5]: *** [Makefile:3883: .obj/platform/default/bidi. o] Error 1
  make[5]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation/src/3rdparty/mapbox-gl-native'
  make[4]: *** [Makefile:215: sub-------3rdparty-mapbox-gl-native-install_subtargets] Error 2
  make[4]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation/src/plugins/geoservices'
  make[3]: *** [Makefile:85: sub-geoservices-install_subtargets] Error 2
  make[3]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation/src/plugins'
  make[2]: *** [Makefile:248: sub-plugins-install_subtargets] Error 2
  make[2]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation/src'
  make[1]: *** [Makefile:61: sub-src-install_subtargets] Error 2
  make[1]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation'
  make: *** [Makefile:828: module-qtlocation-install_subtargets] Error 2
  

• 问题原因：缺少stdexcept头文件；

• 解决办法：打开报错的文件，添加#include <stdexcept>

6.8 error: ‘int32_t’ was not declared in this scope

• 报错信息：执行make install时报错如下

  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/src/mbgl/util/convert.cpp:6:56: error: ‘int32_t’ was not declared in this scope
      6 | template std::array<float, 2> convert(const std::array<int32_t, 2>&);
        |                                                        ^~~~~~~
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/src/mbgl/util/convert.cpp:2:1: note: ‘int32_t’ is defined in header ‘<cstdint>’; did you forget to ‘#include <cstdint>’?
      1 | #include <mbgl/util/convert.hpp>
    +++ |+#include <cstdint>
      2 | 
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/src/mbgl/util/convert.cpp:6:66: error: template argument 1 is invalid
      6 | template std::array<float, 2> convert(const std::array<int32_t, 2>&);
        |                                                                  ^
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/src/mbgl/util/convert.cpp:6:31: error: template-id ‘convert<>’ for ‘std::array<float, 2> mbgl::util::convert(const int&)’ does not match any template declaration
      6 | template std::array<float, 2> convert(const std::array<int32_t, 2>&);
        |                               ^~~~~~~
  In file included from /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/src/mbgl/util/convert.cpp:1:
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtlocation/src/3rdparty/mapbox-gl-native/include/mbgl/util/convert.hpp:12:37: note: candidate is: ‘template<class To, class From, long unsigned int Size, class> constexpr std::array<To, Size> mbgl::util::convert(const std::array<_Tp, _Nm>&)’
     12 | MBGL_CONSTEXPR std::array<To, Size> convert(const std::array<From, Size>&from) {
        |                                     ^~~~~~~
  make[5]: *** [Makefile:59975: .obj/src/mbgl/util/convert.o] Error 1
  make[5]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation/src/3rdparty/mapbox-gl-native'
  make[4]: *** [Makefile:215: sub-------3rdparty-mapbox-gl-native-install_subtargets] Error 2
  make[4]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation/src/plugins/geoservices'
  make[3]: *** [Makefile:85: sub-geoservices-install_subtargets] Error 2
  make[3]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation/src/plugins'
  make[2]: *** [Makefile:248: sub-plugins-install_subtargets] Error 2
  make[2]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation/src'
  make[1]: *** [Makefile:61: sub-src-install_subtargets] Error 2
  make[1]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtlocation'
  make: *** [Makefile:828: module-qtlocation-install_subtargets] Error 2
  
  

• 问题原因：编译器无法识别 int32_t 类型；

• 解决办法：打开报错文件，包含头文件 int32_t 是 C/C++ 标准库中定义的类型，需要添加头文件：

  #include <cstdint>  // C++ 标准用法
  // 或
  #include <stdint.h> // C 风格头文件（兼容性更好）
  

6.9 Project ERROR: Missing archive files from QtWebEngineCore linking pri

• 报错信息：执行make编译时报错如下

  Project ERROR: Missing archive files from QtWebEngineCore linking pri
  make[3]: *** [Makefile:132: sub-core_module-pro-install_subtargets] Error 3
  make[3]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src/core'
  make[2]: *** [Makefile:90: sub-core-install_subtargets] Error 2
  make[2]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src'
  make[1]: *** [Makefile:61: sub-src-install_subtargets] Error 2
  make[1]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine'
  make: *** [Makefile:1100: module-qtwebengine-install_subtargets] Error 2
  

• 问题原因：不支持静态编译QtWebengine；

• 解决办法：configure构建时加上-skip qtwebengine；

6.10 WARNING: Static builds of QtWebEngine are not supported.

• 报错信息：执行configure构建后报错如下

  Note: The following modules are not being compiled in this configuration:
  webenginecore
  webengine
  webenginewidgets
  
  WARNING: Static builds of QtWebEngine are not supported.
  
  WARNING: QtWebEngine will not be built.
  
  WARNING: QtPdf will not be built.
  
  Qt is now configured for building.  Just run 'make'.
  Once everything is built, you must run 'make install'.
  Qt will be installed into '/opt/qt5.14.2'.
  
  Prior to reconfiguration, make sure you remove any leftovers from
  the previous build.
  

• 问题原因：不支持静态编译QtWebengine；

• 解决办法：configure构建时加上-skip qtwebengine；

6.11 编译帮助文档报错Error parsing JSON at 1:1: illegal value

• 报错信息：执行make docs编译时报错如下

  make[5]: Entering directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools/qmlpreview'
  make[5]: Nothing to be done for 'prepare_docs'.
  make[5]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools/qmlpreview'
  make[5]: Entering directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools/qmllint'
  make[5]: Nothing to be done for 'prepare_docs'.
  make[5]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools/qmllint'
  make[5]: Entering directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools/qmlcachegen'
  make[5]: Nothing to be done for 'prepare_docs'.
  make[5]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools/qmlcachegen'
  make[5]: Entering directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools/qmltestrunner'
  make[5]: Nothing to be done for 'prepare_docs'.
  make[5]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools/qmltestrunner'
  /home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools/qml/qmlimportscanner_wrapper.sh: 6: exec: /home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/bin/qmlimportscanner: not found
  /home/mhf/Code/qt-everywhere-src-5.14.2/qtbase/mkspecs/features/qt.prf:285: Error parsing JSON at 1:1: illegal value
  Project ERROR: Failed to parse qmlimportscanner output.
  make[4]: *** [Makefile:1007: sub-qml-prepare_docs] Error 3
  make[4]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative/tools'
  make[3]: *** [Makefile:643: sub-tools-prepare_docs] Error 2
  make[3]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtdeclarative'
  make[2]: *** [Makefile:2909: module-qtdeclarative-prepare_docs] Error 2
  make[2]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build'
  make[1]: *** [Makefile:2060: html_docs] Error 2
  make[1]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build'
  make: *** [Makefile:2063: docs] Error 2
  
  

• 问题原因：qtdeclarative子工程无法生成qch文档；

• 解决办法：使用configure构建时加上-skip qtdeclarative，如果报错的是其它子工程，就在-skip后改为对应的子工程就可以。

6.12 ninja: build stopped: subcommand failed.

• 报错信息：使用make编译QtWebengine时报错如下

ringssl/src/crypto/fipsmodule/bcm.c -o obj/third_party/boringssl/boringssl/bcm.o
ninja: build stopped: subcommand failed.
make[4]: *** [Makefile. gn_run:1263: run_ninja] Error 1
make[4]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src/core'
make[3]: *** [Makefile:82: sub-gn_run-pro-make_first] Error 2
make[3]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src/core'
make[2]: *** [Makefile:78: sub-core-make_first] Error 2
make[2]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src'
make[1]: *** [Makefile:49: sub-src-make_first] Error 2
make[1]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine'
make: *** [Makefile:1088: module-qtwebengine-make_first] Error 2

• 问题原因：由于某种错误导致ninja构建失败；

• 解决办法：

  • 默认情况下ninja构建失败可能看不到具体的错误信息；

  • 在终端中输入export NINJAJOBS="-j1"，然后再执行make就会显示报错信息，例如；

    ../../../../../qtwebengine/src/3rdparty/chromium/third_party/perfetto/include/perfetto/base/task_runner.h:48:55: error: ‘uint32_t’ has not been declared
       48 |   virtual void PostDelayedTask(std::function<void()>, uint32_t delay_ms) = 0;
          |             
    

  • 可能是内存不足、硬盘空间(18G)、交换分区不足；

  • 编译时如果内存不足或者交换分区不足则减少编译的线程数，如下所示使用16线程编译，26G内存都略显不足；

    • 解决办法1：将交换分区设置大一点；
    • 解决办法2：将NiNJAJOBS设置小一点，减少编译线程数。

    

    • 也可能是g++版本不支持，使用g+±11编译就会在编译到qtwebengine/src/core时报错，改为g+±9就正常了；

    • 使用sudo apt install g++-9安装；

    • 然后使用sudo ln /usr/bin/g++-9 /usr/bin/g++将g+±9创建别名；

    • 使用g++ -v命令检查版本；

6.13 error: xpath_grammar. hh: No such file or directory

• 报错信息：使用make编译qtwebengine时报错

/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src/core/release/gen/third_party/blink/renderer/core/xpath_grammar. cc:124:10: fatal error: xpath_grammar. hh: No such file or directory
124 | #include "xpath_grammar.hh"
|          ^~~~~~~~~~~~~~~~~~
compilation terminated.
ninja: build stopped: subcommand failed.
make[4]: *** [Makefile. gn_run:1263: run_ninja] Error 1
make[4]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src/core'
make[3]: *** [Makefile:82: sub-gn_run-pro-make_first] Error 2
make[3]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src/core'
make[2]: *** [Makefile:78: sub-core-make_first] Error 2
make[2]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src'
make[1]: *** [Makefile:49: sub-src-make_first] Error 2
make[1]: Leaving directory '/home/mhf/Code/qt-everywhere-src-5.14.2/build/qtwebengine'
make: *** [Makefile:1088: module-qtwebengine-make_first] Error 2

• 问题原因：似乎是由于bison版本过高导致

  • Qt Webengine 无法使用 Bison 3.7 进行编译 - Qt Bug Tracker
  • 734356 – dev-qt/qtwebengine-5.15.0 与 sys-devel/bison-3.7：//…/xpath_grammar.cc：致命错误：xpath_grammar.hh：没有这样的文件或目录
  • qt5-webengine：由于 Bison 3.7 导致构建失败 ·问题 #1096 ·Dylanaraps/社区

• 解决办法：

  • 使用sudo apt remove bison卸载bison；

  • 编译安装bison3.1；

    wget http://ftp.gnu.org/gnu/bison/bison-3.1.tar.gz
    tar -xzvf bison-3.1.tar.gz
    cd bison-3.1
    ./configure
    make
    sudo make install
    

  • 进入/Code/qt-everywhere-src-5.14.2/build/qtwebengine/src/core/release/gen/third_party/blink/renderer/core路径；

  • 使用gedit xpath_grammar.cc打开源文件；

  • 将#include "xpath_grammar.hh改为#include "xpath_grammar.h；

  • 然后再次执行make编译。

6.14 缺少ninja报错

• 报错信息：使用make编译qtcreator报错

#warning ClangFormat: building against unmodified Clang, see README. md for more info
^
1 warning generated.
make[1]: *** [CMakeFiles/Makefile2:9240: src/plugins/clangformat/CMakeFiles/ClangFormat. dir/all] Error 2
make[1]: *** Waiting for unfinished jobs....
[ 77%] Linking CXX shared library ../../../lib/qtcreator/plugins/libQbsProjectManager.so
[ 77%] Built target Debugger
[ 77%] Linking CXX shared library ../../../lib/qtcreator/plugins/libQmlJSEditor.so
[ 77%] Built target QbsProjectManager
[ 77%] Built target QmlJSEditor
make: *** [Makefile:136: all] Error 2

• 解决办法：使用sudo apt install ninja-build安装ninja；

6.15 style.SortIncludes = false;

• 报错信息：使用make编译qtcreator报错

/home/mhf/Code/qt-creator-opensource-src-4.15.2/src/plugins/clangformat/clangformatbaseindenter.cpp:45:26: error: assigning to 'clang::format::FormatStyle::SortIncludesOptions' from incompatible type 'bool'
    style.SortIncludes = false;
                         ^~~~~
1 error generated.
make[2]: *** [src/plugins/clangformat/CMakeFiles/ClangFormat.dir/build.make:94: src/plugins/clangformat/CMakeFiles/ClangFormat.dir/clangformatbaseindenter.cpp.o] Error 1
make[1]: *** [CMakeFiles/Makefile2:9240: src/plugins/clangformat/CMakeFiles/ClangFormat.dir/all] Error 2
make: *** [Makefile:136: all] Error 2

• 问题原因：由于clang版本不同，其中存在不兼容；

• 解决办法：

  • qtcreator源码中README.md版本要求安装clang；
  • 或者打开报错的文件，将false改为对应的枚举。

  // style.SortIncludes = false;
  style.SortIncludes = clang::format::FormatStyle::SI_Never;
  
  //style.SortIncludes = true;
  style.SortIncludes = clang::format::FormatStyle::SI_CaseSensitive;
  // style.SpacesInAngles = false;
  style.SpacesInAngles = clang::format::FormatStyle::SIAS_Never;
  

6.16 ubuntu22.04编译qtwebengine后无法打开html

• 报错信息：在ubuntu22.04上编译的qtwebengine可以正常编译，但是运行后无法打开html

  Warning: Ignoring XDG_SESSION_TYPE=wayland on Gnome. Use QT_QPA_PLATFORM=wayland to run on Wayland anyway.
  QSocketNotifier: Can only be used with threads started with QThread
  

6.17 undefined reference to pthread_create

• 报错信息：使用clang-10编译qtcreator4.15.2时报错

  Determining if the pthread_create exist failed with the following output:
  Change Dir: /home/mhf/Code/qt-creator-opensource-src-4.15.2/build/CMakeFiles/CMakeTmp
  
  Run Build Command:"/usr/bin/make" "cmTC_c9727/fast"
  /usr/bin/make -f CMakeFiles/cmTC_c9727.dir/build. make CMakeFiles/cmTC_c9727.dir/build
  make[1]: Entering directory '/home/mhf/Code/qt-creator-opensource-src-4.15.2/build/CMakeFiles/CMakeTmp'
  Building C object CMakeFiles/cmTC_c9727.dir/CheckSymbolExists.c.o
  /usr/bin/cc    -o CMakeFiles/cmTC_c9727.dir/CheckSymbolExists.c. o   -c /home/mhf/Code/qt-creator-opensource-src-4.15.2/build/CMakeFiles/CMakeTmp/CheckSymbolExists.c
  Linking C executable cmTC_c9727
  /usr/bin/cmake -E cmake_link_script CMakeFiles/cmTC_c9727.dir/link.txt --verbose=1
  /usr/bin/cc      CMakeFiles/cmTC_c9727.dir/CheckSymbolExists.c. o  -o cmTC_c9727
  CMakeFiles/cmTC_c9727.dir/CheckSymbolExists.c. o: In function `main':
  CheckSymbolExists.c:(.text+0x1b): undefined reference to `pthread_create'
  collect2: error: ld returned 1 exit status
  CMakeFiles/cmTC_c9727.dir/build. make:97: recipe for target 'cmTC_c9727' failed
  make[1]: *** [cmTC_c9727] Error 1
  make[1]: Leaving directory '/home/mhf/Code/qt-creator-opensource-src-4.15.2/build/CMakeFiles/CMakeTmp'
  Makefile:126: recipe for target 'cmTC_c9727/fast' failed
  make: *** [cmTC_c9727/fast] Error 2
  
  File /home/mhf/Code/qt-creator-opensource-src-4.15.2/build/CMakeFiles/CMakeTmp/CheckSymbolExists.c:
  /* */
  #include <pthread.h>
  
  int main(int argc, char** argv)
  {
  (void)argv;
  #ifndef pthread_create
  return ((int*)(&pthread_create))[argc];
  #else
  (void)argc;
  return 0;
  #endif
  }
  
  Determining if the function pthread_create exists in the pthreads failed with the following output:
  Change Dir: /home/mhf/Code/qt-creator-opensource-src-4.15.2/build/CMakeFiles/CMakeTmp
  
  Run Build Command:"/usr/bin/make" "cmTC_f3a0e/fast"
  /usr/bin/make -f CMakeFiles/cmTC_f3a0e.dir/build. make CMakeFiles/cmTC_f3a0e.dir/build
  make[1]: Entering directory '/home/mhf/Code/qt-creator-opensource-src-4.15.2/build/CMakeFiles/CMakeTmp'
  Building C object CMakeFiles/cmTC_f3a0e.dir/CheckFunctionExists.c.o
  /usr/bin/cc   -DCHECK_FUNCTION_EXISTS=pthread_create   -o CMakeFiles/cmTC_f3a0e.dir/CheckFunctionExists.c. o   -c /usr/share/cmake-3.10/Modules/CheckFunctionExists.c
  Linking C executable cmTC_f3a0e
  /usr/bin/cmake -E cmake_link_script CMakeFiles/cmTC_f3a0e.dir/link.txt --verbose=1
  /usr/bin/cc  -DCHECK_FUNCTION_EXISTS=pthread_create    CMakeFiles/cmTC_f3a0e.dir/CheckFunctionExists.c. o  -o cmTC_f3a0e -lpthreads
  /usr/bin/ld: cannot find -lpthreads
  collect2: error: ld returned 1 exit status
  CMakeFiles/cmTC_f3a0e.dir/build. make:97: recipe for target 'cmTC_f3a0e' failed
  make[1]: *** [cmTC_f3a0e] Error 1
  make[1]: Leaving directory '/home/mhf/Code/qt-creator-opensource-src-4.15.2/build/CMakeFiles/CMakeTmp'
  Makefile:126: recipe for target 'cmTC_f3a0e/fast' failed
  make: *** [cmTC_f3a0e/fast] Error 2
  

• 错误原因：clang10不兼容；

• 解决办法：下载clang11编译。