## iOS XCUITest 驱动
Appium 通过 `XCUITest` 驱动支持基本的 iOS 应用自动化。_(Appium 新手? 读一读 [介绍 Appium 驱动](#TODO))_。它在底层使用 [XCUITest](https://developer.apple.com/library/content/documentation/DeveloperTools/Conceptual/testing_with_xcode/chapters/09-ui_testing.html) 库以更好的自动化你的 App。 对 XCUITest 的使用是通过 [WebDriverAgent](https://github.com/facebook/webdriveragent) 服务间接完成的。
WebDriverAgent (也被叫做"WDA") 是 Facebook 管理的项目, Appium 核心团队对项目做了很大的贡献。 WDA是一个运行在 iOS 模拟器或设备上暴露 XCUITest API 的服务，兼容 WebDriver。Appium 的 XCUITest 驱动把 WDA 作为对 Appium 用户不透明的子进程控制， 代理发送给和接受自 WDA 的命令， 并且提供大量额外功能 (比如模拟器控制及其他方法)。
XCUITest 驱动的开发在 [appium-xcuitest-driver](https://github.com/appium/appium-xcuitest-driver) 仓库进行。
### 依赖和支持
除了 Appium 通用依赖以外的要求：
* 苹果的 XCUITest 库只能运行在 iOS 9.3 及以上的版本的模拟器或设备上。
* 安装 macOS 10.11 或 10.12 的 Mac 电脑。
* Xcode 7 及以上的版本。
* Appium 在 1.6 及以上的版本才提供 XCUITest 驱动。
* 需要额外的系统库驱动才能正常工作(查看下面的安装分节)。
### 从 UIAutomation 驱动迁移
如果需要从 Appium 的旧 [UIAutomation-based 驱动](../drivers/ios-uiautomation.md) 迁移到 XCUITest 驱动，可以查阅[迁移指南](../advanced-concepts/migrating-to-xcuitest.md)。
### 用法
使用 XCUITest 驱动建立会话需要在[新会话请求](#TODO)里包含值为 `XCUITest` 的 `automationName` [capability](#TODO)。当然最少也要包含恰当的`platformName`，`platformVersion`，`deviceName`，和 `app` capabilities。
iPhone 或 iPad 的 `platformName` 应该是 `iOS`。tvOS 设备的 `platformName` 应该是 `tvOS`。
- iOS
```json
{
"automationName": "XCUITest",
"platformName": "iOS",
"platformVersion": "12.2",
"deviceName": "iPhone 8",
...
}
```
- tvOS
```json
{
"automationName": "XCUITest",
"platformName": "tvOS",
"platformVersion": "12.2",
"deviceName": "Apple TV",
...
}
```
### Capabilities
XCUITest 驱动除了支持许多标准 [Appium capabilities](../writing-running-appium/caps.md)，还有一组额外的 capabilities 调整驱动的行为。可以在 [appium-xcuitest-driver README](https://github.com/appium/appium-xcuitest-driver#desired-capabilities) 查看。
如果要自动化 Safari 而不是自有的应用，`app` capability 留空，设置 `browserName` capability 为 `Safari`。
### 命令
查看 Appium 支持的各种命令，特别是关于命令如何映射到 XCUITest 驱动行为的信息，请参阅 [API 参考](#TODO)。
### 基本安装
_(我们建议使用 [Homebrew](https://brew.sh) 安装系统依赖)_
1. 确保已经安装配置了 Appium 通用依赖(比如 Node & NPM)。
2. 安装 [Carthage](https://github.com/Carthage/Carthage):
```bash
brew install carthage
```
如果你不需要在真机上自动运行就安好了！在模拟器上自动化应用，`app` capability 应该设为指向你的为模拟器构建的 `.app` 或 `.app.zip` 文件的绝对路径或链接。
### 真机安装
因为苹果对真机上运行的应用的严格限制，在真机上运行 XCUITest 自动化要复杂得多。请看 [XCUITest 真机安装文档](ios-xcuitest-real-devices.md)中的介绍。
安装完成后，通过使用以下 desired capabilitie 和真机建立会话：
* `app` 或 `bundleId` - 指定应用 (已签名 `.ipa` 文件的本地路径或链接)，如果应用已经安装，Appium 只要有应用的 bundle identifier 就可以启动它。
* `udid` - 指定运行测试的真机 id。如果只有一台设备也可以设为 `auto`，Appium 会确定设备和 id。
### 可选安装
* 安装 idb 可以更好的处理各种模拟器操作，比如生物识别，设置定位和窗口焦点。
* 根据 https://github.com/appium/appium-idb#installation 安装必要的库 (Appium 1.14.0 以后)。
* 安装 [AppleSimulatorUtils](https://github.com/wix/AppleSimulatorUtils) 后可以使用 [permissions capability](https://github.com/appium/appium-xcuitest-driver#desired-capabilities)。
### 运行测试产生的文件
在 iOS 上测试产生的文件有时会占用很多空间，包括日志、临时文件和 Xcode 运行的派生数据。可以在以下路径删除它们：
```
$HOME/Library/Logs/CoreSimulator/*
$HOME/Library/Developer/Xcode/DerivedData/*
```
### 配置键盘
在 Appium 1.14.0 之后，为了让测试运行的更稳定 Appium 会重置键盘的设置为默认项。你可以通过设置 API 修改：
- 在 _键盘_ 关闭`自动改正`
- 在 _键盘_ 关闭`输入预测`
- 标记键盘教程为完全版
- (仅模拟器) 打开软键盘
- 关于TesterHome和MTSC
- 关于Appium
- 简介
- Appium 客户端
- 入门指南
- 已支持的平台
- API 文档
- Appium驱动
- XCUITest (iOS)
- XCUITest Real Devices (iOS)
- UIAutomation (iOS)
- UIAutomation Safari Launcher (iOS)
- UIAutomator (Android)
- UIAutomator2 (Android)
- Espresso (Android)
- Windows
- Mac
- Appium命令
- Status
- Execute Mobile Command
- Session
- Create
- End
- Get Session Capabilities
- Go Back
- Screenshot
- Source
- Timeouts
- Timeouts
- Implicit Wait
- Async Script
- Orientation
- Get Orientation
- Set Orientation
- Geolocation
- Get Geolocation
- Set Geolocation
- Logs
- Get Log Types
- Get Logs
- Events
- Log event
- Get events
- Settings
- Update Settings
- Get Device Settings
- Settings
- Update Settings
- Get Device Settings
- Execute Driver Script
- Device
- Activity
- Start Activity
- Current Activity
- Current Package
- App
- Install App
- Is App Installed
- Launch App
- Background App
- Close App
- Reset App
- Remove App
- Activate App
- Terminate App
- Get App State
- Get App Strings
- End Test Coverage
- Clipboard
- Get Clipboard
- Set Clipboard
- Emulator
- Power AC
- Power Capacity
- Files
- Push File
- Pull File
- Pull Folder
- Interactions
- Shake
- Lock
- Unlock
- Is Locked
- Rotate
- Keys
- Press keycode
- Long press keycode
- Hide Keyboard
- Is Keyboard Shown
- Network
- Toggle Airplane Mode
- Toggle Data
- Toggle WiFi
- Toggle Location Services
- Send SMS
- GSM Call
- GSM Signal
- GSM Voice
- Network Speed
- Performance Data
- Get Performance Data
- Performance Data Types
- Screen Recording
- Start Screen Recording
- Stop Screen Recording
- Simulator
- Perform Touch ID
- Toggle Touch ID Enrollment
- System
- Open Notifications
- System Bars
- System Time
- Display density
- Authentication
- Finger Print
- Element
- Find Element
- Find Elements
- Actions
- Click
- Send Keys
- Clear
- Attributes
- Text
- Name
- Attribute
- Selected
- Enabled
- Displayed
- Location
- Size
- Rect
- CSS Property
- Location in View
- Other
- Submit
- Active Element
- Equals Element
- Context
- Get Context
- Get All Contexts
- Set Context
- Interactions
- Mouse
- Move To
- Click
- Double Click
- Button Down
- Button Up
- Touch
- Single Tap
- Double Tap
- Move
- Touch Down
- Touch Up
- Long Press
- Scroll
- Flick
- Multi Touch Perform
- Touch Perform
- W3C Actions
- Web
- Window
- Set Window
- Close Window
- Get Handle
- Get Handles
- Get Title
- Get Window Size
- Set Window Size
- Get Window Position
- Set Window Position
- Maximize Window
- Navigation
- Go to URL
- Get URL
- Back
- Forward
- Refresh
- Storage
- Get All Cookies
- Set Cookie
- Delete Cookie
- Delete All Cookies
- Frame
- Switch to Frame
- Switch to Parent Frame
- Execute Async
- Execute
- 编写 & 运行Appium脚本
- Running Tests
- Desired Capabilities
- The --default-capabilities flag
- Finding Elements
- Touch Actions
- CLI Arguments
- Server Security
- Web/Web Views
- Mobile Web Testing
- Automating Hybrid Apps
- Using ios-webkit-debug-proxy
- Using Chromedriver
- Image Comparison
- iOS
- Low-Level Insights on iOS Input Events
- XCUITest Mobile Gestures
- XCUITest Mobile App Management
- iOS Pasteboard Guide
- iOS Predicate Guide
- iOS Touch ID Guide
- iOS Install Certificate
- tvOS support
- Pushing/Pulling files
- Audio Capture
- Android
- Low-Level Insights on Android Input Events
- UiSelector Guide
- Espresso Datamatcher Guide
- Android Code Coverage Guide
- Activities Startup Troubleshooting Guide
- How To Execute Shell Commands On The Remote Device
- Android Device Screen Streaming
- How To Emulate IME Actions Generation
- How To Test Android App Bundle
- Other
- Reset Strategies
- Network Connection Guide
- Using Unicode with Appium
- Troubleshooting
- Tutorial
- Swipe Tutorial
- Screen
- Element
- Partial screen
- Simple
- Multiple scroll views
- Add scroll layout
- Tricks and Tips
- Screen
- Element
- Element search
- Fast
- Slow
- Guide
- 进阶概念
- 定位图像中的元素
- 使用定位元素的插件
- 迁移到 XCUITest
- 在 Appium 中使用 Selenium Grid
- Appium Logs Filtering
- 跨域 iframes
- 使用自定义 WDA 服务器
- 使用不同版本的 Xcode 运行
- The Event Timings API
- 并行测试的设置
- The Settings API
- Memory Collection
- 向Appium项目做贡献
- 从源代码运行 Appium
- 开发者概述
- 标准开发命令
- Appium 风格指南
- 如何编写文档
- Appium 包结构
- 鸣谢