如何使用Ruby Capybara框架初始化Android的Appium驱动？

问题场景 #

尝试通过代码注册云端Android Appium驱动时，出现两个问题：

1. 报错：undefined method 'testExecutionTags' for nil:NilClass
2. 警告：WARN: Screenshot could not be saved. page.current_path raised exception: #<ArgumentError: rack-test requires a rack application, but none was given>.

原代码 #

def register_cloud_mobile_driver
  Capybara.register_driver :cloud_mobile do |app|
    opts = Selenium::WebDriver::Remote::Capabilities.firefox(
      securityToken: @sec_token,
      platformVersion: 'xx',
      platformBuild: 'xxxxx',
      manufacturer: 'xxx',
      model: 'Galaxy S22',
      resolution: '1080x2340',
      deviceStatus: 'CONNECTED',
      location: 'xxxx',
      appPackage: 'xxxxx',
      appActivity: 'xxxxx.activity.SplashActivityV2',
      takesScreenshot: false,
      screenshotOnError: true
    )
    Capybara::Selenium::Driver.new(app, browser: :remote, url: $server_url, desired_capabilities: opts)
    Capybara.default_driver = cloud_mobile
  end
end

错误原因分析 #

1. undefined method 'testExecutionTags' for nil:NilClass：
   • 在驱动注册块内部错误使用了未定义的变量cloud_mobile，而非正确的符号:cloud_mobile；且该代码放在注册块内时，驱动尚未完成注册，导致Capybara内部上下文出现nil引用。
2. rack-test相关警告：
   • Capybara默认依赖rack-test驱动，而移动端Appium测试不需要本地rack应用，未关闭本地服务器或未正确配置驱动，导致框架尝试调用rack相关方法出错。
   • 使用了针对桌面浏览器的Firefox capabilities模板，不匹配Android Appium环境。

修正后的代码 #

def register_cloud_mobile_driver
  # 关闭Capybara本地服务器，移动端测试无需启动
  Capybara.run_server = false

  Capybara.register_driver :cloud_mobile do |_app|
    # 使用Android专属配置结构，构建Appium兼容的capabilities
    opts = {
      securityToken: @sec_token,
      platformName: 'Android',
      platformVersion: 'xx',
      platformBuild: 'xxxxx',
      manufacturer: 'xxx',
      model: 'Galaxy S22',
      resolution: '1080x2340',
      deviceStatus: 'CONNECTED',
      location: 'xxxx',
      appPackage: 'xxxxx',
      appActivity: 'xxxxx.activity.SplashActivityV2',
      takesScreenshot: false,
      screenshotOnError: true
    }

    # 初始化远程驱动，明确忽略rack应用参数
    Capybara::Selenium::Driver.new(
      nil,
      browser: :remote,
      url: $server_url,
      desired_capabilities: Selenium::WebDriver::Remote::Capabilities.new(opts)
    )
  end

  # 驱动注册完成后设置为默认驱动
  Capybara.default_driver = :cloud_mobile
end

关键修改说明 #

• 关闭本地服务器：添加Capybara.run_server = false，彻底规避rack-test相关依赖警告。
• 替换Capabilities模板：放弃Firefox的capabilities，改用Android专属配置结构，确保与Appium环境兼容。
• 调整默认驱动设置位置：将Capybara.default_driver = :cloud_mobile移到注册块外部，确保驱动完成注册后再设置默认值，同时使用正确的符号格式。
• 忽略app参数：初始化驱动时传递nil代替原有app参数，明确告知Capybara无需rack应用上下文。

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