分类 Linux 下的文章

构建环境

环境要求

用于进行Qt 6.5.7源码编译的机器环境需满足以下要求:

  • 可用于编译的物理内存 + SWAP交换区 空间 > 40GB;同等条件下,物理内存越大,编译速度越快
  • 可用于编译的磁盘空间 > 160GB
  • 建议用于编译的CPU核心数 ≥ 16

规避内存不足问题

# 当物理内存无法满足编译条件时,可提供足够大的SWAP

# 取消当前所有SWAP文件
sudo swapoff -a

# 取消指定SWAP文件则指定具体的SWAP文件名, 如:
# sudo swap off /swapfile

# 创建一个40GB的SWAP文件/swapfile
# 若已存在SWAP文件, 重新分配大小则先取消该文件的挂载, 然后重新分配该文件的大小
sudo fallocate -l 40G /swapfile

# 设置权限, 否则系统拒绝使用
sudo chmod 600 /swapfile

# 格式化为 SWAP
sudo mkswap /swapfile

# 启用
sudo swapon /swapfile

# 检查是否生效
free -h

# 若希望重启操作系统后新增 SWAP 仍然生效,则编辑 /etc/fstab, 加上这一行
/swapfile none swap sw 0 0

# 临时减少 Swap 使用频率(强烈建议):
sudo sysctl vm.swappiness=10

# 若希望减少 SWAP 使用频率配置永久生效, 则
echo "vm.swappiness=10" | sudo tee -a /etc/sysctl.conf

构建依赖

  • 下述构建过程将启用Qt 6.5.7在Linux环境下的所有组件功能。
  • 凡Qt自带副本的依赖项,均使用Qt自带副本进行编译而不使用系统环境所提供版本:

    • zlib
    • libpng
    • freetype
    • harfbuzz
    • pcre2
    • libjpeg
    • sqlite
    • webengine-*
    • double-conversion
请注意部分软件包,在不同版本的操作系统之上包名不同,若出现部分包不存在的情况,请搜索在该系统上相应包,获取到实际的包名进行安装。若受限于系统版本而无法直接安装时请选择从源码编译安装。

更新缓存

sudo apt-get update -y
sudo apt-get install -y software-properties-common

sudo add-apt-repository universe
sudo apt-get update -y 

编译工具

sudo apt-get install -y \
    build-essential \
    perl \
    git \
    ninja-build \
    pkg-config \
    gcc \
    g++ \
    cmake \
    gdb \
    wget \
    curl \
    ccache

#clang和llvm装12-15版本
sudo apt-get install -y \
    clang-14 \
    libclang-14-dev \
    llvm-14 \
    llvm-14-dev \
    npm
    

升级pthread、ldd

sudo apt-get install -y \
    libpthread* \
    ldd

基础依赖

sudo apt-get install -y \
    libdbus-1-dev \
    libinput-dev \
    libmtdev-dev \
    libevdev-dev
非开发环境(运行时库)
# libudev-dev的运行时库
 sudo apt-get install -y \
    libudev1

XCB&X11全家桶

必须依赖项

# xcb-proto提供协议定义文件,用于生成XCB的各种扩展库(如XRandR、Xinerama、XInput等;编译依赖X11或Qt/XCB后端的程序时,需要它生成头文件和接口
# X11 协议头文件和开发包
sudo apt-get install -y \
    xcb-proto \
    libxproto-dev

sudo apt-get install -y \
    libx11-dev \
    libx11-xcb-dev \
    libxext-dev \
    libxfixes-dev \
    libxi-dev \
    libxrender-dev \
    libxrandr-dev \
    libxkbcommon-dev libxkbcommon-x11-dev \
    libxinerama-dev \
    libxss-dev \
    libxtst-dev \
    libxcursor-dev \
    libxdamage-dev \
    libxcomposite-dev \
    libxshmfence-dev \
    libxkbfile-dev
# XCB
# libxcb-xv-dev在不同版本Ubuntu上包名不同, 根据实际搜索结果调整包名
sudo apt-get install -y \
    libxcb1-dev \
    libxcb-keysyms1-dev \
    libxcb-render0-dev \
    libxcb-shape0-dev \
    libxcb-shm0-dev \
    libxcb-xfixes0-dev \
    libxcb-icccm4-dev \
    libxcb-image0-dev \
    libxcb-util-dev \
    libxcb-xinerama0-dev \
    libxcb-randr0-dev \
    libxcb-sync-dev \
    libxcb-xkb-dev \
    libxcb-cursor-dev \
    libxcb-render-util0-dev \
    libxcb-ewmh-dev \
    libxcb-util0-dev \
    libsm-dev \
    libxcb-xinput-dev \
    libxcb-xv-dev \
    libxcb-xv0-dev \
    libxcb-xvmc0-dev \
    libxcb-glx0-dev

运行时库(非开发环境)

# 核心 XCB 运行时库,提供基本的 X11 客户端接口
# XCB 的工具库,提供常用函数、辅助数据结构和便利 API
# 支持键盘按键映射(KeySym)解析,用于处理键盘输入
# 图像处理扩展库,允许 X11 图像操作(像素数据读取/写入)
# ICCCM(Inter-Client Communication Conventions Manual)支持库,用于客户端间通信和窗口管理约定
# X Render 扩展工具库,提供渲染相关的辅助函数(抗锯齿、Alpha 混合等)
# Xinerama 扩展支持库,用于多显示器管理
# X11 光标管理扩展库,允许程序操作鼠标光标
# X Keyboard 扩展库,提供键盘布局、按键状态和事件管理
# EWMH(Extended Window Manager Hints)扩展,窗口管理器交互
sudo apt-get install -y \
    libxcb1 \
    libxcb-util1 \
    libxcb-keysyms1 \
    libxcb-image0 \
    libxcb-icccm4 \
    libxcb-render-util0 \    
    libxcb-xinerama0 \
    libxcb-cursor0 \
    libxcb-xkb1 \
    libxcb-ewmh2

附加项

# XCB
# XCB 国际化(Input Method)扩展。
# X Composite 扩展,用于透明窗口、合成效果。
# Damage 扩展,用于检测屏幕更新区域,常用于远程桌面和 compositor
# DPMS 扩展,用于显示器电源管理
# DRI2/DRI3(Direct Rendering Infrastructure)开发包,用于 GPU 加速渲染
# GLX 扩展开发包,OpenGL 与 X11 窗口交互
# Present 扩展开发包,用于同步显示更新,减少撕裂
# Record 扩展,用于记录或截取 X11 事件
# RES 扩展开发包,用于屏幕分辨率管理
# Screensaver 扩展,用于防屏保管理
# XFree86 DRI 扩展,用于 GPU 访问
# X资源管理(X Resource Manager)扩展,用于应用配置
# XTest 扩展,用于模拟输入事件(键盘/鼠标)
# X Video 扩展开发包,用于视频渲染
# X Video Motion Compensation 扩展开发包,用于硬件视频解码加速
# XFree86 VidMode 扩展开发包,用于屏幕模式切换和显存管理
# 数据压缩库和命令行工具,某些 X11 扩展或缓存会用到压缩
# tslib 的开发包,用于旧式触摸屏输入事件处理(多用于嵌入式设备)
# XSLT 样式表处理库开发包,用于 XML 转换和解析,很多桌面程序或构建工具可能依赖它
# XSLT 样式表处理库开发包,用于 XML 转换和解析,很多桌面程序或构建工具可能依赖它
sudo apt-get install -y \
    \
    libxcb-imdkit-dev \
    libxcb-composite0-dev \
    libxcb-damage0-dev \
    libxcb-dpms0-dev \
    libxcb-dri2-0-dev \
    libxcb-present-dev \
    libxcb-record0-dev \
    libxcb-res0-dev \
    libxcb-screensaver0-dev \
    libxcb-xf86dri0-dev \
    libxcb-xrm-dev \
    libxcb-xtest0-dev \
    \
    libxxf86vm-dev \
    libzstd-dev \
    libts-dev \
    libxslt-dev \
    libxslt1-dev

运行时库(非开发环境)

# XCB 国际化(Input Method)扩展。 
# Damage 扩展,用于检测屏幕更新区域,常用于远程桌面和 compositor
# DPMS 扩展,用于显示器电源管理
# DRI2/DRI3(Direct Rendering Infrastructure)开发包,用于 GPU 加速渲染
# Record 扩展,用于记录或截取 X11 事件
# Screensaver 扩展,用于防屏保管理
# XFree86 DRI 扩展,用于 GPU 访问    
# X资源管理(X Resource Manager)扩展,用于应用配置
# XTest 扩展,用于模拟输入事件(键盘/鼠标)
#X Video Motion Compensation 扩展开发包,用于硬件视频解码加速
# XCB 文档,包含接口说明和协议文档
sudo apt-get install -y \
    libxcb-imdkit0 \
    libxcb-damage0 \
    libxcb-dpms0 \
    libxcb-dri3-dev \
    libxcb-record0 \
    libxcb-screensaver0 \
    libxcb-xf86dri0 \
    libxcb-xrm0 \
    libxcb-xtest0 \
    libxcb-xvmc0 \
    libxcb-doc
