用户界面自动化活动

上次更新日期 2025年9月29日

本地 iOS 设备

设置本地 iOS 设备

要设置本地设备以使用“移动自动化”活动，您需要运行 Appium 的本地实例，并拥有自动化 iOS 设备的必要工具。

您可以自动化两种类型的本地 iOS 设备：

物理设备 - 可以通过 USB 数据线连接到本地计算机的物理 iOS 设备。
模拟器 - 用于本地存储的 iOS 设备的模拟器。

最常用的 Appium 命令

下表介绍了在移动设备自动化上下文中设置 Appium 时最常用的命令（推荐用于 Appium 2.0）：

xcrun simctl list - 列出可用的设备、设备类型、运行时或设备对。
xcrun simctl list devices - 列出可用设备。
xcrun simctl list devicetypes - 列出设备类型。
xcrun simctl list runtimes - 列出运行时。
xcrun simctl list runtimes - 列出设备对。

应用程序存储

您需要将移动应用程序存储在运行 Appium 服务器的同一台计算机上，或者将 IPA 文件上传到 Appium 服务器可匿名访问的 URL（例如Blob 存储）。

无法从 Play 商店或 App Store 安装应用程序，除非您手动自动化这些应用程序以安装特定应用程序。

重要提示：

如果您的应用程序工件使用APP扩展程序，并且您想要将该应用程序上传到公共 URL，则需要创建一个名为Payload的文件夹，将APP放入其中，存档Payload文件夹并进行更改将扩展名改为IPA而不是ZIP。

此外，请确保针对目标架构（模拟器或物理设备）编译您尝试自动化的应用程序。

配置 iOS 物理设备

先决条件

安装 Xcode。
打开终端并运行以下命令以安装 Homebrew:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
运行以下命令以安装 NodeJS:

brew install node
安装 Appium:
- 对于 Appium 1.0，运行以下命令： npm install -g appium 。这将自动安装所需的所有驱动程序。
- 对于 Appium 2.0，运行以下命令： npm install -g appium@next 。

Appium 2.0 未安装驱动程序。因此，要安装所需的驱动程序，还要运行以下命令： appium driver install xcuitest 。

重要提示：

我们建议将 Appium 2.0 与 Mobile Automation 22.10 或更高版本一起使用。
如果要在 iOS 物理设备上测试移动自动化，请安装Appium 2.0 。
1. 打开 Xcode 并允许其安装可能需要的任何其他组件。看到启动画面后，请关闭它。
2. 使用以下命令启动 Appium 服务器： appium --port 8001 --default-capabilities "{\"appium:systemPort\":9001}" --relaxed-security 。

配置本地 iOS 物理设备

将物理设备连接到 Mac。
解锁您的设备，如果弹出警示，请确保允许计算机访问它。
获取 Appium URL 并保存以备后用：
- 转到“ 系统设置”，然后转到“ 网络 ” 选项卡，然后选择物理设备连接到的 Wi-Fi 网络。
- 复制设备连接到的 Wi-Fi 网络的 IP 地址 。 Appium URL 的格式为http://<ipaddress>:8001 （ 8001是启动 Appium 的端口号）。
从 XCode 获取已连接到计算机的物理 iOS 设备的 UDID。
- 转到“ 窗口 ”>“ 设备和模拟器 ”>“ 设备”。
- 单击已连接到的 iOS 设备。
- 复制 标识符。这是 UDID，您稍后将在将此 iOS 物理设备添加到 MDM 时将其添加为其他所需功能。
在 Mac 上使用 XCode 构建 WebDriverAgent 。
- 使用以下路径导航到appium-webdriveragent文件夹： /Users/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent ，然后打开xcodeproj文件。
- 选择 WebDriverAgent ，然后打开“ 目标 ” 部分下的WebDriverAgentRunner 。
- 切换到“ 签名和功能” 选项卡，选择“ 自动管理签名” ，然后从“ 团队” 下拉列表中选择用户帐户。
- 将 捆绑包标识符 更改为唯一值。
- 复制并保存此捆绑包标识符。您将使用它在 MDM (捆绑包 ID) 中添加应用程序。
在 iOS 物理设备上安装 WebDriverAgent 。
- 在“WebDriverAgent”导航栏中选择“ WebDriverAgentRunner ”。
- 在 XCode 中，转到“ 产品”，然后单击“ 测试”。在已连接的 iOS 物理设备上，您将看到 WebDriverAgent 正在安装。
Add the configurated local physical iOS device in Mobile Device Manager, using the Adding iOS Device in Mobile Device Manager procedure.

在移动设备管理器中添加本地 iOS 设备

从 Studio 打开移动设备管理器。
在左侧导航面板中，转到“设备”。

按如下方式配置您的设备:

名称 - 在“设备”选项卡中输入用于标识设备的名称。
“Appium URL ” - 使用以下格式输入您之前复制的 Appium URL： http://<ipaddress>:8001 。
平台 - 单击字段以从下拉列表中选择“iOS”。
设备名称 - 输入设备名称。

其他所需功能 - 添加以下功能：

名称	值
`automationName`	`xcuitest` （此功能激活 Appium iOS 驱动程序）
`udid`	`the Identifier of the connected physical iOS device`

（可选）在“日志记录”选项卡中配置日志记录和视频录制详细信息。
（可选）在“开发”选项卡中配置开发流程。
- 关闭类似选项卡（默认情况下激活）: 关闭与类似设备和应用程序运行连接的选项卡。
- 等待页面更新（默认激活）: 等待页面来源检索每个操作的屏幕截图。
单击“保存并关闭”以添加设备。

您的设备已添加到“设备”列表中。要添加本地设备，请参阅。

如果您无法启动设备，请参阅“故障排除：物理设备启动失败”。

iOS 上的混合和网页自动化

如果您没有尝试自动化为生产而构建的应用程序，则默认情况下，混合自动化适用于 iOS 设备。在自动化生产应用程序时，WKWebView 托管的内容将不可自动化，但 SFSafariViewController 中托管的任何网页内容也可以在生产应用程序中实现自动化。有关更多信息，请参阅 SFSafariViewController。

在此页面上