Azure Pipelines（Windows）中Appium+Python+NovaWindows驱动部署问题

背景 #

基于Python 3.13、Appium 2.19、Appium-Python-Client 5.2.2，在Azure Pipelines的windows-2022/2025镜像上测试.exe桌面UI应用，本地运行正常，但流水线中遇到三类问题，对应解决方案如下：

1. 如何在Windows代理后台启动Appium并让Python步骤可连接？ #

• Windows代理的每个流水线步骤是独立的PowerShell会话，直接启动Appium会在步骤结束后被终止。用Start-Process命令让Appium在后台运行，同时输出日志方便排查：

  Start-Process appium -ArgumentList "--log","appium.log","--port","4723" -NoNewWindow -PassThru
  

• 启动后必须加等待时间，确保服务完全就绪，比如：

  Start-Sleep -Seconds 10
  

• 后续Python测试步骤直接连接http://localhost:4723即可。

2. 如何让NovaWindows驱动在多流水线步骤中保持可用？ #

• Azure Pipelines的步骤默认不继承之前的环境变量和工具路径，所以驱动跨步骤会丢失。两种解决方式：
  • 方式一：安装驱动后，把驱动路径加入系统PATH，并用流水线命令持久化到后续步骤：

    appium driver install novawindows
    $driverPath = "$env:APPDATA\appium\node_modules\novawindows-driver"
    echo "##vso[task.setvariable variable=PATH;]$env:PATH;$driverPath"
    

  • 方式二：把驱动安装、服务启动、测试运行放在同一个PowerShell会话里执行，彻底避免环境变量隔离问题。

3. 是否推荐将所有操作放在单一步骤执行？ #

• 不建议完全合并成单一步骤，但可以把驱动安装、Appium服务启动、测试运行放在同一个PowerShell任务中执行，这样能规避环境变量和会话隔离的问题，也方便统一查看日志排查问题。
• 如果要拆分步骤，必须确保Appium相关的环境变量（比如驱动路径、工具路径）被正确传递到后续步骤，否则会出现驱动找不到的连接错误。拆分步骤的好处是能单独查看每个环节的执行状态，更精准定位问题。

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