WinAppDriver Java如何实现多窗口之间的焦点切换

你遇到的getWindowHandles()仅返回1个句柄的问题，本质是WinApp Driver默认只会枚举当前启动会话绑定的初始主窗口相关的同进程子窗口，基于Chromium开发的桌面应用（比如Electron应用）的弹出窗口大多是独立渲染进程的顶层窗口，默认不会被当前会话识别。以下是两种可落地的解决方案：

方案1：通过桌面根会话枚举所有窗口（兼容性最高） #

这种方式不依赖当前应用会话的窗口识别逻辑，直接通过桌面级会话获取所有系统顶层窗口，筛选出你需要的目标窗口后切换：

• 首先创建绑定桌面根的独立会话，用于窗口枚举
  以下是Python示例代码：

  from appium import webdriver
  from selenium.webdriver.common.by import By
  
  # 桌面会话配置
  desktop_cap = {
      "app": "Root",
      "platformName": "Windows",
      "deviceName": "WindowsPC"
  }
  desktop_driver = webdriver.Remote("http://127.0.0.1:4723", desired_capabilities=desktop_cap)
  

• 点击确认按钮弹出新窗口后，加1~2秒等待确保窗口加载完成，再通过桌面会话筛选目标窗口

  # 按窗口类名筛选（Chromium类应用窗口类名通常为Chrome_WidgetWin_1），也可以按标题、XPATH匹配
  all_app_windows = desktop_driver.find_elements(By.CLASS_NAME, "Chrome_WidgetWin_1")
  
  # 遍历所有匹配窗口，提取句柄切换
  for win in all_app_windows:
      # 将原生窗口句柄从十进制转为十六进制字符串，适配WinApp Driver的切换规则
      win_handle = hex(int(win.get_attribute("NativeWindowHandle")))
      # 切换到目标窗口
      your_app_driver.switch_to.window(win_handle)
      # 可通过title或者窗口内独有元素判断是否是需要操作的窗口
      if "Window B" in your_app_driver.title:
          # 执行对应窗口的操作
          break
  

方案2：修改启动配置，开启多窗口自动识别 #

如果你的应用所有弹出窗口和主程序属于同一个父进程，可以直接修改启动参数让WinApp Driver自动识别所有顶层窗口，调用原生getWindowHandles()即可拿到所有句柄：

• 启动应用会话时在Capabilities中添加两个参数：

  app_cap = {
      "app": "你的应用exe路径",
      "platformName": "Windows",
      "deviceName": "WindowsPC",
      # 新增以下两个参数
      "ms:experimental-webdriver": True,
      "forceAppMatch": False
  }
  app_driver = webdriver.Remote("http://127.0.0.1:4723", desired_capabilities=app_cap)
  

• 弹出新窗口后直接调用getWindowHandles()就能获取到所有窗口句柄，直接切换即可：

  # 等待窗口加载完成后获取所有句柄
  all_handles = app_driver.window_handles
  for handle in all_handles:
      app_driver.switch_to.window(handle)
      if "Window B" in app_driver.title:
          # 执行操作
          break
  

注意事项 #

• 弹出窗口后必须加显式等待，避免窗口未完全渲染导致拿不到句柄
• 切换窗口后如果出现元素找不到的问题，可以先调用app_driver.execute_script("window.focus()")激活当前窗口焦点
• 匹配窗口时优先用窗口标题、独有元素特征做校验，避免切到其他同类型的Chromium应用窗口

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