UIAutomator2 (Android) · Appium 官方文檔

## Android的UiAutomator2驅動 Appium對Android應用程序自動化的最大支持是通過`UiAutomator2`driver實現的。_(是Appium的新手? 請閱讀 [Appium drivers介紹](#TODO))_。這個驅動程序是利用Google的 [UiAutomator2](https://developer.android.com/training/testing/ui-automator.html) 技術來促進實現設備或模擬器上的自動化。在[appium-uiautomator2-driver](https://github.com/appium/appium-uiautomator2-driver) 收購了UiAutomator2 driver后，它開始發展。舊版的Android drivers包括： * [UiAutomator的驅動](../../drivers/android-uiautomator.md) ### 要求和支持除了Appium的一般要求外，還需要具備以下條件: * Java 8需要被正確安裝和配置在你的平臺上 * 具備能運行Android SDK的Mac, Windows, 或者Linux OS 此外，UiAutomator2 driver不支持低于5.0的Android版本（Lollipop，API級別21）。如果要自動執行這一類的版本，請考慮使用 [UiAutomator驅動](../../drivers/android-uiautomator.md)。 ### 使用使用UiAutomator driver啟動會話的方法是在[新的會話請求](#TODO)的[capability](#TODO)參數設置中包括屬性 `automationName` ，對應的值為`UiAutomator2`。當然了，capabilities的參數設置中中還必須至少包含有正確的`platformName`（= `Android`）`platformVersion`，`deviceName`和`app` 這些參數信息。強烈建議還設置`appPackage`和`appActivity` 功能，以使Appium確切知道應為應用程序啟動哪個程序包和活動。否則，Appium會嘗試從應用清單中自動確定這些內容。 ### Capabilities UiAutomator2 driver支持許多標準的 [Appium capabilities](../../writing-running-appium/caps.md)，但也有一組額外的功能，這些功能可調節driver的行為。這些可以在前面提到的文檔的[Android部分](https://github.com/testerhome/appium/blob/master../../writing-running-appium/caps.md#android-only)中找到。對于web端的測試，要去自動化驅動Chrome而不是應用程序，則需要將`app` 功能參數保留為空，并且將`browserName`功能參數設置為 `Chrome`。請注意，您有責任確保Chrome是在模擬器/設備上，并且它的版本與Chromedriver兼容。 ### Commands指令需要查看Appium支持的各種命令，特別是關于命令如何映射到UiAutomator2 driver行為的信息，請參閱[API參考](https://github.com/testerhome/appium/blob/master../../drivers/android-uiautomator2.md#TODO)。 ### 基本設置 1. 確保您已安裝和配置了Appium的常規依賴項（例如Node＆NPM）。 1. 確保已安裝Java（JDK，而不僅僅是JRE），并且Java二進制文件已添加到您的路徑中。對于Mac / Linux和Windows，此步驟的說明有所不同。請查閱特定于平臺的文檔，因為這是一項常見的任務。如何更改Windows的路徑的一個例子是 [在這里](https://www.java.com/en/download/help/path.xml)。 1. 確保`JAVA_HOME`環境變量也設置為JDK路徑。例如，對于Mac / Linux（此路徑的具體情況因系統而異），請將其放入您的登錄腳本中： ``` export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk1.8.0_111.jdk/Contents/Home" ``` 在Windows上，這可以通過使用與設置上面的PATH相同的策略在控制面板中設置環境變量來完成。 [Android Studio](https://developer.android.com/studio/index.html)也包含有JDK路徑，比如`/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home`（Mac）。您也可以指定路徑。 1. 安裝[Android SDK](http://developer.android.com/sdk/index.html)。現在支持此操作的方法是使用[Android Studio](https://developer.android.com/studio/index.html)。使用提供的GUI將Android SDK安裝到您選擇的路徑。 1. 設置`ANDROID_HOME`環境變量以匹配此路徑。例如，如果您將SDK安裝到`/usr/local/adt`，則通常在`sdk`其中包含SDK文件的文件夾中。在這種情況下，在Mac和Linux，下面一行添加到您的登錄腳本（例如， `~/.bashrc`，`~/.bash_profile`等...）：在Windows上，按照與之前相同的步驟在控制面板中設置環境變量。 1. 使用SDK管理器，確保已安裝要自動化的Android API級別的SDK（例如24）。 1. 在Windows上，請確保始終在管理員模式下運行Appium。至此，您的基本系統設置完成。根據您要自動化仿真器還是真實設備來執行以下步驟。另外，在運行測試時，您將需要應用程序的APK（最好是在Debug模式下構建）的路徑或URL作為capability屬性中`app`參數的值。 ### 模擬器設置為了在模擬器上運行測試，請使用包含了Android Studio或SDK的AVD Manager。使用此工具，創建符合您需求的模擬器。啟動模擬器后，Appium將自動找到并用于測試。否則，如果您使用`avd`與模擬器名稱匹配的值指定功能，則Appium將嘗試為您啟動模擬器。模擬器的其他提示： * 盡管有其自身的局限性，但存在適用于Android的硬件加速模擬器。這個可以從英特爾網站或通過Android SDK Manager安裝。有關更多信息，請轉到 [此處](https://github.com/intel/haxm)。 * 如果要運行任何Appium測試，或使用任何電源命令，請確保`hw.battery=yes`在AVD `config.ini`中進行設置。（從Android 5.0開始，這是默認設置。） ### 真實設備設置對于Android自動化，除了以下簡單要求之外，不需要其他設置即可在真實設備上進行測試： * 確保為設備打開了[開發者模式](https://developer.android.com/studio/debug/dev-options.html)。 * 確保設備通過USB連接到Appium主機，并且可以被[ADB](https://developer.android.com/studio/command-line/adb.html)找到（運行`adb devices`以確保）。 * 確保禁用設置中的“驗證應用程序”，以允許Appium的助手應用程序運行而無需手動干預。（對于某些特定命令，設備可能需要root，盡管這不是必須的。）