# X11
# Damage 扩展运行时库,检测屏幕区域更新 
# XKB common 文档和工具,用于键盘布局管理   
# XKB common 文档和工具,用于键盘布局管理
# 用于 GPU/CPU 之间的同步 fence,配合 OpenGL/DRI 渲染    
# X11 核心库文档  
# X11 的 Perl 模块,主要用于测试、自动化、窗口管理或 X11 接口交互 
# X11 的 Perl 模块,主要用于测试、自动化、窗口管理或 X11 接口交互   
# X11 的 Perl 模块,主要用于测试、自动化、窗口管理或 X11 接口交互    
# X11 的 Perl 模块,主要用于测试、自动化、窗口管理或 X11 接口交互    
# X11 的 Perl 模块,主要用于测试、自动化、窗口管理或 X11 接口交互    
# X11 的 Perl 模块,主要用于测试、自动化、窗口管理或 X11 接口交互    
# xine 多媒体框架的二进制和开发包,支持音视频播放和各种解码器插件
# xine 多媒体框架的二进制和开发包,支持音视频播放和各种解码器插件
# xine 多媒体框架的二进制和开发包,支持音视频播放和各种解码器插件    
# xine 多媒体框架的二进制和开发包,支持音视频播放和各种解码器插件
# 数据压缩库和命令行工具,某些 X11 扩展或缓存会用到压缩
sudo apt-get install -y \
    libxdamage1 \
    libxkbcommon-doc \
    libxkbcommon-tools \
    libxshmfence1 \
    libx11-doc \
    libx11-freedesktop-desktopentry-perl \
    libx11-guitest-perl \
    libx11-keyboard-perl \
    libx11-protocol-other-perl \
    libx11-windowhierarchy-perl \
    libx11-xcb-perl \
    libxine2-bin \
    libxine2-dev \
    libxine2-misc-plugins \
    libxine2-plugins \
    \
    zstd

OpenGL

# OpenGL 开发包,提供核心 OpenGL API 头文件和库
# EGL 开发包,用于 OpenGL/ES 与窗口系统(X11/Wayland)交互
# OpenGL ES 2.x 开发包,适合嵌入式或移动平台
# GLU(OpenGL Utility Library)开发包,提供矩阵、曲面和辅助函数
# GLib 2 开发包,提供数据结构、事件循环、线程、字符串处理等通用基础功能
# Mesa 图形库通用开发文件,OpenGL/OpenGL ES 的基础依赖
# 一般用于提供标准 OpenGL 链接接口(大部分发行版通过 Mesa 提供实现)
# GLFW 库开发包,用于创建窗口、OpenGL 上下文和处理输入事件
# SDL 1.2 开发包,提供跨平台窗口、渲染、输入和音频管理接口
sudo apt-get install -y \
    libgl1-mesa-dev \
    libegl1-mesa-dev \
    libgles2-mesa-dev \
    libglu1-mesa-dev \
    libglib2.0-dev \
    mesa-common-dev \
    libopengl-dev \
    libglfw3-dev \
    libsdl1.2-dev

运行时

# GLib 2 的运行时库
# EGL 的运行时库,用于程序实际渲染
sudo apt-get install -y \
    libglib2.0-0 \
    libegl1-mesa

OpenSSL

sudo apt-get install -y \
    libssl-dev

图形、字体

sudo apt-get install -y  \
    libfontconfig1-dev \
    libvulkan-dev \
    libvulkan1 \
    mesa-common-dev \
    libglu1-mesa-dev \
    freeglut3-dev \
    libgtk-3-dev \
    libgtk2.0-dev \
    libjpeg-dev \
    libfreetype6-dev
    

蓝牙

sudo apt-get install -y \
    libbluetooth-dev \
    bluez 

串口

sudo apt-get install -y \
    libudev-dev \
    libserialport-dev

多媒体

sudo apt-get install -y \
    libasound2-dev \
    libpipewire-0.3-dev \
    libpulse-dev
# GStreamer
sudo apt-get install -y \
    libgstreamer1.0-dev \
    libgstreamer-plugins-base1.0-dev \
    gstreamer1.0-plugins-base \
    gstreamer1.0-plugins-good \
    gstreamer1.0-plugins-bad \
    gstreamer1.0-plugins-ugly \
    gstreamer1.0-libav \
    gstreamer1.0-tools

QtWayland依赖

# Wayland EGL 后端开发包,主要用于在 Wayland 显示服务器上进行 OpenGL / EGL 渲染 的开发
sudo apt-get install -y \
    wayland-protocols \
    libwayland-dev \
    libwayland-egl-backend-dev

atspi——X11 Accessibility Bridge

sudo apt-get install -y \
    libatspi2.0-dev

libproxy——Qt 网络代理支持

sudo apt-get install -y \
    libproxy-dev

SCTP——SCTP 协议支持

sudo apt-get install -y \
    libsctp-dev

SRTP

sudo apt-get install -y \
    libsrtp2-dev

PCI——PCI检测

sudo apt-get install -y \
    libpci-dev

LTTng——性能跟踪工具

sudo apt-get install -y \
    lttng-modules-dkms \
    liblttng-ust-dev \
    lttng-tools

directfb——嵌入式平台 GUI,桌面一般不启用

适用于嵌入式。

使用Qt自带副本时,请勿安装。

sudo apt-get install -y \
    libfusion-dev \
    libdirect-dev \
    libdirectfb-dev

GSSAPI——Kerberos / SASL 支持

# Kerberos 核心开发包,提供头文件和库,用于编译依赖 Kerberos 的程序
# GSSAPI Kerberos 的开发包,提供头文件和静态/动态库,用于编译使用 GSSAPI 的程序  
# 提供 Kerberos 配置工具和路径信息,用于编译和链接依赖 Kerberos 的程序
sudo apt-get install -y \
    libkrb5-dev \
    krb5-config
    
# Ubuntu 22.05 不存在此包: libgssapi-krb5-dev

运行时

# 运行时库,提供 GSSAPI(Generic Security Services API)接口的 Kerberos 实现,用于程序在运行时进行身份验证 
# Kerberos 用户工具包,提供命令行工具如 kinit、klist 等,用于获取和管理 Kerberos 票据(tickets)
sudo apt-get install -y \
    libgssapi-krb5-2 \
    krb5-user

打印机

sudo apt-get install -y \
    libcups2-dev \
    cups

hunspell——Qt Virutal Keyboard拼写检查

sudo apt-get install -y \
    hunspell \
    libhunspell-dev

SensorFW支持

sudo apt-get install -y \
    libsensors4-dev \
    libsensors-config

HiRes Wheel

sudo apt-get install -y \
    libinput10 \
    libhidapi-dev

assimp——Quick3D

使用Qt自带副本时,请勿安装。
sudo apt-get install -y libjasper
sudo apt-get install -y \
    libassimp-dev depend on jasper

FFMPEG——Qt Multimedia / WebEngine / Video

  1. Qt6.5.7中多媒体组件必须使用系统提供的版本,并且版本需要在4.x以上;仅QWebEngine可以选择使用自带副本或系统版本。不支持直接安装4.x以上版本时,请从源码编译安装FFMPEG。
  2. libavresample在Ubuntu 22.04之后已经被移除了,FFMPEG 从4.x开始直接使用libswresample代替libavresample。
sudo apt-get install -y \
    ffmpeg \
    libavcodec-dev \
    libavformat-dev \
    libavutil-dev \
    libswscale-dev \
    libswresample-dev

从源码编译安装:

# 安装FFMPEG编译依赖
sudo apt-get install -y \
    nasm \
    libass-dev \
    libfdk-aac-dev \
    libvorbis-dev \
    libx264-dev \
    libx265-dev

git clone https://git.ffmpeg.org/ffmpeg.git ffmpeg
cd ffmpeg
# 推荐6.x
git checkout n6.1.3

mkdir build && cd build

../configure \
  --prefix=/usr/local/ffmpeg6.1.3 \
  --pkg-config-flags="--static" \
  --extra-cflags="-I/usr/local/ffmpeg6.1.3/include" \
  --extra-ldflags="-L/usr/local/ffmpeg6.1.3/lib" \
  --extra-libs="-lpthread -lm" \
  --bindir=/usr/local/bin \
  --enable-gpl \
  --enable-nonfree \
  --enable-shared \
  --disable-static \
  --disable-debug \
  --disable-doc \
  --enable-swresample \
  --enable-libx264 \
  --enable-libvpx \
  --enable-libfdk-aac \
  --enable-libopus \
  --enable-libass \
  --enable-libfreetype \
  --enable-libvorbis
  
  make -j$(nproc)
  sudo make install
  
# 配置Qt编译时,显示地指定FFMPEG的路径
# export PKG_CONFIG_PATH=/usr/local/ffmpeg6.1.3/lib/pkgconfig:$PKG_CONFIG_PATH
# export LD_LIBRARY_PATH=/usr/local/ffmpeg6.1.3/lib:$LD_LIBRARY_PATH

Positioning

sudo apt-get install -y \
    libgps-dev \
    gpsd \
    gpsd-clients 

