appium连接ios真机使用教程

### Appium 连接 iOS 真机环境搭建 #### 工具准备 为了实现Appium连接iOS真机，需要一系列必要的工具和依赖项。以下是所需的主要组件及其作用： 1. **Appium 客户端版本**: 可以选择命令行版或者GUI版的Appium。推荐使用最新版本的Appium Desktop GUI界面版本[^1]。 2. **Xcode 和 Command Line Tools**: Xcode 是开发iOS应用程序的核心工具集，Command Line Tools 提供了构建和调试所需的命令行接口。 3. **Carthage 或 CocoaPods**: 用于管理项目中的第三方库依赖关系。WebDriverAgent (WDA) 的安装通常会涉及这些包管理工具之一。 4. **usbmuxd**: 此服务允许计算机与通过USB连接的iOS设备通信。它本质上是一个基于socket的协议栈，在某些情况下可能需要用Python脚本模拟其行为以便于测试框架集成[^2]。 5. **Simulator/Device Support Files**: 如果目标是针对特定版本的操作系统，则需确保拥有相应的支持文件并配置好对应的SDK路径[^3]。 #### 配置步骤概述 ##### WebDriverAgent 编译部署 - 下载官方提供的[WDA源码](https://github.com/facebookarchive/WebDriverAgent)，按照README文档指示完成编译过程。 - 利用`xcodebuild`指令执行实际编译操作前，请确认已设置正确的架构参数(-arch x86_64/-arm64e etc.)以及指定的目标平台(SDK)名称(iphonesimulator/ipados etc.). ```bash xcodebuild -project WebDriverAgent.xcodeproj \ -scheme WebDriverAgentRunner \ -destination 'id=<device_udid>' test ``` > 注：上述命令里的< device_udid >应替换为你所使用的物理硬件唯一标识符字符串；可以通过运行`instruments -s devices`查询获取该值。 ##### 启动Session 设置 Desired Capabilities 参数 当所有前期准备工作完成后，创建一个新的session时要特别注意传递给服务器的关键属性列表(desired capabilities): | Key | Value Example | |-------------------|----------------------------------| | platformName | `iOS` | | automationName | `XCUIAutomationTest` | | udid | `<your_device_id>` | | app | `/path/to/my.app` | | wdaLocalPort | `8100`(默认即可不填此项) | 示例JSON对象如下所示: ```json { "platformName":"iOS", "automationName":"XCUIAutomationTest", "udid":"<your_device_id>", "app":"/Users/user/Documents/app/build/Release-iphoneos/my.app" } ``` 最后一步就是启动您的自动化脚本程序并与远程真实装置交互啦！ ---