如何在Linux无头CI/CD环境命令行测试托盘图标交互？

背景 #

我之前的CI/CD流水线用Xvfb启动帧缓冲，配合xdotool聚焦窗口并发送ctrl+q来测试带界面的应用退出逻辑，脚本如下：

#!/bin/bash -eux
export DISPLAY=:101
Xvfb $DISPLAY &
$application --debug &
application_pid=$!
while true; do
    sleep 2
    xdotool search --class $application windowfocus
    xdotool key ctrl+q
done &
wait "$application_pid"

现在我开发了一款运行在通知托盘的Qt6/PySide6应用，菜单里有“Exit”选项，想知道能不能在无头CI/CD环境里模拟虚拟托盘，调出菜单并选择Exit项来完成测试？

可行方案 #

方案1：用xdotool定位托盘图标并模拟点击 #

Qt托盘图标在X11环境下依赖窗口管理器提供的托盘容器，纯Xvfb无法支持，需先启动轻量窗口管理器，再通过xdotool模拟操作：

1. 补充Xvfb环境配置：启动窗口管理器（如openbox），确保托盘能正常渲染：

   export DISPLAY=:101
   Xvfb $DISPLAY -screen 0 1024x768x16 &
   sleep 1
   openbox &
   sleep 2  # 等待窗口管理器初始化完成
   

2. 定位应用托盘图标：通过应用名称或窗口类名查找托盘图标ID：

   tray_icon_id=$(xdotool search --name "你的应用托盘显示名称")
   

3. 模拟右键点击调出菜单：

   xdotool windowfocus $tray_icon_id
   xdotool click 3  # 触发右键菜单
   sleep 1  # 等待菜单弹出
   

4. 定位并点击Exit选项：菜单是独立窗口，通过名称找到Exit项并模拟左键点击：

   exit_menu_id=$(xdotool search --name "Exit")
   xdotool windowfocus $exit_menu_id
   xdotool click 1
   

方案2：利用Qt测试API（更稳定） #

如果是PySide6应用，直接通过Qt自身API触发退出逻辑，无需依赖X11工具：

1. 编写测试脚本，直接调用托盘菜单的Exit动作：

   from PySide6.QtWidgets import QApplication
   import sys
   import your_app_module  # 导入你的应用模块
   
   app = QApplication(sys.argv)
   # 假设应用中托盘图标实例为tray_icon
   tray_icon = your_app_module.get_tray_icon()
   # 遍历菜单找到Exit动作并触发
   exit_action = next(act for act in tray_icon.contextMenu().actions() if act.text() == "Exit")
   exit_action.trigger()
   app.exec()
   

2. 在CI脚本中直接运行该测试脚本，配合Xvfb环境即可。

方案3：用xte替代xdotool（灵活适配坐标） #

如果xdotool窗口定位失效，可使用xte（来自xautomation包）通过坐标模拟操作：

# 先通过xwininfo获取托盘图标坐标（x,y）
xte "mouseclick 3" -x [托盘图标X坐标] -y [托盘图标Y坐标]
sleep 1
# 获取Exit菜单选项坐标后模拟点击
xte "mousemove [Exit选项X坐标] [Exit选项Y坐标]" "mouseclick 1"

完整CI脚本示例（方案1） #

#!/bin/bash -eux
export DISPLAY=:101
# 启动Xvfb与窗口管理器
Xvfb $DISPLAY -screen 0 1024x768x16 &
sleep 1
openbox &
sleep 2

# 启动目标应用
$application --debug &
application_pid=$!
sleep 3  # 等待应用及托盘图标加载完成

# 触发托盘菜单并选择Exit
tray_icon_id=$(xdotool search --name "你的应用托盘显示名称")
xdotool windowfocus $tray_icon_id
xdotool click 3
sleep 1

exit_menu_id=$(xdotool search --name "Exit")
xdotool windowfocus $exit_menu_id
xdotool click 1

# 等待应用退出
wait "$application_pid"

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