sudo apt-get install -y \
    geoip-bin \
    geoip-database \
    geoclue-2.0 \
    libgeoclue-2-dev
    
# Ubuntu 22.04 不存在此包: geoip-database-contrib

gRPC

Qt 6.5.7需要1.50.x\~1.56.x的gRPC。若系统版本可提供满足的版本则直接安装即可。

sudo apt-get install -y \
    libgrpc-dev \
    libgrpc++-dev

否则,从源码编译满足需求的protobuf与gRPC。

cd ~/cache
git clone https://github.com/grpc/grpc.git
cd grpc
git checkout v1.54.3
git submodule update --init --recursive

mkdir build && cd build

# 使用自带的PROTOBUF副本
# 使用系统安装的OpenSSL 3.x,编码Qt用3.x而gRPC使用自带的1.x;导致符号不一致
# 生成动态库,避免Qt链接了OpenSSL而gRPC也链接了OpenSSL导致的重复定义
cmake .. \
  -DCMAKE_INSTALL_PREFIX=/opt/qt-deps/grpc-1.54 \
  -DgRPC_INSTALL=ON \
  -DgRPC_BUILD_TESTS=OFF \
  -DgRPC_BUILD_CSHARP_EXT=OFF \
  -DgRPC_BUILD_GRPC_NODE_PLUGIN=OFF \
  -DgRPC_BUILD_GRPC_PHP_PLUGIN=OFF \
  -DgRPC_BUILD_GRPC_RUBY_PLUGIN=OFF \
  -DgRPC_PROTOBUF_PROVIDER=module \
  -DgRPC_SSL_PROVIDER=package \
  -DBUILD_SHARED_LIBS=ON

cmake --build . --parallel
sudo cmake --install .

QtTextToSpeech 依赖

sudo apt-get install -y \
  libspeechd-dev \
  speech-dispatcher \
  espeak-ng \
  espeak-ng-data

QWebEngine

Python3

sudo apt-get install -y \
    python3 \
    python3-dev \
    python3-setuptools \
    python-is-python3 \
    python3-pip \
    python3-pexpect

HTML5

sudo apt install -y \
  python3-html5lib \
  python3-lxml \
  python3-openssl \
  python3-bs4

NodeJS

若需更新版本可通过打开链接获取最新的指令:https://deb.nodesource.com/
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo bash -
sudo apt-get install -y nodejs

# 或
cd /opt
sudo wget https://nodejs.org/dist/v18.20.1/node-v18.20.1-linux-x64.tar.xz
sudo tar -xJf node-v18.20.1-linux-x64.tar.xz
sudo mv node-v18.20.1-linux-x64 node18
sudo ln -sf /opt/node18/bin/node /usr/bin/node
sudo ln -sf /opt/node18/bin/npm /usr/bin/npm
node -v  # 应该显示 v18.x

brotli

使用Qt自带副本时,请勿安装。
sudo apt-get install -y \
    brotli \
    libbrotli-dev

QWebEngine

# 构建工具和解析器
# 词法分析器生成器
# 语法解析器生成器
# 完美哈希函数生成工具
# Google 的构建配置工具(类似 CMake)
sudo apt-get install -y \
    flex \
    bison \
    gperf \
    gyp
# 安全与系统接口
# NSS (Network Security Services) 开发包,用于加密、证书和 TLS/SSL 支持
# Direct Rendering Manager 开发包,GPU 低级访问
# Generic Buffer Management 开发包,用于 GPU 内存缓冲管理
sudo apt-get install -y \
    libnss3-dev \
    libdrm-dev \
    libgbm-dev
# 图像与 GUI
# WebP 图片编解码库
# ATK 无障碍工具包开发库,支持辅助功能
# JSON 解析和操作库 
sudo apt-get install -y \
    libwebp-dev\
    libatk-bridge2.0-dev \
    libjsoncpp-dev
# 音视频处理
# Opus 音频编解码库
# zip 压缩/解压处理
# VP8/VP9 视频编解码
# 异步事件处理库,常用于网络和多媒体应用
sudo apt-get install -y \
    libopus-dev \
    libminizip-dev \
    libvpx-dev \
    libevent-dev
# 压缩与搜索
# Snappy 压缩库
# RE2 正则表达式库
sudo apt-get install -y \
    libsnappy-dev \
    libre2-dev
sudo apt-get install -y \
    libprotobuf-dev \
    protobuf-compiler

运行时

# WebP 图片编解码库
# ATK 无障碍工具包开发库,支持辅助功能
sudo apt-get install -y \
    libnss3 \
    libwebp \
    libatk1.0-dev

其他组件


# X11 会话管理和客户端通信
sudo apt-get install -y \
    libsm6 \
    libice6 \
    libice-dev
# 系统服务与权限
# D-Bus 消息总线开发和测试
sudo apt-get install -y \
    dbus \
    dbus-tests \
    libdbus-glib-1-dev
# 控制 Linux 进程能力的开发包
# 与 systemd 服务交互的开发包
# 色彩与图像
# 色彩管理库开发包(ICC 配置文件支持)
# MNG 图片格式支持
# TIFF 图像格式支持
# 开发与构建辅助工具
# 文本处理工具
# 补丁文件分析工具
# 文档生成工具
# ELF 文件 RPATH 修改工具
# 网络调试和转发工具
# 文件类型识别
# 系统本地化支持
# 系统工具包
# 压缩
# XZ、CPIO、LZ4 压缩/解压工具
# bzip2 和 B2 压缩库
# ATK 无障碍库的 C++ 接口
# 数据库
# PostgreSQL 客户端开发库
# Markdown 4 C 库的开发包
# 系统构建和文件归档工具
sudo apt-get install -y \
    libcap-dev \
    libsystemd-dev \
    \
    liblcms2-dev \
    libmng-dev \
    libmng2 \
    libtiff-dev \
    \
    gawk \
    diffstat \
    texinfo \
    chrpath \
    socat \
    file \
    locales \
    debianutils \
    iputils-ping \
    \
    libbz2-dev \
    libb2-dev \
    xz-utils \
    liblz4-tool \
    \
    libatkmm-1.6-dev \
    \
    libpq-dev \
    cpio

编译安装

cmake 编译主体

# 设置 QT 插件调试,以便配置、编译过程输出详细错误信息
export QT_DEBUG_PLUGINS=1
export CC=/usr/bin/gcc
export CXX=/usr/bin/g++
export PKG_CONFIG_PATH=/usr/local/ffmpeg6.1.3/lib/pkgconfig:/opt/qt-deps/grpc-1.54/lib/pkgconfig:/usr/lib/x86_64-linux-gnu/pkgconfig:/usr/lib/pkgconfig:$PKG_CONFIG_PATH
export LD_LIBRARY_PATH=/usr/local/ffmpeg6.1.3/lib:/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH

# Release, RelWithDebInfo, Debug
# Qt 6.5.7的组件启用可以进行一次最小配置,然后用“grep -i FEATURE_ CMakeCache.txt”从CMakeCache.txt获取所有组件正确的启用选项名称
# 带有FEATURE_system的部分即可以选择使用系统版本或Qt自带版本的依赖项或组件

