Uiautomator项目搭建与实现原理

hogwarts · 2022 年5 月 18 日 08:55

Uiautomator是Android原生测试框架，可以用于白盒接口测试也可以用于UI自动化测试，Uiautomator分1.0版本与2.0版本，它们都是基于UiAutomation的测试框架，都是通过UiAutomation的接口操作设备， 1.0权限更高，运行更灵活，2.0针对app定制化更高，在同进程内运行，可以获取被测app的运行数据，具体选用哪个框架还是根据业务场景灵活选择。

AndroidStudio基于ant编译Uiautomator1.0 jar包

Uiautomator1.0是基于Java的测试框架，它通过junit和Uiautomator框架执行Java测试用例，但是自从Uiautomator2.0发布以后，官方不再维护Uiautomator1.0的构建。目前无法直接通过Android Studio创建Uiautomator1.0测试项目，本节介绍通过AndroidStudio工具构建Uiautomator1.0 jar文件。

构建项目工程

1.AndroidStudio新构建一普通项目-导入依赖包

2.创建测试类

SDK支持ant编译配置

Android最新SDK已去除ant编译工具支持，如果需要通过ant构建uiautomator1.0测试包那么就需要下载以前的sdk-tools，并将该文件复制到本机sdk中

各平台下载地址：

https://dl.google.com/android/repository/tools_r25.2.5-linux.zip

https://dl.google.com/android/repository/tools_r25.2.5-macosx.zip

https://dl.google.com/android/repository/tools_r25.2.5-linux.zip

根据系统版本下载对应的sdkTools，下载后解压获取tools文件夹，并将tools/文件夹下所有内容复制到本机/sdk/tools/路径下。

根据项目生成build.xml

1.打开控制台，切换到/sdk/tools/路径下-执行命令

2.打开项目，在项目路径下已生成 [build.xml]文件，打开[build.xml]文件，找到如下代码，并注释。

AndroidStudio 导入ant任务，并构建

1.打开当前module的Gradle文件，写入如下代码，然后构建一下gradle，在moduleName->Tasks->other下会列出ant任务

2.点击[ant-build]即可执行构建任务，等待执行结束后在[module/bin]路径下会生成对应的Apk文件。

如果构建过程中报 check-env 错误，是因为sdk-tools 不支持ant编译导致的，需要同步一下sdk-tools

执行测试用例

Uiautomator1.0 的便捷构建

基于ant的Uiautomator1.0 jar包构建是比较麻烦的，并且sdk-tools必须要支持ant编译。那么jar包的组成部分是什么？

通过解压Uiautomator1.0 jar文件，发现jar包主要由.dex文件和META-INF构成，Android 应用apk文件内也包含着两个文件，所以是可以把Uiautomator1.0源码写在普通Android项目中，并用.apk文件替换.jar文件执行测试脚本。

jar包文件构成

apk文件构成

构建apk

执行下图Gradle任务，获取打包apk文件

任务执行完毕可以得到apk打包文件

执行脚本

Uiautomator1.0执行流程解析

下面通过Uiautomator 命令为入口了解Uiautomator1.0测试服务是如何运行的，Uiautomator进程是如何初始化的。

Uiautomator1.0 执行命令结构如下：

Uiautomator脚本源码则是一个shell脚本，通过 app_process命令加载类

com.android.commands.uiautomator.Launcher

Launcher作为uiautomator进程的入口，解析参数并调用RunTestCommand的run方法

RunTestCommand.run()方法将具体的执行业务递交给UiAutomatorTestRunner类的run方法执行

在UiAutomatorTestRunner的run方法中初始化执行参数，然后调用start方法中初始化UiAutomationShellWrapper并执行测试任务。UiAutomationShellWrapper的connect方法连接系统测试服务。

UiAutomationShellWrapper 类的connect方法初始化了UiAutomation对象，UiAutomation提供测试所需功能API。

到此uiautomator进程已经获取UiAutomation对象，可以通过UiAutomation对象获取屏幕元素信息、发送按键事件、滑动屏幕、点击屏幕等。以下代码展示部分重要API，无论是Uiautomator1.0还是Uiautomator2.0最终都是通过UiAutomation对象来执行测试动作的。