activities

latest

false

重要 :

请注意，此内容已使用机器翻译进行了部分本地化。新发布内容的本地化可能需要 1-2 周的时间才能完成。

用户界面自动化活动

上次更新日期 2025年12月12日

本地 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 物理设备

架构

使用 iOS 物理设备时，您需要以下基础架构：

Windows 操作系统设备
- UiPath Studio（硬件/软件）– 安装指南
macOS 设备
- Appium 服务器
  - 主页
  - NodeJS
- Xcode
  - 在 iOS 设备上安装 Appium 驱动程序时所需
iOS 设备
- Appium WebDriver

图 1.iOS 本地物理设备的架构

先决条件

macOS 13+（Ventira 或更高版本）
Apple ID（用于 Xcode 和配置）
实体 iOS 设备 (IPhone/ipad)
UiPath Studio 2023.10（或更高版本）
用于连接设备的 USB 数据线

配置本地 iOS 物理设备

安装 Homebrew。
1. 打开“终端”（选择Command+Space ）。
2. 运行以下命令：
```
/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)" 
```
  图 2. Homebrew 安装 - 命令行
3. 如果出现提示，请运行以下命令，将 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)"
```
4. 验证。
```
brew -versionbrew -version
```
安装 Xcode 和命令行工具。
- 通过 App Store 安装 Xcode 并打开一次。
- 从“终端”运行以下命令：
- 1. ```
  xcode-select –installxcode-select –install
```
2. ```
sudo xcodebuild -license acceptsudo xcodebuild -license accept
```
  3. 验证:
```
xcodebuild -versionxcodebuild -version
```
在 iOS 设备上启用开发者模式。
1. 在 iPhone 或 iPad 上，转到“设置” > “隐私和安全” > “开发者模式” 。
  
  图 3. iOS 设备上的开发者模式
2. 开启并重新启动。
3. 重新启动后，批准弹出窗口。
4. 通过 USB 连接并信任计算机。
  
  图 4.启用 iOS 设备信任
安装 Node.js。
1. 运行以下命令：
  brew install nodebrew install node
  图 5. Node.js 安装
2. 验证。
  node -vnode -v
  npm -vnpm -v
安装 Appium v3。
1. 运行以下命令：
  npm install -g appium@3npm install -g appium@3
  图 6.Appium 安装
2. 验证。
  appium -vappium -v
  图 7. Appium 验证
安装 Appium 驱动程序和插件
1. 安装 iOS 驱动程序。
  appium driver install xcuitestappium driver install xcuitest
  图 8. Appium xcuitest
2. （可选）配置 Android 选项。
  appium driver install uiautomator2appium driver install uiautomator2
3. 列出驱动程序。
  appium driver listappium driver list
  图 9. Appium 驱动程序
设置 WebDriverAgent。
1. 安装 Canary。
2. 设置 WebDriverAgent。
  1. 使用以下路径导航到appium-webdriveragent文件夹： /Usetrs/<username>/appium2/node_ modules/appium-xcuitest-driver/node_ modules/appium-webdrivergent ，然后打开xcodeproj文件。
    图 10.“WebDriver 代理”文件夹
  2. 选择WebDriverAgent ，然后在“目标”部分下打开WebDriverAgentrunner 。
    图 11.WebDriverAgent 运行程序
  3. 切换到“ 签名和功能” 选项卡，选择“ 自动管理签名” ，然后从“ 团队” 下拉列表中选择用户帐户。
  4. 将 捆绑包标识符 更改为唯一值。
    图 12.WebDriverAgent 捆绑包标识符
  5. 复制并保存此捆绑包标识符，用于在移动设备管理器中添加应用程序（捆绑包 ID）。
  故障：您可能遇到的一个常见问题是不受信任的开发者证书。要解决此问题，请按照弹出窗口中的说明进行操作。
  
  图 13.WebDriverAgent 故障排除
验证物理设备访问权限。
1. 确认您的物理设备上安装了IntegrationApp 。
  
  图 14.物理设备上的 IntegrationApp
2. 运行 xcrun xctrace list devices。
3. 确保您的 iPhone 出现在列表中。如果不是，请验证“开发者模式”和“信任”设置。您需要在设备名称后的括号中输入UDID或信息。
  
  图 15.物理设备访问权限
启动 Appium 服务器。
1. 打开终端并输入appium 。
  
  图 16.Appium 服务器启动
2. 复制 Appium URL（在下一步中使用）。
  
  注意：不要使用 127 位置。
将 UiPath 连接到 Appium。
1. 打开UiPath Studio并安装“移动自动化活动” 。
2. 打开“移动设备管理器” ，然后选择“添加设备” 。

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

在此页面上