https://liar.org.cn/ https://liar.org.cn/index.php/2025/12/09/79.html 2025-12-08T19:29:00+00:00 构建环境环境要求用于进行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自带副本进行编译而不使用系统环境所提供版本：zliblibpngfreetypeharfbuzzpcre2libjpegsqlitewebengine-*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、lddsudo 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 \ libudev1XCB&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 \ \ zstdOpenGL# 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-mesaOpenSSLsudo 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-devatspi——X11 Accessibility Bridgesudo apt-get install -y \ libatspi2.0-devlibproxy——Qt 网络代理支持sudo apt-get install -y \ libproxy-devSCTP——SCTP 协议支持sudo apt-get install -y \ libsctp-devSRTPsudo apt-get install -y \ libsrtp2-devPCI——PCI检测sudo apt-get install -y \ libpci-devLTTng——性能跟踪工具sudo apt-get install -y \ lttng-modules-dkms \ liblttng-ust-dev \ lttng-toolsdirectfb——嵌入式平台 GUI，桌面一般不启用适用于嵌入式。使用Qt自带副本时，请勿安装。sudo apt-get install -y \ libfusion-dev \ libdirect-dev \ libdirectfb-devGSSAPI——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 \ cupshunspell——Qt Virutal Keyboard拼写检查sudo apt-get install -y \ hunspell \ libhunspell-devSensorFW支持sudo apt-get install -y \ libsensors4-dev \ libsensors-configHiRes Wheelsudo apt-get install -y \ libinput10 \ libhidapi-devassimp——Quick3D使用Qt自带副本时，请勿安装。sudo apt-get install -y libjasper sudo apt-get install -y \ libassimp-dev depend on jasperFFMPEG——Qt Multimedia / WebEngine / VideoQt6.5.7中多媒体组件必须使用系统提供的版本，并且版本需要在4.x以上；仅QWebEngine可以选择使用自带副本或系统版本。不支持直接安装4.x以上版本时，请从源码编译安装FFMPEG。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_PATHPositioningsudo 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-contribgRPCQt 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-dataQWebEnginePython3sudo apt-get install -y \ python3 \ python3-dev \ python3-setuptools \ python-is-python3 \ python3-pip \ python3-pexpectHTML5sudo apt install -y \ python3-html5lib \ python3-lxml \ python3-openssl \ python3-bs4NodeJS若需更新版本可通过打开链接获取最新的指令：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.xbrotli使用Qt自带副本时，请勿安装。sudo apt-get install -y \ brotli \ libbrotli-devQWebEngine# 构建工具和解析器 # 词法分析器生成器 # 语法解析器生成器 # 完美哈希函数生成工具 # 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-devsudo 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 https://liar.org.cn/index.php/2025/12/06/77.html 2025-12-06T13:24:00+00:00 基础软件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 https://liar.org.cn/index.php/2025/11/29/44.html 2025-11-29T08:27:00+00:00 源码下载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-configX11、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-devWebSocketsudo apt-get install -y libwebsockets-devPositioningsudo 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 installapt安装源码编译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.gitclipperapt安装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、Mesasudo 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-devOpenSSL源码编译(选)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_swICU源码编译(选)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 installlibproxy源码编译(选)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 installGStreamer 源码编译（选）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 buildrelease# 删除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 installdebug# 删除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 https://liar.org.cn/index.php/2025/08/20/27.html 2025-08-20T02:40:00+00:00 安装依赖环境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++与cmakesudo 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=releasegcc-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为组名 # 根据提示输入序号来选择版本 https://liar.org.cn/index.php/2025/07/13/26.html 2025-07-13T05:50:00+00:00 鸢尾花紫：#744DA9 (116, 77, 169)其他紫色：#403287 (64, 50, 135), #674EA7 (103, 78, 167)海沫绿：#00B7C3 (0, 183, 195)浅薄荷：#00B294 (0, 178, 148)马尔斯绿: #375E47 (55, 94, 71), #01847F (1, 132, 127) https://liar.org.cn/index.php/2024/12/02/24.html 2024-12-02T09:04:00+00:00 /** * Copyright (C) %{CurrentDate:yyyy}, XXX. * All Rights Reserved. * * @file %{CurrentDocument:FileName} * @brief * * @details * * @author Mr.Liar.Jr@Outlook.com * @date %{CurrentDate:MM\/dd\/yyyy} * @note * * HISTORY * @version 0.0.1 创建文件. %{CurrentDate:MM\/dd\/yyyy} %{CurrentTime:hh:mm:ss} Mr.Liar.Jr@Outlook.com */ https://liar.org.cn/index.php/2024/10/30/23.html 2024-10-30T01:48:58+00:00 chrome官网页面url后增加后缀：?standalone=1&platform=win64https://www.google.cn/chrome/?standalone=1&platform=win64 https://liar.org.cn/index.php/2024/10/09/21.html 2024-10-09T11:56:00+00:00 记录实际使用过程中可以正常代理的端口号：80，443，8080，2086，2052，2053，2082，2083，2086，2087，2095，2096，8880，8443 https://liar.org.cn/index.php/2024/09/17/19.html 2024-09-16T19:07:00+00:00 安装yum-utils、createrepo、httpdyum install -y httpd yum-utils createrepo开放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解决http无法访问子目录问题#编辑/etc/sysconfig/selinux vim /etc/sysconfig/selinux #将SELINUX=enforcing修改为SELINUX=disabled #执行命令使其生效 setenforce 0启动http服务systemctl restart httpd查看当前yum源yum repolist #将列出 repo id         repo name信息 base/7/x86_64           xxxx extras/7/x86_64         xxxx updates/7/x86_64        xxxx将repolist中所有repo id对应的包都下载到本地reposync --repo repo-id -p /local-repo-folder-path/ #repo-id 为当前要下载的仓库id #local-repo-folder-path为当前用于存储下载仓库资源的目录路径将所有仓库资源下载完毕后，生成repodata索引依赖cd /local-repo-folder-path/ createrepo repo-id/ #repor-id为仓库id备份原有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 # 重复上述配置节点，为所有仓库添加配置节点验证# 清理yum yum clean all # 建立yum缓存 yum makecache # 查看仓库 yum repolist # 更新yum yum update # 安装软件以验证其他仓库离线源方式与前述步骤一直，如docker-ce等等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 原配置内容 https://liar.org.cn/index.php/2024/08/26/18.html 2024-08-26T08:46:10+00:00 gitlab-runner安装gitlab-runner容器使用gitlab.com安装部署指导手册下载相应gitlab-runner镜像并使用docker运行即可。gitlab-runner以容器的方式提供服务时，可在启动容器时通过-v将本地gitlab-runner/config.toml文件挂载到容器中，以提供认证等配置信息。对本地文件config.toml的修改将不能即时生效，需要重启容器。启动容器以本地文件挂载方式启动容器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以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 registergitlab-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"}}}']