UIAutomator2.0 出來有一段時間了。

我們就看一句話

Most importantly, UIAutomator is now based on Android Instrumentation

Instrumentation 終於把 UIAutomator 納入了他的麾下。

UIAutomator2.0 出來之後，投入使用的似乎不多，官方的文件也不多，而且還有錯。 不過各個測試框架也在積極擁抱變化，比如 Appium，Selendroid。最快的極客學院也推出了 UIAutomator2.0 的教程。當然我們 TesterHome 也有同學上了一把，比如在 Android studio 上運用 UI Automator 執行自動化測試

。新東西出來了，不代表舊事物就不能用了。之前的 UIAutomator 一樣可以跑的很歡，守舊的同學可以繼續。

事實上，Google 提供的 Android Testing Support Library 變化的挺多的，比如全面擁抱 Junit 4.0，力薦使用 AndroidJUnitRunner，然後使用 Android Studio IDE 等等。反正不僅在開發端，在測試端，Google 也在做一些標準和統一，然後讓我們忘記之前的 monkeyrunner， instruments，只剩下：

• AndroidJUnitRunner: JUnit 4-compatible test runner for Android

• Espresso: UI testing framework; suitable for functional UI testing within an app
• UI Automator: UI testing framework; suitable for cross-app functional UI testing across system and installed apps

廢話時間結束。

如何寫一個 UIAutomator2.0 的工程？

在這之前，我是這樣寫 UIAutomator 的， 參見如何使用和除錯 android UIAutomator ？。我記性不好，就算現在寫，也會翻翻自己的文章。我試著也使用 maven 來配置，不過失敗告終。因為在 maven 庫裡面，找不到 com.android.support.test.*

，因為貌似所有的測試依賴都移到這裡來了。而在你電腦上，它藏在 android-sdk/extras/android/m2repository 下面，感覺上它也可以成為你 local maven 庫中的一個，不過沒時間研究。關於安裝Android Maven 本地依賴庫可以幫你開拓下思維，但是然並軟。所以老老實實使用 gradle 吧。

建立一個 android 工程

對於 Instrumentation 大家應該都熟知，如何寫一個 Instrumentation 工程，百度一搜一大把，大家模仿網上教程的時候用點心，別抄成個二百五。UIAutomator2.0 是基於 Instrumentation，所以基本上，和 Instrumentation 一樣，它也有一個測試應用的概念。我們開啟 AS，建立一個空應用，比如我的：

提示：Gradle 載入可能有點慢，自備 vpn 會來的快一點。

新增依賴和測試程式碼

1. 先在 build.grade 裡面新增依賴。

   apply plugin: 'com.android.application'
   
   android {
       compileSdkVersion 23
       buildToolsVersion "23.0.1"
   
       defaultConfig {
           applicationId "lihuazhang.testerhome.com.uiautomator2"
           minSdkVersion 19
           targetSdkVersion 23
           versionCode 1
           versionName "1.0"
           testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" # 這是我新增的
       }
       buildTypes {
           release {
               minifyEnabled false
               proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
           }
       }
   }
   
   dependencies {
       compile fileTree(dir: 'libs', include: ['*.jar'])
       compile 'com.android.support:appcompat-v7:23.1.0'
   
       # 這以下是我新增的
       androidTestCompile 'com.android.support:support-annotations:23.1.0'
       androidTestCompile 'com.android.support.test:runner:0.4'
       // Set this dependency to use JUnit 4 rules
       androidTestCompile 'com.android.support.test:rules:0.4'
       // Set this dependency to build and run Espresso tests
       androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.1'
       // Set this dependency to build and run UI Automator tests
       androidTestCompile 'com.android.support.test.uiautomator:uiautomator-v18:2.1.2'
   
   }

2.

在 androidTest 下面新增測試程式碼

package lihuazhang.testerhome.com.uiautomator2;

import android.content.Intent;
import android.content.pm.PackageManager;
import android.content.pm.ResolveInfo;
import android.support.test.InstrumentationRegistry;
import android.support.test.filters.SdkSuppress;
import android.support.test.runner.AndroidJUnit4;
import android.support.test.uiautomator.By;
import android.support.test.uiautomator.UiDevice;
import android.support.test.uiautomator.UiObject2;
import android.support.test.uiautomator.Until;

import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;

import static org.hamcrest.core.IsNull.notNullValue;
import static org.junit.Assert.assertEquals;
import static org.junit.Assert.assertThat;

/**
 * Created by lihuazhang on 15/11/8.
 */

