WebDriverAgent 在 iOS 真机上的安装图文详解

WebDriverAgent 在 iOS 真机上的安装详解

在进行 iOS 自动化测试时，通常需要在目标设备上安装 WebDriverAgent 应用程序，以便为测试用例提供必要的功能。WebDriverAgent 作为一个中间代理，负责将 WebDriver 命令桥接到 iOS 设备，从而实现自动化测试的执行。本文将以图文并茂的方式，详细介绍如何在 iOS 真机上安装 WebDriverAgent。

先决条件

在开始安装之前，请确保您已准备以下条件：

• macOS 操作系统，版本至少为 10.14 Mojave
• Xcode，版本至少为 10.2
• iOS 真机，版本至少为 10.0
• Apple Developer 帐户

步骤详解

1. 获取 WebDriverAgent 代码

从 GitHub 上克隆 WebDriverAgent 的代码库：

git clone https://github.com/facebook/WebDriverAgent.git

2. 编译 WebDriverAgent

进入 WebDriverAgent 目录并编译项目：

cd WebDriverAgent
xcodebuild -workspace WebDriverAgent.xcworkspace -scheme WebDriverAgentRunner -configuration Debug

3. 安装 WebDriverAgent

将编译好的 WebDriverAgent.app 安装到 iOS 真机上：

• 通过 Xcode：在 Xcode 中，选择 Window -> Devices and Simulators，将 WebDriverAgent.app 拖放到 iOS 真机上。
• 通过命令行：使用以下命令，将 WebDriverAgent.app 安装到设备的 /Applications 目录下：

xcrun simctl install booted WebDriverAgent.app

4. 允许 WebDriverAgent 的调试

为了让 WebDriverAgent 在真机上运行，需要允许其调试：

• 打开 iOS 设置，转到“通用”->“设备管理”->“信任“您的组织名称””。
• 再次打开设置，转到“隐私”->“调试”，确保 WebDriverAgent 已被选中。

验证安装

安装完成，打开终端并输入以下命令来验证 WebDriverAgent 是否已成功安装：

instruments -s devices

在设备列表中，应该可以看到 WebDriverAgent 正在运行。

常见问题解答

1. 安装时遇到“Bundle signing failed”错误

确保您已使用正确的 Apple Developer 帐户签署 WebDriverAgent 项目。

2. 运行时遇到“Couldn't start WebDriverAgentRunner”错误

尝试重新启动 iOS 真机，然后重新安装 WebDriverAgent。

3. WebDriverAgent 无法与真机建立连接

确保 iOS 真机已连接到 Mac，并且在终端中已使用 xcrun simctl 命令允许调试。

结语

遵循本指南，您可以在 iOS 真机上顺利安装 WebDriverAgent。通过 WebDriverAgent，您可以轻松进行 iOS 自动化测试，提高测试效率和覆盖率。