cmake .. -G Ninja \
    -DCMAKE_BUILD_TYPE=Release \
    -DCMAKE_INSTALL_PREFIX=~/opt/qt/6.5.7 \
    -DCMAKE_PREFIX_PATH="/opt/qt-deps/grpc-1.54" \
    -DgRPC_DIR=/opt/qt-deps/grpc-1.54/lib/cmake/grpc \
    -DCMAKE_C_COMPILER_LAUNCHER=ccache \
    -DCMAKE_CXX_COMPILER_LAUNCHER=ccache \
    -DCMAKE_C_STANDARD=11 \
    -DCMAKE_C_STANDARD_REQUIRED=ON \
    -DCMAKE_CXX_STANDARD=17 \
    -DCMAKE_CXX_STANDARD_REQUIRED=ON \
    -DCMAKE_INTERPROCEDURAL_OPTIMIZATION=OFF \
    -DQT_FEATURE_ccache=ON \
    -DQT_UNITY_BUILD=OFF \
    \
    -DQT_FEATURE_ffmpeg=ON \
    -DQT_FEATURE_fontconfig=ON \
    -DQT_FEATURE_grpc=ON \
    -DQT_FEATURE_libproxy=ON \
    -DQT_FEATURE_openssl=ON \
    -DQT_FEATURE_openssl_linked=OFF \
    -DQT_FEATURE_sctp=ON \
    -DQT_FEATURE_xcb_glx=ON \
    -DQT_FEATURE_pdf=ON \
    -DQT_FEATURE_system_assimp=OFF \
    -DQT_FEATURE_system_doubleconversion=OFF \
    -DQT_FEATURE_system_freetype=OFF \
    -DQT_FEATURE_system_harfbuzz=OFF \
    -DQT_FEATURE_system_jpeg=ON \
    -DQT_FEATURE_system_libb2=OFF\
    -DQT_FEATURE_system_pcre2=OFF \
    -DQT_FEATURE_system_png=OFF \
    -DQT_FEATURE_system_sqlite=OFF \
    -DQT_FEATURE_system_textmarkdownreader=OFF \
    -DQT_FEATURE_system_tiff=OFF \
    -DQT_FEATURE_system_webp=OFF \
    -DQT_FEATURE_system_xcb_xinput=OFF \
    -DQT_FEATURE_system_zlib=OFF \
    \
    -DQT_FEATURE_webengine_build_ninja=ON \
    -DQT_FEATURE_webengine_printing_and_pdf=ON \
    -DQT_FEATURE_webengine_system_ffmpeg=OFF \
    -DQT_FEATURE_webengine_system_freetype=OFF \
    -DQT_FEATURE_webengine_system_harfbuzz=OFF \
    -DQT_FEATURE_webengine_system_icu=OFF \
    -DQT_FEATURE_webengine_system_libjpeg=ON \
    -DQT_FEATURE_webengine_system_libpng=OFF \
    -DQT_FEATURE_webengine_system_libwebp=OFF \
    -DQT_FEATURE_webengine_system_libxml=OFF \
    -DQT_FEATURE_webengine_system_libopenjpeg2=OFF \
    -DQT_FEATURE_webengine_system_libpci=OFF \
    -DQT_FEATURE_webengine_system_libtiff=OFF \
    -DQT_FEATURE_webengine_system_libvpx=OFF \
    -DQT_FEATURE_webengine_system_minizip=OFF \
    -DQT_FEATURE_webengine_system_opus=OFF \
    -DQT_FEATURE_webengine_system_poppler=OFF \
    -DQT_FEATURE_webengine_system_pulseaudio=OFF \
    -DQT_FEATURE_webengine_system_re2=OFF \
    -DQT_FEATURE_webengine_system_snappy=OFF \
    -DQT_FEATURE_webengine_system_zlib=OFF \
    -DQT_FEATURE_webengine_qt_freetype=ON \
    -DQT_FEATURE_webengine_qt_harfbuzz=ON \
    -DQT_FEATURE_webengine_qt_libjpeg=OFF \
    -DQT_FEATURE_webengine_qt_libpng=ON \
    -DQT_FEATURE_webengine_qt_zlib=ON \
    -DQT_FEATURE_webengine_developer_build=ON \
    -DQT_FEATURE_webengine_proprietary_codecs=ON \
    \
    -DQT_BUILD_EXAMPLES=OFF \
    -DBUILD_TESTING=OFF \
    \
    -Wno-dev

cmake --build . --parallel $(nproc)
cmake --install .

编译帮助文档

# 仅编译 docs
ninja docs
# 编译完成后安装 docs
ninja install_docs

基础软件

sudo apt-get update -y

sudo apt-get install -y \
    vim \
    net-tools \
    open-vm-tool* \
    openssh-server \
    gcc \
    g++ \
    cmake \
    git \
    gnome-tweaks \
    bleachbit \
    gnome-shell-extensions

# open-vm开机挂载共享目录
vim /etc/rc.local

# /etc/rc.local键入以下内容
#!/bin/sh -e
sudo vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other

# 赋予/etc/rc.local执行权限
chmod +x /etc/rc.local

# 插件下载
# https://extensions.gnome.org
# 主题、icon等下载
# https://gnome-look.org

源码下载

Qt 官方源码下载(原生BUG)

KDE源码下载(维护改进)

由于Qt 5.15.3 LTS Qt官方已不再维护,且其源码存在BUG、依赖的部分第三方不再维护甚至撤销,如定位。KDE仓库中对该版本存在的问题进行了修复。因此建议使用KDE维护的Qt 5.15.3版本源码
# 克隆
git clone https://invent.kde.org/qt/qt/qt5.git -b kde/5.15
cd qt5 

# 初始化
./init-repository

# 初始化并同步所有子模块
git submodule update --init --recursive

# 检查子模块状态
# 若输出子模块项前携带'-'',表示改子模块未正常初始化或同步, 则可以执行反复执行:
# ./init-repository -f 或 git submodule update --init --recursive
# 直至子模块状态查询时输出不带'-'
git submodule status

# 切换主模块至TAG v5.15.3-lts-lgpl , 注: 不同仓库的TAG名格式不一定相同,主要关注实际仓库中的版本和LGPL协议来判断应当使用的TAG名
git submodule foreach 'git fetch --tags'
git submodule foreach 'git checkout v5.15.3-lts-lgpl || echo "No tag v5.15.3-lts-lgpl for $name"'

编译构建环境

编译内存问题

# 创建一个足够大的SWAP, 如16GB
sudo swapoff -a
sudo fallocate -l 16G /swapfile

# 设置权限, 否则系统拒绝使用
sudo chmod 600 /swapfile

# 格式化为SWAP
sudo mkswap /swapfile

# 启用
sudo swapon /swapfile

# 检查是否生效
free -h

# 若希望重启操作系统后新增SWAP仍然生效,则编辑/etc/fstab, 加上这一行
/swapfile none swap sw 0 0

# 临时减少 Swap 使用频率(强烈建议):
sudo sysctl vm.swappiness=10

# 若希望减少SWAP使用频率配置永久生效, 则
echo "vm.swappiness=10" | sudo tee -a /etc/sysctl.conf

基础构建工具

sudo apt-get install -y build-essential perl python3 git ninja-build flex bison gperf pkg-config

X11、XCB全家桶

sudo apt-get install -y \
    libxcb1 libxcb1-dev \
    libxcb-util1 libxcb-util-dev \
    libxcb-keysyms1 libxcb-keysyms1-dev \
    libxcb-image0 libxcb-image0-dev \
    libxcb-icccm4 libxcb-icccm4-dev \
    libxcb-render-util0 libxcb-render-util0-dev \
    libxcb-xinerama0 libxcb-xinerama0-dev \
    libxcb-cursor0 libxcb-cursor-dev \
    libxcb-xkb1 libxcb-xkb-dev \
    libxcb-xinput-dev \
    libxxf86vm-dev \
    libzstd-dev \
    libxkbcommon-dev libxkbcommon-x11-dev \
    libx11-dev \
    libxrender-dev libxrandr-dev libxtst-dev libxss-dev \
    libxi-dev \
    libx11-xcb-dev \
    libxext-dev libxfixes-dev libxi-dev \
    libxcb-xfixes0-dev \
    libxcb-util0-dev \
    libxcb-shape0-dev \
    libxcb-shm0-dev \
    libxcb-sync-dev \
    libxcb-randr0-dev \
    libudev-dev libevdev-dev \
    libxkbfile-dev \ 
    libxkbcommon-devsudo \
    libxcursor-dev \
    libinput-dev \
    libmtdev-dev \
    wayland-protocols \
    libwayland-dev \
    libwayland-egl-backend-dev
或直接使用通配符
sudo apt-get install -y \
    libxcb* \
    libx11*

图形、字体格式依赖

sudo apt-get install -y  \
    libfontconfig1-dev \
    libfreetype-dev \
    libpng-dev \
    libjpeg-dev \
    libglib2.0-dev \
    libdbus-1-dev \
    libicu-dev \
    libssl-dev \
    mesa-common-dev \
    libglu1-mesa-dev \
    libgtk2.0-dev \
    libgtk-3-dev \
    zlib1g-dev \
    libharfbuzz-dev \
    freeglut3-dev

蓝牙

sudo apt-get install -y \
    libdbus-1-dev \
    libbluetooth-dev

串口

sudo apt-get install -y libserialport-dev

WebSocket

sudo apt-get install -y libwebsockets-dev

Positioning

sudo apt-get install -y \
    libgps-dev \
    gpsd \
    gpsd-clients 
# sudo apt-get install -y qtbase5-private-dev
# sudo apt-get install -y libqt5positioning5-dev
sudo apt-get install -y \
    geoip-bin \
    geoip-database \
    geoip-database-contrib \
    geoclue-2.0 \
    libgeoclue-2-dev

安装QLocation依赖

clip2tri

使用Qt自带源码副本
# 相对路径: qtlocation/src/3rdparty
cd qt-everywhere-src-5.15.3/qtlocation/src/3rdparty/clip2tri
qmake && make -j$(nproc) && sudo make install
apt安装
源码编译

poly2tri

使用Qt自带源码副本

apt安装

sudo add-apt-repository universe
sudo apt-get update -y
sudo apt-get install -y libpoly2tri-dev
源码编译
git clone https://github.com/r3mi/poly2tri.js.git

clipper

apt安装
sudo add-apt-repository universe
sudo apt-get update -y
sudo apt-get install -y libclipper-dev
源码编译
wget http://sourceforge.net/projects/polyclipping/files/clipper_6.4.2.zip
unzip clipper_6.4.2.zip
cd clipper_6.4.2/cpp
g++ -shared -fPIC -o libclipper.so clipper.cpp
sudo cp libclipper.so /usr/local/lib/
sudo cp clipper.hpp /usr/local/include/

安装QDoc依赖

sudo apt-get install -y libclang-dev llvm

# 查看 LLVM 的可执行程序路径
which llvm-config
llvm-config --version

