在QEMU中为ARM64运行CTest单元测试遇问题求助

一、QEMU运行Qt单元测试找不到平台插件的解决办法 #

Qt的平台插件依赖未正确加载是核心问题，可通过以下方式处理：

• 指定插件路径与无UI平台：运行测试时通过环境变量指定Qt使用无图形界面的offscreen平台，同时确保插件路径指向SDK中的ARM64版本插件目录：

  qemu-aarch64 -L $SDKTARGETSYSROOT -e QT_QPA_PLATFORM=offscreen -e QT_QPA_PLATFORM_PLUGIN_PATH=$SDKTARGETSYSROOT/usr/lib/qt6/plugins/platforms <path/to/unit-test>
  

• 检查SDK插件完整性：确认$SDKTARGETSYSROOT/usr/lib/qt6/plugins/platforms目录下存在libqoffscreen.so，如果缺失，需要在Yocto构建时启用QtBase的offscreen平台支持，可在配方中添加配置项启用该插件。

二、CTest跨架构运行失败的解决办法 #

x86_64架构的CTest无法直接执行ARM64二进制程序，推荐两种解决方式：

1. 配置CMake交叉测试运行器（优先选择） #

在项目的CMakeLists.txt中添加交叉编译测试配置，让CTest自动调用QEMU运行测试程序：

if(CMAKE_CROSSCOMPILING)
  # 指定QEMU作为测试程序的运行器
  set(CMAKE_CROSSCOMPILING_EMULATOR "qemu-aarch64;-L;$ENV{SDKTARGETSYSROOT}")
  # 给测试程序设置Qt无UI环境变量
  set(TEST_ENV "QT_QPA_PLATFORM=offscreen")
  # 将环境变量应用到测试用例
  set_tests_properties(your_test_target PROPERTIES ENVIRONMENT "${TEST_ENV}")
endif()

配置完成后，直接运行ctest即可自动通过QEMU执行ARM64测试程序。

2. 为SDK添加ARM64版本CMake/CTest（可选） #

如果需要使用ARM架构的CTest，需在Yocto构建时将CMake加入目标任务：

# 在local.conf中添加
TOOLCHAIN_TARGET_TASK:append = " cmake"

重新生成SDK后，会包含ARM64版本的CMake和CTest，但需要在QEMU环境中运行该版本CTest，操作复杂度高于第一种方法。

三、CMake配置检查要点 #

• 确认交叉编译工具链文件正确：确保Yocto生成的工具链文件中CMAKE_SYSTEM_PROCESSOR设为aarch64，且链接路径包含SDK的Qt库目录。
• 精简Qt依赖：纯逻辑单元测试仅引入QtCore等非UI模块，避免不必要的GUI组件依赖，减少平台插件需求。
• 验证Qt模块引入：通过find_package(Qt6 REQUIRED COMPONENTS Core)正确引入所需模块，并确保测试目标链接对应的Qt库。

内容的提问来源于stack exchange，提问作者Paiusco