test-suite
2024.10
true
UiPath logo, featuring letters U and I in white

Test Suite 用户指南

Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
上次更新日期 2024年11月11日

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

先决条件

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

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  3. 运行以下命令以安装 NodeJS:

    brew install node

  4. 安装 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.0Mobile Automation 22.10 或更高版本一起使用。
  • 如果要在 iOS 物理设备上测试移动自动化,请安装Appium 2.0 。

    1. 打开 Xcode 并允许其安装可能需要的任何其他组件。看到启动画面后,请关闭它。
    2. 使用以下命令启动 Appium 服务器: appium --port 8001 --default-capabilities "{\"appium:systemPort\":9001}" --relaxed-security


配置本地 iOS 物理设备

  1. 将物理设备连接到 Mac。
  2. 解锁您的设备,如果弹出警示,请确保允许计算机访问它。
  3. 获取 Appium URL 并保存以备后用:
    • 转到“ 系统设置”,然后转到“ 网络 ” 选项卡,然后选择物理设备连接到的 Wi-Fi 网络。
    • 复制设备连接到的 Wi-Fi 网络的 IP 地址 。 Appium URL 的格式为http://<ipaddress>:80018001是启动 Appium 的端口号)。


  4. 从 XCode 获取已连接到计算机的物理 iOS 设备的 UDID。
    • 转到“ 窗口 ”>“ 设备和模拟器 ”>“ 设备”。
    • 单击已连接到的 iOS 设备。
    • 复制 标识符。 这是 UDID,您稍后将在将此 iOS 物理设备添加到 MDM 时将其添加为其他所需功能。
  5. 在 Mac 上使用 XCode 构建 WebDriverAgent
    • 使用以下路径导航到appium-webdriveragent文件夹: /Users/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent ,然后打开xcodeproj文件。
    • 选择 WebDriverAgent ,然后打开“ 目标 ” 部分下的WebDriverAgentRunner 。
    • 切换到“ 签名和功能” 选项卡,选择“ 自动管理签名” ,然后从“ 团队” 下拉列表中选择用户帐户。
    • 捆绑包标识符 更改为唯一值。
    • 复制并保存此捆绑包标识符。 您将使用它在 MDM (捆绑包 ID) 中添加应用程序。



  6. 在 iOS 物理设备上安装 WebDriverAgent
    • 在“WebDriverAgent”导航栏中选择“ WebDriverAgentRunner ”。
    • 在 XCode 中,转到“ 产品”,然后单击“ 测试”。 在已连接的 iOS 物理设备上,您将看到 WebDriverAgent 正在安装。
  7. 使用“在移动设备管理器中添加 iOS 设备”过程,在移动设备管理器中添加已配置的本地实体 iOS 设备。

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

  1. 从 Studio 打开移动设备管理器。
  2. 在左侧导航面板中,转到“设备”。
  3. 按如下方式配置您的设备:
    • 名称 - 在“设备”选项卡中输入用于标识设备的名称。
    • “Appium URL ” - 使用以下格式输入您之前复制的 Appium URL: http://<ipaddress>:8001
    • 平台 - 单击字段以从下拉列表中选择“iOS”。
    • 设备名称 - 输入设备名称。
    • 其他所需功能 - 添加以下功能:

      名称

      automationName

      xcuitest (此功能激活 Appium iOS 驱动程序)

      udid

      the Identifier of the connected physical iOS device

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

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

    如果您无法启动设备,请参阅“故障排除:实体设备启动失败”



iOS 上的混合和网页自动化

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

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。