# 将 LLVM 的可执行路径导出到环境变量 PATH
# 根据实际路径调整
export PATH=/usr/lib/llvm-20/bin:$PATH

安装QWebEngine、QPdf、QDoc 依赖Python2

若环境支持Python2安装,则无需下载源码进行编译安装。
# 找个目录下载 Python2 的源码, 使用源码编译安装
cd ~/cache

wget https://www.python.org/ftp/python/2.7.18/Python-2.7.18.tgz
tar xf Python-2.7.18.tgz
cd Python-2.7.18
./configure --prefix=$HOME/opt/python2
make -j$(nproc)
make install

# 将 Python2 的安装路径导出到 PATH, 并设置 PYTHON 为 python2
export PATH=$HOME/opt/python2/bin:$PATH
export PYTHON=python2

安装QPdf依赖

sudo apt-get install -y \
    libmysqlclient-dev \
    libsrtp2-dev

安装OpenGL、Mesa

sudo apt-get install -y \
    mesa-common-dev \
    libglu1-mesa-dev \
    libgl1-mesa-dev \
    libegl1-mesa-dev

安装QWebEngine(Chromium)依赖

sudo apt-get install -y \
    libnss3-dev libatk1.0-dev libatk-bridge2.0-dev libcups2-dev \
    libdrm-dev libgbm-dev libxcomposite-dev libxdamage-dev \
    libxshmfence-dev libasound2-dev libpulse-dev \
    nodejs \
    npm \
    libpci-dev \
    gyp \
    libwebp \
    libjsoncpp-dev \
    libopus-dev \
    libminizip-dev \
    libavutil-dev \
    libavformat-dev \
    libavcodec-dev \
    libevent-dev \
    libvpx-dev \
    libsnappy-dev \
    libre2-dev \
    libprotobuf-dev \
    protobuf-compiler \
    protobuf-compile \
    python3 python3-dev python3-setuptools python3-pip

安装Quick3D依赖Assimp

若环境支持安装, 则不需要从源码编译
# 下载源码
git clone https://github.com/assimp/assimp.git
cd assimp

git checkout v4.1.0
mkdir build && cd build

# 不指定安装路径, 默认安装/usr/local下
cmake .
make -j$(nproc)

sudo make install

安装其他组件

sudo apt-get install -y \
    gstreamer1.0-tools \
    gstreamer1.0-plugins-base \
    gstreamer1.0-plugins-good \
    gstreamer1.0-plugins-bad \
    gstreamer1.0-plugins-ugly \
    gstreamer1.0-libav \
    libgstreamer1.0-dev \
    libgstreamer-plugins-base1.0-dev \
    libdbus-1-dev dbus dbus-tests libdbus-glib-1-dev

OpenSSL源码编译(选)

OpenSSL可以选择安装libssl-dev或从源码编译安装
cd ~/cache/qt5
wget https://www.openssl.org/source/openssl-1.1.1w.tar.gz
tar xf openssl-1.1.1w.tar.gz
cd openssl-1.1.1w

./config --prefix=$HOME/qt-deps/openssl no-shared
make -j$(nproc)
make install_sw

ICU源码编译(选)

ICU可选择安装libicu-dev或从源码编译
cd ~/cache/qt5
wget https://github.com/unicode-org/icu/releases/download/release-73-2/icu4c-73_2-src.tgz
tar xf icu4c-73_2-src.tgz
cd icu/source

./configure --prefix=$HOME/qt-deps/icu
make -j$(nproc)
make install

libproxy源码编译(选)

libproxy可选择安装sudo apt-get install -y libproxy-de,或从源码编译
cd ~/cache/qt5
git clone https://github.com/libproxy/libproxy.git
cd libproxy

mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/qt-deps/libproxy
make -j$(nproc)
make install

GStreamer 源码编译(选)

GStreamer可选择安装或从源码编译
cd ~/cache/qt5

git clone https://gitlab.freedesktop.org/gstreamer/gstreamer.git
cd gstreamer
git checkout 1.20.6   # Ubuntu 22.04 对应版本

meson setup builddir --prefix=$HOME/qt-deps/gstreamer -Dbuildtype=release
ninja -C builddir
ninja -C builddir install

编译安装

当前版本支持指定debug-and-release,故分次进行release与debug版本的编译,两次编译指定相同的安装路径,则debug和relase共存为一份。
mkdir build && cd build

release