@RunWith(AndroidJUnit4.class)
@SdkSuppress(minSdkVersion = 18)
public class CalculatorTest {
    private UiDevice mDevice;
    private static final int LAUNCH_TIMEOUT = 5000;
    private final String BASIC_SAMPLE_PACKAGE = "com.android.calculator2";

    @Before
    public void setUp() {
        // Initialize UiDevice instance
        mDevice = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation());

        // Start from the home screen
        mDevice.pressHome();

        // Wait for launcher
        final String launcherPackage = getLauncherPackageName();
        assertThat(launcherPackage, notNullValue());
        mDevice.wait(Until.hasObject(By.pkg(launcherPackage).depth(0)), LAUNCH_TIMEOUT);

}
    @Test
    public void checkPreconditions() {
        assertThat(mDevice, notNullValue());
    }

    @Test
    public void calculatorTest() {
        mDevice.findObject(By.desc("應用")).click();
        mDevice.wait(Until.hasObject(By.desc("計算器")), LAUNCH_TIMEOUT);
        mDevice.findObject(By.desc("計算器")).click();

        UiObject2 button7 = mDevice.wait(Until.findObject(By.res("com.android.calculator2", "digit_7")), 500);
        UiObject2 buttonX = mDevice.wait(Until.findObject(By.res("com.android.calculator2", "op_mul")), 500);
        UiObject2 button6 = mDevice.wait(Until.findObject(By.res("com.android.calculator2", "digit_6")), 500);
        UiObject2 buttonEqual = mDevice.wait(Until.findObject(By.res("com.android.calculator2", "eq")), 500);
        UiObject2 output = mDevice.wait(Until.findObject(By.res("com.android.calculator2", "result")), 500);

        button7.click();
        buttonX.click();
        button6.click();
        buttonEqual.click();
        assertEquals(output.getText(), "42");

    }

    private String getLauncherPackageName() {
        // Create launcher Intent
        final Intent intent = new Intent(Intent.ACTION_MAIN);
        intent.addCategory(Intent.CATEGORY_HOME);

        // Use PackageManager to get the launcher package name
        PackageManager pm = InstrumentationRegistry.getContext().getPackageManager();
        ResolveInfo resolveInfo = pm.resolveActivity(intent, PackageManager.MATCH_DEFAULT_ONLY);
        return resolveInfo.activityInfo.packageName;
    }
}

執行

執行很簡單，右擊測試檔案，點選執行即可。

如果在命令列的話，直接執行 ./gradlew cC

這個時候，我們開啟 adb shell：

那既然是 instrumentation，其實我們可以使用這樣的命令來執行。

➜  connected  adb shell am instrument -w lihuazhang.testerhome.com.uiautomator2.test/android.support.test.runner.AndroidJUnitRunner

lihuazhang.testerhome.com.uiautomator2.CalculatorTest:..

Time: 7.014

OK (2 tests)

我沒找到 uiautomator 1.0 的 nohup 形式，不知道其他人知道不。

報告

感謝 @carl 的提醒，漂亮的報告還是需要的。./gradlew cC 生成的報告在 Uiautomator2/app/build/reports/androidTests/connected 位置。

注意點

1. 不要繼承 InstrumentationTestCase

   This class is deprecated. It is no longer necessary to extend UiAutomatorTestCase. You can use getInstance(Instrumentation) from any test class as long as you have access to an Instrumentation instance.

   既然 UiAutomatorTestCase 都不用繼承了，更別提 InstrumentationTestCase 了。官方文件裡部分程式碼還在繼承 InstrumentationTestCase，當然不會引起啥錯誤，但是在命令列使用 gradle cC 的時候，測試用例不會被執行。
   更新下，@carl 說他是繼承了InstrumentationTestCase的，所以我又試驗了下。gradle cC 執行的時候報錯：
   

   

2. mDevice.wait(Until.findObject(By.res("com.android.calculator2", "digit_7")), 500); 必要的等待還是需要的。眾所周知，UI 自動化，如果不加入必要的等待策略，那麼很難保證測試用例的魯棒性。

3. 我在執行測試用例的時候，使用的 Genymotion 模擬器，但是發現了一些問題，比如這個計算器的用例在 Genymotion 中無法通過。

4. 遇到此類異常 UiAutomationService andr[email protected]52c58464already registered!，先看看裝置上是否有 uiautomator 在執行，有的話殺之。

5. 在程式碼裡的 System.out.println 是會輸出在 logcat 的日誌裡。此外執行資訊也會出現在 logcat 中。

轉自：https://testerhome.com/topics/3588