用户界面自动化活动

上次更新日期 2025年10月28日

本地 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:
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 
```
1. 运行以下命令，将 Homebrew 添加到PATH环境变量中：
```
echo >> /Users/<username>/.zprofile
  echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/<username>/.zprofile
  eval "$(/opt/homebrew/bin/brew shellenv)"echo >> /Users/<username>/.zprofile
  echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/<username>/.zprofile
  eval "$(/opt/homebrew/bin/brew shellenv)"
```
运行以下命令以安装 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 正在安装。
使用“在移动设备管理器中添加 iOS 设备”过程，在移动设备管理器中添加已配置的本地实体 iOS 设备。

在移动设备管理器中添加本地 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。

在此页面上