Skip to content
On this page

iOS 设备接入 agent

TIP

在 2023-05-14 发布的 WebDriverAgent(v5.0.0),环境要求: xcode >= 13 & iOS >= 15。如果不满足 xcode 与 iOS 要求,可以安装 v5.0.0 之前的 WebDriverAgent,github 下载地址

安装 wda

TIP

个人免费证书安装的 wda,只能使用 7 天。7 天后需要卸载重装

  1. 命令行执行 appium driver run xcuitest open-wda 将自动打开 xcode 与 wda

  2. 安装 wda

    2.1 WebDriverAgentLib

    An image

    2.2 WebDriverAgentRunner

    Product Bundle Identifier 调整为唯一值(如: com.你的公司名.WebDriverAgentRunner),后续将使用该值启动 wda An imageAn image

    2.3 安装 wda 到设备中 (iOS >= 16 需打开开发者模式,请自行百度打开方法)

    An imageAn image

  3. 等待 Test 执行一段时间后,会发现设备已安装 WebDriverAgent APP,设备需信任该 APP: 设置 -> 通用 -> VPN 与设备管理 -> 开发者 APP -> 信任

安装 go-ios 并测试能否运行 wda

  1. 安装 go-ios

    方式 1. npm install -g go-ios

    方式 2. 点击下载 go-ios,解压 zip 获得 ios / ios.exe,将 ios / ios.exe 所在路径添加到 PATH,以便命令行与 agent 可以调用

  2. 验证 go-ios 能否运行 wda

    2.1 运行 wda

    com.yqhp.WebDriverAgentRunner 调整为安装 wda 时 Product Bundle Identifier所填写的值

    sh
    $ ios runwda --bundleid=com.yqhp.WebDriverAgentRunner.xctrunner \
    --testrunnerbundleid=com.yqhp.WebDriverAgentRunner.xctrunner \
    --xctestconfig=WebDriverAgentRunner.xctest

    2.2 开一个新的终端执行 forward

    sh
    $ ios forward 9100 9100

    2.3 访问 http://localhost:9100 能看到手机投屏即可

  3. 关闭步骤 2 开启的 2 个终端窗口,以免影响后续操作