appium连接手机真机

### 配置和使用 Appium 连接真实设备 #### iOS 设备配置 为了使 Appium 能够连接并控制真实的 iOS 设备，需满足特定条件以及完成一系列设置。 对于 iOS 真实设备而言，测试的应用程序必须采用开发证书进行签名才能支持调试功能[^2]。这意味着开发者账户下的应用可以被安装到实际的 iPhone 或 iPad 上，并允许对其进行自动化操作。此外，在启动会话之前，还需要准备如下 Desired Capabilities 参数： - `platformName`: 设置为 "iOS" - `deviceName`: 输入目标设备名称 - `udid`: 提供唯一标识符 (可通过 iTunes 获取) - `xcodeOrgId` 和 `xcodeSigningId`: 如果不是企业级账号，则需要提供 Apple 开发者团队 ID 及描述文件名 - `app`: 应用路径指向 .ipa 文件或已编译好的本地 app bundle 地址 - `automationName`: 推荐设为 "XCUITest" ```json { "platformName": "iOS", "deviceName": "Your Device Name", "udid": "<your device udid>", "xcodeOrgId": "<apple developer team id>", "xcodeSigningId": "iPhone Developer", "app": "/path/to/your/app.ipa", "automationName": "XCUITest" } ``` 当涉及到 WebView 的 H5 页面时，还需额外指定一些参数来启用 Web 查看器的支持。例如，可以通过设置 `browserName` 为空字符串并将 `autoWebview` 属性设为 true 来自动切换至 web context。 #### Android 设备配置 针对 Android 实际设备的情况相对简单些，主要依赖于 ADB 工具来进行通信管理。确保 USB 调试模式已经打开，并且计算机能够识别该设备即可正常工作。以下是典型的 Desired Capabilities 示例： - `platformName`: 设置为 "Android" - `deviceName`: 描述任意有效值；通常情况下不需要精确匹配物理硬件的名字 - `udid`: 对应于所连结的真实装置编号（可选） - `appPackage` 和 `appActivity`: 分别指明待测 APK 的包名及其入口 Activity 名称 - `noReset`: 控制每次运行前是否重置环境状态，默认 false 表示保留数据 ```json { "platformName": "Android", "deviceName": "emulator-5554", // or any valid value like 'real_device' "udid": "<optional real device serial number>", "appPackage": "com.example.package.name", "appActivity": ".MainActivity", "noReset": false } ``` 一旦完成了上述准备工作之后，就可以利用 WebDriver API 发送命令给 Appium Server ，从而实现对移动应用程序的各种交互行为执行自动化脚本了[^1]。