Android之UI Automator框架源码分析（第九篇：UiDevice获取UiAutomation对象的过程分析）

news2024/12/22 18:04:54

前言

通过UiDevice的构造方法，UiDevice对象持有的几个对象一部分是在构造方法中创建的（初始化），它持有的每个对象都是分析的重点

备注：当前对象持有的对象，它的位置一般在实例变量创建时或者构造方法中，以下是UiDevice构造方法中正在做初始化对象的动作！

UiDevice(Instrumentation instrumentation) {
    mInstrumentation = instrumentation;
    mQueryController = new QueryController(instrumentation);
    mInteractionController = new InteractionController(instrumentation);

    // Enable multi-window support for API level 21 and up
    if (UiDevice.API_LEVEL_ACTUAL >= Build.VERSION_CODES.LOLLIPOP) {
        // Subscribe to window information
        AccessibilityServiceInfo info = getUiAutomation().getServiceInfo();
        info.flags |= AccessibilityServiceInfo.FLAG_RETRIEVE_INTERACTIVE_WINDOWS;
        getUiAutomation().setServiceInfo(info);
    }
}

UiAutomation对象很重要

 AccessibilityServiceInfo info = getUiAutomation().getServiceInfo(); info.flags |= AccessibilityServiceInfo.FLAG_RETRIEVE_INTERACTIVE_WINDOWS; getUiAutomation().setServiceInfo(info);

我们看到getUiAutomation（）方法的调用

getUiAutomatrion（）方法分析

位于UiDevice类中的getUiAutomation（）方法，返回值是UiAutomation对象

    UiAutomation getUiAutomation() {
        return getUiAutomation(getInstrumentation());
    }

1、先调用一个getInstrumentation（）方法

该方法返回的Instrumentation对象会再被传入到接受一个参数的getUiAutomation重载方法中

2、再次调用重载的getUiAutomation（）方法

3、此重载方法的返回值将作为当前getUiAutomation（）方法的返回值

我们先学习一下Instrumentation对象是如何获取到的，即getInstrumentation()的调用！

getInstrumentation（）方法分析

位于UiDevice中的getInstrumentation方法，返回值为Instrumentation对象

    Instrumentation getInstrumentation() {
        return mInstrumentation;
    }

通过该方法就可以得到UiDevice对象持有的Instrumentation对象mInstrumentation，方法内部通过return语句返回mInstrumentation，说明Instrumentation对象已经初始化结束，这里只是返回

Instrumentation对象在哪初始化的

通过代码得知，是创建UiDevice的时候，传入的一个Instrumentation对象

创建UiDevice对象

public static final UiDevice mDevice = UiDevice.getInstance(getInstrumentation());

这时候传入的其实是InstrumentationRegistry下的静态方法getInstrumentation（）返回的Instrumenation对象。

public static Instrumentation getInstrumentation() {
  Instrumentation instance = instrumentationRef.get();
  if (null == instance) {
    throw new IllegalStateException(
        "No instrumentation registered! " + "Must run under a registering instrumentation.");
  }
  return instance;
}

一个原子对象负责持有Instrumentation对象

找到了原子对象赋值的地方

我们需要找到registerInstance这个静态方法在哪里被调用即可

在MonitoringInstrumentation对象中的oncreate（）方法中调用了

MonitoringInstrumentation对象，从名字上，果然是Instrumentation的子类，它是具体的对象，代码追踪到这里，只要再找到这个oncreate（）方法在哪里调用即可!

很快找到了，追踪了整个Unit框架了都要

AndroidJUnitRunner是MonitoringInstrumentation的子类，看来AndroidJUnitRunner也是个Instrumentation！！

AndroidUnitRunner作为入口类

我们是在am instrument 指定的该类，这一切明白了，这个用到的Instrumentation对象，其实就是AndroidUnitRunner对象

$ADB shell am instrument -w -e class com.xxx.camauto.Common#unlockScreen com.xiaomi.camauto.test/androidx.test.runner.AndroidJUnitRunner

重载的静态方法getUiAutomation（Instrumentation）方法分析

位于UiDevice类中的静态方法getUiAutomation（），它接受一个Instrumentation对象，最后会返回一个UiAutomation对象

    static UiAutomation getUiAutomation(final Instrumentation instrumentation) {
        int flags = Configurator.getInstance().getUiAutomationFlags();
        if (UiDevice.API_LEVEL_ACTUAL > Build.VERSION_CODES.M) {
            return instrumentation.getUiAutomation(flags);
        } else {
            // Custom flags not supported prior to N.
            if (flags != Configurator.DEFAULT_UIAUTOMATION_FLAGS) {
                Log.w(LOG_TAG, "UiAutomation flags not supported prior to N - ignoring.");
            }
            return instrumentation.getUiAutomation();
        }
    }

1、获取配置对象中的UiAutomation的标志位

首先通过Configurator对象的getUiAutomationFlags方法，得到一个int值，该值的初始值是0，然后再将该int值赋值给局部变量flags存储，flags存储的是关于UiAutomatrion对象的标志位（说明：Configurator对象存储着UI Automator测试框架用到的各种配置信息，此时局部变量flags存储的值正是从Configurator对象中获得，后面单独文章总结）

2、系统版本大于API 23获取UiAutomation对象的方式

接着做API版本判断，UiDevice类持有的API_LEVEL_ACTUAL代表API版本，根据API版本执行不同的逻辑

当API版本大于M（API==23）时，使用的传入的Instrumentation对象的接受一个整型参数的getUiAutomation（）方法，此时会将局部变量flags传入进去，getUiAutomation（int）方法返回的是一个UiAutomation对象（看这个flags决定了获取对象的不同）

3、系统版本小于等于API 23获取UiAutomation对象的方式

当API版本小于等于M（API==23）时，使用的是传入的Instrumentation对象的无参数的getUiAutomation（）方法，该方法也会返回一个UiAutomation对象

说明：最终getUiAutomation（）方法中依赖Instrumentaion对象获取到的UiAutomation对象

找到具体的UiAutomation对象

从前面的步骤得知这个Instumentation对象其实是AndroidJUnitRunner，而调用的getUiAutomation（）获取到的UiAutomation（）对象，由于java是单继承，我们只要沿着AndroidJunitRunner的继承树，找到getUiAutomation（）方法，就能知道具体的UiAutomation对象在哪里创建的！！

1、先从AndroidJunitRunner中找getUiAutomation（）方法，发现该类没有该方法