并行运行Appium V2与V3时V3驱动加载失败的配置问题

你的核心问题是Appium V3的自定义APPIUM_HOME路径下未正确安装驱动，导致无法读取manifest文件；而默认用户目录C:\users\myusername\.appium是之前驱动安装的路径，因此能正常加载。要实现多版本独立配置，需按以下步骤操作：

一、为每个版本创建独立且权限充足的APPIUM_HOME目录 #

• 确保各版本的APPIUM_HOME完全独立，示例路径：
  • V1：C:\Program Files\My Web Server\server\appiumV1\appium_home
  • V2：C:\Program Files\My Web Server\server\appiumV2\appium_home（已配置）
  • V3：C:\Program Files\My Web Server\server\appiumV3\appium_home（已配置）
• 给这些目录分配启动Appium服务的系统用户读写权限，避免因权限不足无法读取或写入驱动文件。

二、在对应版本的APPIUM_HOME环境下安装驱动 #

Appium V2/V3的驱动独立于核心程序，必须在指定的APPIUM_HOME下安装才会被该版本识别：

1. Appium V3驱动安装 #

打开命令提示符，切换到V3的运行环境，设置专属APPIUM_HOME后安装驱动：

# 设置V3专属APPIUM_HOME
set APPIUM_HOME=C:\Program Files\My Web Server\server\appiumV3\appium_home
# 切换到V3的node所在目录
cd C:\Program Files\My Web Server\server\appiumV3
# 安装所需驱动
node.exe .\.tools\appium3\node_modules\appium\build\lib\main.js driver install uiautomator2 espresso xcuitest
# 验证驱动安装状态
node.exe .\.tools\appium3\node_modules\appium\build\lib\main.js driver list

执行后确认驱动列表显示已安装，且路径指向V3的APPIUM_HOME目录。

2. Appium V2驱动安装（已正常可跳过） #

若后续V2需新增驱动，同样在V2的APPIUM_HOME环境下操作：

set APPIUM_HOME=C:\Program Files\My Web Server\server\appiumV2\appium_home
cd C:\Program Files\My Web Server\server\appiumV2
node.exe .\packages\appium driver install [驱动名称]

3. Appium V1配置（兼容老版本） #

Appium V1的驱动为内置形式，无需单独安装，只需在wrapper.config中设置专属环境变量（如APPIUM_BINARY_PATH）指向V1的安装目录，确保启动时使用独立运行环境。

三、优化wrapper.config与启动命令 #

避免在启动命令中临时设置环境变量，直接在wrapper.config为每个版本单独配置：

1. V2的wrapper配置（已正常） #

保持现有配置即可：

wrapper.app.env.APPIUM_PATH = C:\\Program Files\\My Web Server\\server\\appiumV2
wrapper.app.env.APPIUM_HOME = C:\\Program Files\\My Web Server\\server\\appiumV2\\appium_home

启动命令无需修改。

2. V3的wrapper配置 #

为V3的wrapper实例单独设置APPIUM_HOME：

wrapper.app.env.APPIUM_V3_PATH = C:\\Program Files\\My Web Server\\server\\appiumV3
wrapper.app.env.APPIUM_HOME = C:\\Program Files\\My Web Server\\server\\appiumV3\\appium_home

启动命令简化为（无需在cmd中临时set环境变量）：

"C:\Program Files\My Web Server\server\appiumV3\node.exe" "C:\Program Files\My Web Server\server\appiumV3\.tools\appium3\node_modules\appium\build\lib\main.js" --log-level debug --local-timezone -g "C:\Program Files\My Web Server\server\log\appium_v3\1768988702420_appiumV3.log" --address 127.0.0.1 --port 28286 --base-path /wd/hub

四、验证启动结果 #

启动各版本后检查日志：

• 确认V3日志中不再出现c:\jenkins\workspace\my_appium_repo-appium_master相关错误
• 验证各版本的驱动均加载成功，可通过发送简单的session请求测试驱动可用性

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