Qt交叉编译：XCB支持方案大揭秘

Qt交叉编译：XCB支持方案大揭秘

引用

CSDN

等

6

来源

1.

https://blog.csdn.net/AI_eNyu/article/details/136943183

2.

https://blog.csdn.net/qianniulaoren/article/details/139028554

3.

https://blog.csdn.net/a2886015/article/details/139331231

4.

https://cloud.baidu.com/article/3291082

5.

https://doc.embedfire.com/linux/rk356x/Qt/zh/latest/lubancat_qt/install/install_arm_2.html

6.

https://www.cnblogs.com/HuangLiDi/p/18131530

在嵌入式Linux开发中，Qt框架因其跨平台特性和丰富的GUI功能而广受欢迎。然而，在进行Qt交叉编译时，XCB（X C Binding）的支持配置往往成为开发者面临的一大挑战。本文将详细介绍如何在交叉编译环境中正确配置XCB支持，确保Qt应用程序能够顺利运行。

XCB是X Window系统的C语言绑定库，负责处理与X服务器的通信。在Linux平台上，Qt默认使用XCB作为其显示后端。因此，正确配置XCB支持是确保Qt应用程序在目标设备上正常显示的关键。

目标板卡环境（以Debian10为例）

在开始交叉编译之前，首先需要在目标板卡上安装必要的库和工具。以下是在Debian10系统上需要执行的命令：

sudo apt update

# X11相关库
sudo apt-get install -y libx11-dev freetds-dev libxcb-xinput-dev libpq-dev libiodbc2-dev firebird-dev \
libxcb1 libxcb1-dev libx11-xcb1 libx11-xcb-dev \
libxcb-keysyms1 libxcb-keysyms1-dev libxcb-image0 libxcb-image0-dev libxcb-shm0 libxcb-shm0-dev \
libxcb-icccm4 libxcb-icccm4-dev libxcb-sync1 libxcb-sync-dev libxcb-render-util0 \
libxcb-render-util0-dev libxcb-xfixes0-dev libxrender-dev libxcb-shape0-dev libxcb-randr0-dev \
libxcb-glx0-dev libxi-dev libdrm-dev libxcb-xinerama0 libxcb-xinerama0-dev libatspi2.0-dev \
libxcursor-dev libxcomposite-dev libxdamage-dev libxss-dev libxtst-dev libpci-dev libcap-dev \
libxrandr-dev libdirectfb-dev libaudio-dev libxkbcommon-x11-dev

# GStreamer相关库
sudo apt-get install -y libgstreamer1.0-0 gstreamer1.0-plugins-base \
gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly \
gstreamer1.0-libav gstreamer1.0-doc gstreamer1.0-tools libunwind-dev

# OpenGL相关库
sudo apt-get install -y libegl1-mesa-dev libgbm-dev libgles2-mesa-dev libgles2-mesa

# 其他必要库
sudo apt-get install -y libfreetype6-dev libicu-dev libsqlite3-dev libasound2-dev libnss3-dev \
libxss-dev libxtst-dev libpci-dev libcap-dev libsrtp0-dev libxrandr-dev libdirectfb-dev libaudio-dev \
libavcodec-dev libavformat-dev libswscale-dev libts-dev libfontconfig1-dev

# 必需的开发工具
sudo apt-get install gcc g++ gdbserver rsync

主机环境（以Ubuntu20.04为例）

在主机上，我们需要配置交叉编译环境。以下是具体步骤：

1. 安装基本工具和库：

sudo apt-get update
sudo apt-get install gcc git bison python gperf pkg-config gdb-multiarch
sudo apt install build-essential

2. 创建sysroot目录：

sysroot目录用于存放目标板卡的系统文件，确保编译时能够找到正确的库和头文件。有以下两种创建方式：

• 直接复制文件到sysroot：

  从板卡的系统镜像中复制所有文件到sysroot目录。例如：

  tar -xzf sysroot_debian10.tar.gz ~
  

• 使用rsync同步文件到sysroot：

  如果板卡和主机在同一个局域网内，可以使用rsync进行文件同步：

  rsync -avz --delete user@board:/ /path/to/sysroot
  

问题1：Qt平台插件"xcb"加载失败

症状：

qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized.
Reinstalling the application may fix this problem.

解决方案：

1. 设置环境变量：

   export QT_QPA_PLATFORM_PLUGIN_PATH=/path/to/your/Qt/plugins/platforms
   

   确保路径指向实际的Qt安装目录。

2. 安装缺失的依赖库：

   sudo apt-get install libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 libxcb-xinerama0
   

3. 检查第三方库的兼容性：

   使用ldd -v命令检查第三方库的依赖关系是否完整：

   ldd -v /path/to/your/library
   

   确保所有依赖库都已正确安装。

问题2：多个Qt版本冲突

解决方案：

使用Mamba加速conda包的安装过程：

conda install mamba -c conda-forge
mamba create --name test_env python=3.8
conda activate test_env
mamba install mayavi -c conda-forge

正确配置XCB支持是Qt交叉编译成功的关键。通过在目标板卡上安装必要的XCB库，在主机上配置正确的交叉编译环境，并解决可能出现的问题，可以确保Qt应用程序在嵌入式Linux设备上顺利运行。希望本文提供的步骤和解决方案能帮助开发者顺利完成Qt项目的交叉编译工作。