Running Tests · Appium 官方文檔

## 運行測試 ### 準備你要測試的應用（iOS）被測應用要在模擬器上運行，就必須針對該模擬器進行專門的編譯，例如在 Xcode 項目下執行如下命令（你可以使用 `xcodebuild -showsdks` 查看可用的 SDK 列表）： > xcodebuild -sdk iphonesimulator6.0 這會在 Xcode 項目下創建一個 `build/Release-iphonesimulator` 目錄，目錄中包含 `.app` 包。你將使用這個包和 Appium server 溝通。如果需要，可以將應用程序目錄壓縮到 `.zip` 文件中！Appium 會幫你解壓（如果你使用的不是局部的 Appium）。 ### 準備你要測試的應用（Android）什么都不用做就可以使用 Appium 運行你的 .apk。如果你想，可以壓縮它。 ### 準備你要測試的應用（Windows）什么都不用做就可以運行你的測試。 ### 在 Appium 上運行你的測試應用（IOS）想知道當前要做什么，最好的方法就是是查看示例代碼： [Node.js](https://github.com/appium/appium/tree/master/sample-code/javascript-webdriverio) | [Python](https://github.com/appium/appium/tree/master/sample-code/python) | [PHP](https://github.com/appium/appium/tree/master/sample-code/php) | [Ruby](https://github.com/appium/appium/tree/master/sample-code/ruby) | [Java](https://github.com/appium/appium/tree/master/sample-code/java) 基本上，首先確認 Appium 正在運行： node . 然后編寫你的 WebDriver 測試腳本, 用如下的預期能力（Desired capabilities）: ```javascript // javascript { platformName: 'iOS', platformVersion: '7.1', deviceName: 'iPhone Simulator', app: myApp } ``` ```python # python { 'platformName': 'iOS', 'platformVersion': '7.1', 'deviceName': 'iPhone Simulator', 'app': myApp } ``` ```php // php public static $browsers = array( array( 'desiredCapabilities' => array( 'platformName' => 'iOS', 'platformVersion' => '7.1', 'deviceName' => 'iPhone Simulator', 'app' => $myApp ) ) ); ``` ```java // java DesiredCapabilities capabilities = new DesiredCapabilities(); capabilities.setCapability(MobileCapabilityType.PLATFORM_NAME, "iOS"); capabilities.setCapability(MobileCapabilityType.PLATFORM_VERSION, "7.1"); capabilities.setCapability(MobileCapabilityType.DEVICE_NAME, "iPhone Simulator"); capabilities.setCapability(MobileCapabilityType.APP, myApp); ``` 在這組功能（capabilities）中，`myApp` 必須是以下的任意一個： * 基于對應模擬器編譯的 .app 目錄或者 zip 文件的絕對路徑 * app 應用包的 zip 文件的 URL * 基于 Appium 安裝根目錄的示例應用程序的相對路徑用你選擇的 WebDriver 庫，將遠程會話（session）設置為使用以上功能，并連接到服務器所監聽的 localhost 4723 （或任何在啟動 Appium 時指定的主機和端口）。現在你應該全都設置好了！ ### 使用 Appium 測試你的應用（Android）首先,確保你有且只有一個 Android 模擬器或設備連接。例如，如果你運行 `adb devices`，你應該只看到一個設備連接。Appium 將使用這個設備進行測試。當然，要連接上一個設備，你需要配置一個 Android AVD。如果你的系統變量 `PATH` 里有 Android SDK 的工具，你可以簡單運行如下命令： emulator -avd <MyAvdName> 等待 android 模擬器完成啟動。有時，由于各種原因，`adb` 會卡住。如果它沒有顯示任何已連接的設備或其他故障，你可以重新啟動它: adb kill-server && adb devices 現在，確認 Appium 已在運行： node . 有幾種方法可以啟動一個 Appium 應用程序（工作原理與使用 adb 啟動應用程序完全相同）: - 僅用 apk 或 zip，將啟動默認 activity（'app' capability） - apk + activity （'app' + 'appActivity' capabilities） - apk + activity + intent （'app' + 'appActivity' + 'appIntent' capabilities） - ... Activity 可以通過以下方式指定： - 絕對路徑（例如 appActivity: 'com.helloworld.SayHello'）。 - 相對于應用包名（例如 appPackage: 'com.helloworld', appActivity='.SayHello'）如果指定了 `appWaitPackage` 和 `appWaitActivity`，Appium 將自動等待，直到這些 Activity 啟動。你可以指定等待多個Activity： - appActivity: 'com.splash.SplashScreen' - appPackage: 'com.splash' appActivity: '.SplashScreen' - appPackage: 'com.splash' appActivity: '.SplashScreen,.LandingPage,com.why.GoThere' 如果你不確定你的 apk 中配置了哪些 Activity，你可以在下列方法中選一個進行查看： - Mac / Linux：'adb shell dumpsys window windows | grep mFocusedApp' - 在 Ruby 控制臺中：'adb shell dumpsys window windows\`.each_line.grep(/mFocusedApp/).first.strip' - 在 Windows 終端運行 'adb shell dumpsys window windows' 然后找到 mFocusedApp 然后編寫 WebDriver 測試腳本，使用下面的預期功能： ```javascript // javascript { platformName: 'Android', platformVersion: '4.4', deviceName: 'Android Emulator', app: myApp } ``` ```python # python { 'platformName': 'Android', 'platformVersion': '4.4', 'deviceName': 'Android Emulator', 'app': myApp } ``` ```php // php public static $browsers = array( array( 'desiredCapabilities' => array( 'platformName' => 'Android', 'platformVersion' => '4.4', 'deviceName' => 'Android Emulator', 'app' => $myApp ) ) ); ``` ```java // java DesiredCapabilities capabilities = new DesiredCapabilities(); capabilities.setCapability(MobileCapabilityType.PLATFORM_NAME, "Android"); capabilities.setCapability(MobileCapabilityType.PLATFORM_VERSION, "4.4"); capabilities.setCapability(MobileCapabilityType.DEVICE_NAME, "Android Emulator"); capabilities.setCapability(MobileCapabilityType.APP, myApp); ``` 在這組功能（capabilities）中，`myApp` 必須是以下任意一個： * apk 或者 zip 文件的本地絕對路徑 * 包含 apk 的 zip 文件的 url 鏈接 * 示例應用相對于 appium 安裝根目錄的路徑用你選擇的 WebDriver 庫，將遠程會話（session）設置為使用以上功能，并連接到服務器所監聽的 localhost 4723 （或任何在啟動 Appium 時指定的主機和端口）。現在你應該全都設置好了！ ### 使用 Appium 運行你的測試程序（Android 設備 < 4.3，和混合測試） Android 設備在 4.3 版本（API 級別 17）之前沒有安裝谷歌的 [UiAutomator 框架](http://developer.android.com/tools/testing-support-library/index.html#UIAutomator)。UiAutomator 是 Appium 用于在設備上執行自動化的部分。對于早期的設備或混合（基于 webview）應用程序，Appium 與另一個名為 [Selendroid](http://selendroid.io/) 自動化后端進行綁定。要使用 Selendroid，只需稍微改動上述提到的預期功能（Desired capabilities），添加 `automationName` 并指定 Selendroid 為自動化后端。通常，你還需要在 activity 名前加一個 `.`（例如，對于 `appActivity` 這個功能需要使用 `.MainActivity` 替代 `MainActivity`)。 ```javascript // javascript { automationName: 'Selendroid', platformName: 'Android', platformVersion: '2.3', deviceName: 'Android Emulator', app: myApp, appPackage: 'com.mycompany.package', appActivity: '.MainActivity' } ``` ```python # python { 'automationName': 'Selendroid', 'platformName': 'Android', 'platformVersion': '2.3', 'deviceName': 'Android Emulator', 'app': myApp, 'appPackage': 'com.mycompany.package', 'appActivity': '.MainActivity' } ``` ```php // php public static $browsers = array( array( 'desiredCapabilities' => array( 'automationName' => 'Selendroid', 'platformName' => 'Android', 'platformVersion' => '2.3', 'deviceName' => 'Android Emulator', 'app' => $myApp, 'appPackage' => 'com.mycompany.package', 'appActivity'=> '.MainActivity' ) ) ); ``` ```java // java DesiredCapabilities capabilities = new DesiredCapabilities(); capabilities.setCapability(MobileCapabilityType.AUTOMATION_NAME, "Selendroid"); capabilities.setCapability(MobileCapabilityType.PLATFORM_NAME, "Android"); capabilities.setCapability(MobileCapabilityType.PLATFORM_VERSION, "2.3"); capabilities.setCapability(MobileCapabilityType.DEVICE_NAME, "Android Emulator"); capabilities.setCapability(MobileCapabilityType.APP, myApp); capabilities.setCapability(MobileCapabilityType.APP_PACKAGE: "com.mycompany.package"); capabilities.setCapability(MobileCapabilityType.APP_ACTIVITY: ".MainActivity"); ``` 現在 Appium 將啟動一個 Selendroid 測試會話，而不是默認的測試會話。使用 Selendroid 的缺點之一是，它的某些 API 和 Appium 有顯著差異。因此，我們建議你在為舊設備或混合應用程序編寫腳本前，徹讀 [Selendroid文檔](http://selendroid.io/native.html) ### 使用 Appium 運行你的測試程序（Windows）只需確保 Appium 正在監聽，并使用你選擇的測試運行器運行您的測試。查看我們的 [示例](https://github.com/Microsoft/WinAppDriver/tree/master/Samples) 以獲取細節。 --- EOF. 本文由 [testly](https://github.com/testly) 翻譯，由 [lihuazhang](https://github.com/lihuazhang) 校驗。翻譯：@[Pandorym](https://github.com/Pandorym) Last english version: 04f65435618931f2d40977eec2f400d0bbec27d7, Jun 15, 2018