# 删除build下前次数据
# -force-debug-info 指定release携带debug信息
rm -rf ./*

# 配置编译
../configure \
    -opensource -confirm-license \
    -prefix ~/opt/qt/qt/qt-5.15.3 \
    -release \
    -force-debug-info \
    -separate-debug-info \
    -nomake tests \
    -nomake examples \
    \ #使用Qt自带副本, 而不使用系统版本
    -qt-zlib \
    -qt-libpng \
    -qt-libjpeg \
    -qt-freetype \
    -qt-harfbuzz \
    -qt-pcre \
    -qt-doubleconversion \
    -qt-xkbcommon \
    -qt-xcb \
    -qt-sqlite \
    -qt-md4c \
    -qt-hunspell \
    # 指定系统assimp的头文件与库路径
    -qt-assimp #-I/opt/assimp-4.1/include -L/opt/assimp-4.1/lib\
    \
    -dbus-linked \
    -glib \
    -pulseaudio \
    -alsa \
    -icu \
    -openssl-linked \
    -gstreamer 1.0 \
    -cups \
    \
    -opengl desktop \
    -qpa xcb \
    -xkbcommon \
    -feature-egl \
    -feature-system-proxies \
    -libproxy \
    -gtkstyle \
    -feature-wayland_client \
    -webengine-proprietary-codecs -webengine-ffmpeg \
    -feature-webengine-spellchecker \
       \
    -sse2 -sse3 -ssse3 \
    -avx -avx2 \
    -f16c \
    -v
    
# 请注意configure完成后的提示,使用gmake进行编译与安装,不要使用make
gmake -j$(nproc)

gmake install

debug

# 删除build下前次数据
rm -rf ./*

# 配置编译
../configure \
    -opensource -confirm-license \
    -prefix ~/opt/qt/qt/qt-5.15.3 \
    -release \
    -force-debug-info \
    -separate-debug-info \
    -nomake tests \
    -nomake examples \
    \ #使用Qt自带副本, 而不使用系统版本
    -qt-zlib \
    -qt-libpng \
    -qt-libjpeg \
    -qt-freetype \
    -qt-harfbuzz \
    -qt-pcre \
    -qt-doubleconversion \
    -qt-xkbcommon \
    -qt-xcb \
    -qt-sqlite \
    -qt-md4c \
    -qt-hunspell \
    # 指定系统assimp的头文件与库路径
    -qt-assimp #-I/opt/assimp-4.1/include -L/opt/assimp-4.1/lib\
    \
    -dbus-linked \
    -glib \
    -pulseaudio \
    -alsa \
    -icu \
    -openssl-linked \
    -gstreamer 1.0 \
    -cups \
    \
    -opengl desktop \
    -qpa xcb \
    -xkbcommon \
    -feature-egl \
    -feature-system-proxies \
    -libproxy \
    -gtkstyle \
    -feature-wayland_client \
    -webengine-proprietary-codecs -webengine-ffmpeg \
    -feature-webengine-spellchecker \
       \
    -sse2 -sse3 -ssse3 \
    -avx -avx2 \
    -f16c \
    -v
    
# 请注意configure完成后的提示,使用gmake进行编译与安装,不要使用make
gmake -j$(nproc)

gmake install

安装依赖环境

sudo dnf groupinstall "Development Tools" -y
sudo dnf install gmp gmp-devel mpfr mpfr-devel libmpc libmpc-devel isl isl-devel zlib-devel wget make bzip2 -y

若系统未提供默认的gcc与cmake则还需要安装gcc、g++与cmake

sudo dnf install -y gcc g++ cmake

解压GCC源码包并进入目录

下载依赖库源码

./contrib/download_prerequisites

创建构建目录并在其下进行编译

cd ..
mkdir gcc-build
cd gcc-build

配置编译

../gcc-14.2.0/configure \
  --prefix=/usr/local/gcc-14.2 \
  --disable-multilib \
  --enable-languages=c,c++ \
  --enable-checking=release

gcc-14.2.0 根据实际gcc版本及解压目录替换

编译

make -j$(nproc)
make install

配置环境

在.bashrc或.bash_profile(openEular)中添加

LD_LIBRARY_PATH=/usr/local/gcc14/lib64/:$LD_LIBRARY_PATH
export PATH
export LD_LIBRARY_PATH

通过alternatives管理版本切换时,无需将bin路径导出到PATH

版本选择配置

sudo update-alternatives --install /usr/bin/gcc gcc /usr/local/gcc-14.2/bin/gcc 50
sudo update-alternatives --install /usr/bin/g++ g++ /usr/local/gcc-14.2/bin/g++ 50
sudo update-alternatives --config gcc
  • --install 安装配置信息
  • /usr/bin/gcc 版本切换的注册可执行文件的地址,即生成的软连接位置
  • gcc 注册的组名, 管理使用
  • /usr/local/gcc-14.2/bin/gcc 实际的可执行文件路径
  • 50 优先级,数值越大优先级越高
  • --slave /usr/bin/g++ g++ /usr/local/gcc-14.2/bin/g++ : 绑定切换,切换gcc时自动切换g++

版本切换

sudo update-alternatives --config gcc

# gcc为组名
# 根据提示输入序号来选择版本

  1. 安装yum-utils、createrepo、httpd
yum install -y httpd yum-utils createrepo
  1. 开放httpd防火墙
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --zone=public --add-port=443/tcp --permanent
sudo firewall-cmd --reload
  1. 解决http无法访问子目录问题
#编辑/etc/sysconfig/selinux
vim /etc/sysconfig/selinux
#将SELINUX=enforcing修改为SELINUX=disabled
#执行命令使其生效
setenforce 0
  1. 启动http服务
systemctl restart httpd
  1. 查看当前yum源
yum repolist
#将列出 repo id          repo name信息
base/7/x86_64           xxxx
extras/7/x86_64         xxxx
updates/7/x86_64        xxxx
  1. 将repolist中所有repo id对应的包都下载到本地
reposync --repo repo-id -p /local-repo-folder-path/
#repo-id 为当前要下载的仓库id
#local-repo-folder-path为当前用于存储下载仓库资源的目录路径
  1. 将所有仓库资源下载完毕后,生成repodata索引依赖
cd /local-repo-folder-path/
createrepo repo-id/
#repor-id为仓库id
  1. 备份原有yum源配置并创建本地源的配置
cd /etc/yum.repos.d
mkdir bak
mv CentOS* bak
#创建本地源配置
vim local.repo
#文件内容
# [repo id]
# name=repo name
# baseurl=http://ip-address/centos/repo-name
# gpgcheck=0
# enabled=1

# 重复上述配置节点,为所有仓库添加配置节点
  1. 验证
# 清理yum
yum clean all
# 建立yum缓存
yum makecache
# 查看仓库
yum repolist
# 更新yum
yum update
# 安装软件以验证
  1. 其他仓库离线源方式与前述步骤一直,如docker-ce等等
  2. docker无法运行
# 创建配置
sudo vim /etc/profile.d/docker.sh
# 内容如下
# export DOCKER_HOST=tcp://localhost:2375
source /etc/profile
source /etc/basrc

#配置启动文件
vim /lib/systemd/system/docker.service
#将ExecStart配置追加以下内容
ExecStart=/usr/bin/dockerd -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock -H tcp://0.0.0.0:7654 原配置内容

gitlab-runner安装

gitlab-runner容器

  1. 使用gitlab.com安装部署指导手册下载相应gitlab-runner镜像并使用docker运行即可。
  2. gitlab-runner以容器的方式提供服务时,可在启动容器时通过-v将本地gitlab-runner/config.toml文件挂载到容器中,以提供认证等配置信息。对本地文件config.toml的修改将不能即时生效,需要重启容器。

启动容器

  1. 以本地文件挂载方式启动容器
docker run -d --name gitlab-runner --restart always \
     -v /srv/gitlab-runner/config:/etc/gitlab-runner \
     -v /var/run/docker.sock:/var/run/docker.sock \
     harbor.rjb.dgbc.net.cn/cs/gitlab-runner:latest
  1. 以docker volumes方式启动容器
# 创建docker volume
docker volume create gitlab-runner-config

# 使用volume启动runner
docker run -d --name gitlab-runner --restart always \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v gitlab-runner-config:/etc/gitlab-runner \
    harbor.rjb.dgbc.net.cn/cs/gitlab-runner:latest

注册到gitlab

# 本地文件挂载的注册指令
docker run --rm -it -v /srv/gitlab-runner/config:/etc/gitlab-runner harbor.rjb.dgbc.net.cn/cs/gitlab-runner register

# docker volume挂载的注册指令
docker run --rm -it -v gitlab-runner-config:/etc/gitlab-runner gitlab/gitlab-runner:latest register

gitlab-runner 访问镜像仓库

gitlab-runner的docker runner在运行时需要访问镜像仓库并通过认证才能拉取镜像,故需要为runner指定镜像仓库的认证信息,认证信息将保存在gitlab-runner的DOCKER_AUTH_CONFIG环境变量中。

获取docker登录镜像仓库的认证

通过获取登录该仓库的认证配置信息,位于文件~/.docker/config.json

登录指令:

docker login repository-url --username user --password passwd

认证信息示例:

{
        "auths": {
                "gitlab.com": {
                        "auth": "XXXXXXX"
                },
                "registry.gitlab.com": {
                        "auth": "XXXXXXX"
                }
        }
}

项目级镜像仓库认证配置

在项目的gitlab.yml文件的variables中指定DOCKER_AUTH_CONFIG的值:

stages:
 - test
variables:
    DOCKER_AUTH_CONFIG: '{"auths":{"repository-url":"repository-key"}}'

系统级镜像仓库认证配置

在gitlab-runner的配置文件/etc/gitlab-ruuner/config.toml中增加DOCKER_AUTG_CONFIG环境变量的值,并重启runner使之生效

[[runners]]
 environment = ['DOCKER_AUTH_CONFIG={ "auths": { "registry.gitlab.com": {"auth": "xxxxx"}}}']

0. 环境要求

1 建议先按需关闭麒麟操作系统的相关保护功能《麒麟V10关闭安全控制》

2 编译环境要求:

  • 可用于编译的物理内存 + SWAP交换区 > 40GB,同条件下,物理内存越大,编译速度越快
  • 可用于编译的磁盘空间 >160GB
  • 建议CPU核心数据 >8核

1. 添加其他软件源

麒麟V10-SP1-HWE-2303-x86_64(兆芯)版本操作系统(简述为麒麟操作系统)为基于Ubuntu 18.04(bionic)发行版改进,该版本麒麟操作系统可以使用Ubuntu 18.04(bionic)及同内核版本的其他linux软件源。Qt 6.5.3 LTS开放源代码编译所需的部分组件在麒麟官方的软件源中不存在或版本过低,如gcc、g++、cmake等,故首先为麒麟操作系统添加其他可用的软件源。

1.1 安装apt tools

首先安装software-properties-common以便添加源时加入对应源的公钥。

sudo apt-get install -y software-properties-common

1.2 添加其他源到apt

此处添加阿里云和PPA到源列表。

请注意,麒麟操作系统默认源会被操作系统定时检测及还原,故请勿在默认源文件(/etc/apt/source.list)中增加其他源配置。而应在/etc/apt/source.list.d路径下为每个源单独配置一份配置文件。

# 添加阿里云 Ubuntu 18.04(bionic)源
FILE_SOURCE_LIST=/etc/apt/sources.list.d/aliyun.list
echo deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse > ${FILE_SOURCE_LIST}
echo deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse >> ${FILE_SOURCE_LIST}
echo deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse >> ${FILE_SOURCE_LIST}
echo deb http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse >> ${FILE_SOURCE_LIST}
echo deb http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse >> ${FILE_SOURCE_LIST}
# 添加PPA
FILE_SOURCE_LIST=/etc/apt/sources.list.d/ubuntu-toolchain-r-test.list
echo deb http://ppa.launchpad.net/ubuntu-toolchain-r/test/ubuntu bionic main >> ${FILE_SOURCE_LIST}
# 添加PPA公钥
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1E9377A2BA9EF27F

完成源配置的添加后,更新apt

sudo apt-get update
sudo apt-get upgrade

2. 安装编译环境

请注意,若执行某条安装命令失败,请在安装失败后先对apt进行缓存更新,然后尝试重新执行安装命令。若此时依然不行,则核对安装的包名是否正确或安装以对应组件库名打头的所有包。

2.1 前期使用的环境

使用高版本的gcc、g++、cmake、openssl需要先安装系统版本默认支持的版本作为基础版本,然后再进行高版本的安装或利用基础版本对高版本的源码进行编译安装以达到使用高版本的目的。

2.2 安装基础编译环境

2.2.1 安装gcc(9.x)、g++(9.x)、cmake

sudo apt-get install -y gcc g++ cmake

2.2.2 安装openssl 2.x

sudo apt-get install -y \
    libssl-dev \
    libgcrypt20-dev \
    libcrypto++6 \
    libcrypto++-dev \
    openssl

2.2.3 安装clang-12、llvm-12

sudo apt-get install -y llvm-10 clang-10 llvm-10-dev libclang-10-dev
#变更为clang-12、llvm-12
sudo apt-get install -y llvm-12 clang-12 llvm-12-dev libclang-12-dev
#若第一次执行安装clang-12版本失败,则先对apt进行更新

2.3 安装高版本编译环境

2.3.1 安装gcc-13和g++-13

请注意安装前提:需先安装clang-12和llvm-12。

# 安装gcc-13
sudo apt-get install -y gcc-13
# 修改默认的gcc版本
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-13 60
# 检查安装及修改默认版本后的gcc版本号
gcc --version
# 安装g++-13
sudo apt-get install -y g++-13
# 修改默认g++版本
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-13 60
# 检查版本
g++ --version

请注意,若在多次通过update-alternatives修改默认gcc和g++无法生效,请使用update-alternatives --config来手动确认选择的版本。

# 输入下述命令后,按提示信息选择列出的gcc编译器序号
sudo update-alternatives --config gcc
# 输入下述命令后,按提示信息选择列出的g++编译器序号
sudo update-alternatives --config g++

2.3.2 安装OpenSSL 3.x

  1. ftp://192.168.0.61:50000/devenv/qtools/src,用户名: shared, 密码: 7474741获取openssl-3.3.0.tar.gz源码包openssl-3.3.0.tar.gz

请注意需要编译安装debug和release两个版本,并且请勿将两个版本安装在同一路径下

#在openssl 3.x源码目录下执行命令 编译release版本并安装到默认目录
mkdir build-release && cd build-release
../config
#使用默认安装路径即可
make && make install

#在openssl 3.x源码目录下执行命令 编译debug版本并安装到 /usr/local/lib64d/openssl目录
mkdir build-debug && cd build-debug
../Configure --prefix=/usr/local/lib64d/openssl --debug
make && make install

# 请注意,此处仅是编译并安装到了系统中,不论是通过apt包安装的openssl还是自行编译安装的openssl,都没有自动建立ldconfig缓存,需要手动添加才能正常使用

2.3.3 安装CMake 3.29.x

  1. ftp://192.168.0.61:50000/devenv/qtools/src,用户名: shared, 密码: 7474741获取CMake 3.29.3源码包cmake-3.29.3.tar.gz
  2. 解压缩cmake-3.29.3.tar.gz,并进入解压缩后的源码目录
  3. 执行如下命令进行编译、安装及版本检查

    # 在解压缩后的cmake 3.29.x源码目录下执行
    ./bootstrap
    # 编译
    make
    # 安装
    make install
    # 版本检测(检测安装结果)
    cmake --version

2.3.4 安装Node.js 20.x

执行以下命令以安装Node.js 20.x。

# 若需更新版本可通过打开链接获取最新的指令:https://deb.nodesource.com/
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - 
sudo apt-get install -y nodejs

2.3.5 安装调试器GDB

当前使用源中最高版本10.x,若需要使用13.x或14.x请使用源码编译安装。

apt-get install -y gdb

3. 安装其他组件

安装编译Qt源码所需的其他环境(为方便执行指令,将存在安装失败可能的包安装指令拆分为单独一条)。

# 安装perl git ninja
sudo apt-get install -y perl git ninja-build
# 安装python3、python html5lib
sudo apt-get install -y python3 python-is-python3 python3-pip python3-pexpect
# Qt启用WebEngine则必须html5lib
pip install html5lib
# 安装enssential nss3
sudo apt-get install -y build-essential libnss3 libnss3-dev
# 更新pthread和动态加载相关的库,也可以通过升级libc的方式来升级
sudo apt-get install -y libpthread*
sudo apt-get install -y ldd
# Qt开启WebEngine组件必须
sudo apt-get install -y gperf bison flex ruby
# Qt开启WebEngine组件必须安装xcb和x11系列组件
#【请注意】必须先安装xcb-protocol组件,否则将导致部分xcb组件库安装失败
sudo apt-get install -y xcb-proto
# 先全系安装libxcb和libx11打头的库
sudo apt-get install -y libxcb*
sudo apt-get install -y libx11*
# proxy, 若安装失败,则先进行apt-get update,然后再尝试
sudo apt-get install -y libproxy1v5 libproxy-dev
# update后仍然不行,则安装libproxy打头的所有库
#sudo apt-get install -y libproxy*
# GSSAPI,若安装失败,则先进行apt-get update,然后再尝试
sudo apt-get install -y libgssapi-krb5-2 libgssapi-krb5-dev
# update后仍然不行,则安装libgssapi打头的所有库
#sudo apt-get install -y libgssapi*
# 安装directFB
sudo apt-get install -y directfb*
# 安装vulkan
sudo apt-get install -y libvulkan*
# 安装harfBuzz,若安装失败,则进行apt-get update,然后再尝试
sudo apt-get install -y libharfbuzz-dev
# update后仍然不行,则安装libharfbuzz打头的所有库
#sudo apt-get install -y libharfbuzz*
# 安装strp
sudo apt-get install -y libsrtp*
# 安装libatspi2
sudo apt-get install -y libatspi2.0-dev
# 安装蓝牙库
sudo apt-get install -y libbluetooth-dev
# 安装ICU
sudo apt-get install -y libicu-dev
#【非必须】Jasper需要手动通过包进行安装,仅ARM需要
#sudo apt-get install -y libjasper-dev
#-jasper arm only
#sudo apt install libassimp-dev depend on jasper
#sudo apt install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
#-gstreamer -gstreamer-no-multimonitor -I/usr/include/gstreamer-1.0 -L/usr/lib/x86_64-linux-gnu -lgstreamer-1.0
#PKG_CONFIG="/usr/bin/pkg-config" PKG_CONFIG_PATH="/path/to/your/gstreamer/pkgconfig/files"
# 安装llTTNG,【请务必保证指令中的包顺序,否则将无法安装】
# 包安装顺序可参考 https://lttng.org 在debian类系统上安装的指导手册
sudo apt-get install -y lttng-modules-dkms liblttng-ust-dev lttng-tools
# 批量安装以下组件
sudo apt-get install -y libcups2-dev \
    libcap-dev \
    libdrm-dev \
    libfontconfig1-dev \
    libfreetype6-dev \
    freeglut3-dev \
    dbus \
    libdbus-1-dev \
    libdbus-glib-1-dev \
    libudev-dev \
    libudev1 \
    libpci-dev \
    libasound2-dev \
    libgstreamer1.0-dev \
    libgstreamer-plugins-base1.0-dev \
    libbz2-dev \
    libb2-dev \
    libatkmm-1.6-dev \
    libinput-dev \
    zstd \
    libzstd-dev \
    libsystemd-dev \
    libgbm-dev \
    libjpeg-dev \
    libmd4c-dev \
    libmtdev-dev \
    libwayland-dev \
    libsm6 \
    libsm-dev \
    libice6 \
    libice-dev \
    libdouble-conversion-dev \
    libpq-dev \
    libsqlite3-dev \
    libgtk-3-dev \
    libwebp-dev \
    libmng-dev \
    libmng2 \
    gyp \
    libjsoncpp-dev \
    libopus-dev \
    libminizip-dev \
    libavutil-dev \
    libavformat-dev \
    libavcodec-dev \
    libevent-dev \
    libvpx-dev \
    libsnappy-dev \
    libre2-dev \
    libprotobuf-dev \
    protobuf-compiler \
    libgssglue-dev \
    libtiff-dev \
    gawk \
    wget \
    diffstat \
    texinfo \
    chrpath \
    socat \
    cpio \
    xz-utils \
    debianutils \
    iputils-ping \
    liblz4-tool \
    file \
    locales
# 安装OpenGL 2.x
sudo apt-get install -y \
    mesa-common-dev \
    libegl1-mesa-dev \
    libopengl-dev \
    libgl1-mesa-dev \
    libglu1-mesa-dev \
    libglfw3-dev \
    libgles2-mesa-dev \
    libglib2.0-0 \
    libglib2.0-dev \
    libegl1-mesa \
    libsdl1.2-dev
# 按组件名安装所必须的xcb组件,避免部分组件在批量安装时未安装
sudo apt-get install -y \
    libxcb1-dev \
    libxcb-glx0-dev \
    libxcb-icccm4-dev \
    libxcb-image0-dev \
    libxcb-keysyms1-dev \
    libxcb-randr0-dev \
    libxcb-render0-dev \
    libxcb-render-util0-dev \
    libxcb-shape0-dev \
    libxcb-shm0-dev \
    libxcb-sync-dev \
    libxcb-util-dev \
    libxcb-util0-dev \
    libxcb-xfixes0-dev \
    libxcb-xinerama0-dev \
    libxcb-xkb-dev \
    libxcb-imdkit0 \
    libxcb-imdkit-dev \
    libxcb-composite0-dev \
    libxcb-composite0 \
    libxcb-cursor0 \
    libxcb-cursor-dev \
    libxcb-damage0 \
    libxcb-damage0-dev \
    libxcb-doc \
    libxcb-dpms0 \
    libxcb-dpms0-dev \
    libxcb-dri2-0-dev \
    libxcb-dri3-dev \
    libxcb-ewmh2 \
    libxcb-ewmh-dev \
    libxcb-glx0-dev \
    libxcb-present-dev \
    libxcb-record0 \
    libxcb-record0-dev \
    libxcb-res0-dev \
    libxcb-screensaver0 \
    libxcb-screensaver0-dev \
    libxcb-xf86dri0 \
    libxcb-xf86dri0-dev \
    libxcb-xinput-dev \
    libxcb-xrm0 \
    libxcb-xrm-dev \
    libxcb-xtest0 \
    libxcb-xtest0-dev \
    libxcb-xv0-dev \
    libxcb-xvmc0 \
    libxcb-xvmc0-dev
# 按组件名安装所必须的x11组件,避免部分组件在批量安装时未安装
sudo apt-get install -y \
    libgstreamer1.0-dev \
    libhunspell-dev \
    libpulse-dev \
    libts-dev \
    libxtst-dev \
    libxslt-dev \
    libxslt1-dev \
    libxss-dev \
    libx11-dev \
    libx11-xcb-dev 
    libxcomposite-dev \
    libxcursor-dev \
    libxdamage-dev \
    libxdamage1 \
    libxext-dev \
    libxfixes-dev \
    libxi-dev \
    libxkbcommon-doc \
    libxkbcommon-dev \
    libxkbcommon-x11-dev \
    libxkbcommon-tools \
    libxkbfile-dev \
    libxrandr-dev \
    libxrender-dev \
    libxshmfence-dev \
    libxshmfence1 \
    libx11-doc \
    libx11-freedesktop-desktopentry-perl \
    libx11-guitest-perl \
    libx11-keyboard-perl \
    libx11-protocol-other-perl \
    libx11-windowhierarchy-perl \
    libx11-xcb-perl\
    libxine2-bin \
    libxine2-dev \
    libxine2-ffmpeg \
    libxine2-misc-plugins \
    libxine2-plugins \
    libxproto-dev

4.1 开启额外选项需要安装的依赖组件

  1. SCTP
sudo apt-get install -y libsctp-dev
  1. GSSAPI
sudo apt-get install -y krb5-user krb5-config libkrb5-dev
  1. brotli

    sudo apt-get install -y brotli libbrotli-dev
  2. HiRes wheel support
    请注意,此组件安装后未能成功在配置过程中启用,此处仅记录作为后续解决问题的参考

    sudo apt-get install - y libinput10 libhidapi-dev
  3. directfb

    sudo apt-get install -y libjpeg-dev libpng-dev libfreetype6-dev libfusion-dev libdirect-dev libdirectfb-dev
  4. mysql

    sudo apt-get install -y libmysqlclient-dev
  5. ffmpeg

    sudo apt-get install -y libavcodec-dev libavformat-dev libavutil-dev libswscale-dev

5 编译&安装

  1. 在源码目录下创建build-debug用于配置和安装debug版本
  2. 在源码目录下创建build-release用于配置和安装release版本
  3. 以配置release版本为例

请注意, 配置编译时启用的组件越多,编译占用内存和交换区越大,耗时越长。

# 设置QT插件调试,以便配置、编译过程输出详细错误信息
export QT_DEBUG_PLUGINS=1
# 配置编译
# 进入build-debug目录进行配置,release则进入build-release目录
../configure -DCMAKE_CXX_STANDARD=20 -DCMAKE_CXX_STANDARD_REQUIRED=ON \
    -xcb -xcb-xlib -bundled-xcb-xinput -xkbcommon \
    -fontconfig \
    -sm \
    -glib \
    -opengl es2 \
    -release \
    -opensource -confirm-license \
    -prefix ${PWD}/install \
    -nomake tests \
    -libproxy \
    -sctp \
    -libinput \
    -sql-mysql \
    -icu \
    -openssl-linked -I/usr/local/include -I/usr/include -L/usr/local/lib64 -L/usr/lib/x86_64-linux-gnu -openssl-runtime \
    -webengine-proprietary-codecs -webengine-developer-build -webengine-ffmpeg \
    -make examples \
    -force-debug-info \
    -separate-debug-info \
    -skip qtopcua
# 配置选项说明
# -DCMAKE_CXX_STANDARD=20 -DCMAKE_CXX_STANDARD_REQUIRED=ON, 指示使用CXX20标准
# -xcb -xcb-xlib -bundled-xcb-xinput -xkbcommon 此系列选项表示使用系统环境安装的xcb和x11组件;否则将自动检测,而自动检测下大概率会失败
# -fontconfig  表示使用系统安装的fontconfig库,否则将自动检测
# -sm 表示使用系统安装的libsm版本,否则将自动检测。在自动检测下,即使安装了满足要求的版本也无法找到SM
# -glib 表示使用系统安装的glib版本
# -opengl es2 表示使用系统安装的opengl版本库, es2表示启用ES2.0
# -release 表示编译release版本,-debug则表示编译debug版本。
#     请勿使用-debug-and-release而企图同时编译debug和release版本,该选项下不会生成完整的debug版本!
#     并且官方文档明确说明-debug-and-release仅适用于Windows平台编译,虽然在linux指定了也可以进行编译。
#
# -prefix ${PWD}/install 用于指定安装路径,此处${PWD}/install表示为当前路径下的install目录
# -opensource -confirm-license 表示确认使开源协议
# -nomake tests 表示不编译tests内容
#
# -openssl-linked -I/usr/local/include -I/usr/include -L/usr/local/lib64 -L/usr/lib/x86_64-linux-gnu -openssl-runtime,用于指定安装的OpenSSL 3.x以开启OpenSS 3
#   1. 请注意,本选项中-I指定的头文件路径和-L指定的库文件路径需要根据当前的目标编译版本debug或release,修改为对应debug或release的安装路径
#   2. 同时,需要在/etc/ld.so.conf中添加当前将要使用的编译安装的OpenSSL 3.x的debug或release动态库路径,然后执行ldconfig更新ld缓存再进行编译
#
# -libproxy 表示使用系统安装的proxy,并开启编译选项
# -sctp 表示使用系统安装的SCTP,并开启编译选项
# -libinput 表示使用系统安装的input
# -sql-mysql 表示使用系统安装的MySql并启用编译选项
# -icu 表示使用系统安装的ICU库
# -webengine-proprietary-codecs -webengine-developer-build -webengine-ffmpeg,表示启用WebEngine的codecs、developer、ffmpeg
#
# -make examples 表示编译示例项目
#
# -force-debug-info 标识强制为release生成debug信息
# -separate-debug-info 将调试信息单独生成存储
#
# -skip qtopcua 表示不编译qtopcua组件。当前由于启用OpenSSL 3.x导致无法检测到OpenSSL 1.1 和2.x,编译qtopcua依赖的open62541时将无法找到部分openssl的定义,故不进行qtopcua的编译
#   若需要编译qtopcua组件,可以在完成Qt编码编译后再单独使用OpenSSL 1.1和2.x进行编译
#   也可以自行下载支持OpenSSL 3.x的open62541 1.4版本,并在configure时指定open62541的安装信息,如“-DINPUT_open62541=system -DOPEN62541_INCDIR=/usr/local/include/open62541 -DOPEN62541_LIBDIR=/usr/local/lib”

请注意, 若在配置中提示xcb和x11部分组件检测不到,请尝试重新单独安装所报错的组件,即使前序步骤已经成功安装了它们。如:

  • sudo apt-get install -y libxcomposite-dev
  • sudo apt-get install -y libxcursor-dev
  • sudo apt-get install -y libxrandr-dev
  • sudo apt-get install -y libxi-dev
  • sudo apt-get install -y libxproto-dev
  • sudo apt-get install -y libxshmfence-dev
  • sudo apt-get install -y libxtst-dev
  1. 建议每次配置时删除前一次的配置(即build-debug或build-release目录)再重新进行配置
  2. 编译和安装
# 编译,未指定核心数量时由工具链自行调度
# 可根据编译环境条件在 --parallel后显式指定用于编译的CPU核心数量,如 
# cmake --build . --parallel 12
cmake --build . --parallel
# 安装,将安装在配置时的-prefix指定的路径下
cmake --install .
  1. 编译Qt帮助文档
    完成和编译源码时一致的配置编译操作后,在build-*目录下执行:

    # 仅编译docs
    ninja docs
    # 编译完成后安装docs
    ninja install_docs

6. Qt源码编译中的坑

6.1 Qt6.5.3源码中的编码错误

6.1.1 编译过程中部分文件报错uint32_t不是std中的符号

如qt3d/src/3rdparty/assimp/src/code/AssetLib/FBX/FBXBinaryTokenizer.cpp文件
问题原因:该文件引用的是c规范的头文件stdint.h而非c++规范的cstdint,导致类型std::uint32_t不属于std命名空间
解决版本:修改源码中的#include <stdint.h>为#include

6.1.2 open62541找不到OpenSSL EVxxx定义

该问题目前尚未解决,可采取以下方法:

1. 使用-skip qtopcua的方式跳过open62541的编译
2. 可以使用自行编译的支持OpenSSL 3.x的open62541 v1.4版本,并以指定系统安装版本的方式跳过Qt自带的open62541版本的编译(待验证)
3. 不使用OpenSSL 3.x而使用OpenSSL 1.1和2.x进而不会因为版本引起问题(待验证)

编译open62541请参照如下方法:

# 下载open62541 源码, 如1.4的
#使用指定openssl库路径去编译open62541
export LD_LIBRARY_PATH=/usr/local/lib64:$LD_LIBRARY_PATH
export CMAKE_PREFIX_PATH=/usr/local/include:$CMAKE_PREFIX_PATH
# 创建一个编译目录build在其下进行配置、编译
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DUA_ENABLE_ENCRYPTION=ON -DUA_ENABLE_ENCRYPTION_OPENSSL=ON ..
make
make install