XCUITest (iOS) · Appium 官方文檔

## 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 修改： - 在 _鍵盤_ 關閉`自動改正` - 在 _鍵盤_ 關閉`輸入預測` - 標記鍵盤教程為完全版 - (僅模擬器) 打開軟鍵盤