本地 iOS 设备

设置本地 iOS 设备

要设置本地设备以使用 Mobile Automation 活动，您需要：

• 拥有 macOS 环境。
• 在 macOS 设备上运行 Appium 的本地实例。

您可以自动化两种类型的本地 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.0 与 Mobile Automation 22.10 或更高版本一起使用。

   • 如果要在 iOS 物理设备上测试移动自动化，请安装Appium 2.0 。

5. 打开 Xcode 并允许其安装可能需要的任何其他组件。看到启动画面后，请关闭它。
6. 使用以下命令启动 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>:8001 （ 8001是启动 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。