Macaca 测试 Android 应用:UIAutomator

本文涉及的产品
阿里云百炼推荐规格 ADB PostgreSQL,4核16GB 100GB 1个月
简介:

在用macaca进行自动化测试,想试一下移动端测试,看到这篇文章,尝试一下。

前言

用 Macaca 可以快速、便捷地进行安卓 native 的自动化测试,用简洁的 js 语法,写下用例,然后执行 Macaca CLI 命令,就可以看到安卓的手机在按照你的指令自动进行用例操作。相关文章可参考:

使用 Macaca 测试 Android 应用

Macaca 对于 native 的自动化测试主要利用了 UIAutomator 。Macaca 是如何将这一 Java 写成的工具集成到自身的呢,本文将对此进行分析,让大家更加快乐、明白地使用 Macaca 。

自动化利器-UIAutomator

首先介绍下 UIAutomator。UIAutomator 是随 Android SDK 一起发布的一个测试框架,该测试框架提供了一系列 API,利用这些 API 我们可以编程和安卓 App 进行交互,例如:打开设置菜单,点击,滑动等。并且可以对设备进行物理指令操作,如:旋转设备,获取设备分辨率等。该测试框架的 jar 包可以在 SDK 的安装目录中找到:

$ANDROID_HOME/platforms/android-$version/uiautomator.jar

其中 $version 为安装的 SDK 版本号

下面是 UIAutomator 框架的类图:

Macaca 测试 Android 原理解析 - UIAutomator 篇

类图出处连接

图中,用来写测试用例的常用几个类简介:

  • UiObject 代表一个设备上可见的 ui 元素
  • UiScrollable 用来在可滚动 ui 容器中查找元素。因为有的元素要滚动后才可以看到
  • UiSelector 条件对象,和 UiObject 对象一起使用来根据条件查找元素
  • UiCollection ui 元素对象的集合
  • UiDevices 通过 getUiDevices 方法获得一个单例的对象,通过该对象可以进行一些设备相关的操作

测试原理

Macaca 主要有两个模块来负责操作设备的自动化测试,一个是 macaca-adb ,一个是 uiautomator-client 。macaca-adb 用 Nodejs 对安卓 adb 命令进行了包装,以供其他 node 模块调用,可以用其来进行模拟器的启动,端口号映射,获取设备等操作。 uiautomator-client 模块是我们分析的主角。

Java 端测试用例编写方法

我们先来看 Java 端一般是如何跑 UIAutomator 测试用例的。创建一个 Java 工程,编写用例类,UIAutomator 的测试入口是一个 UIAutomatorTestCase 的子类,范例如下:

import com.android.uiautomator.testrunner.UiAutomatorTestCase; public class test extends UiAutomatorTestCase { public void testMain() throws UiObjectNotFoundException { // 用例代码  } }

然后在该工程根目录下执行命令

android create uitest-project

会在工程下生成一个 ant 的 build.xml 文件,接着用 ant 对该工程进行编译打包,在工程的 bin 目录下生成 jar 包。

将生成的 jar 包用 adb push 到安卓设备上,然后执行

adb shell uiautomator runtest jar包名 -c 测试类名

最后我们的 UIAutomator Java 用例代码便运行起来了。

Macaca 的做法

uiautomator-client 模块会在本地机器和安卓设备之间建立 socket 连接,然后自动化指令就通过 socket 进行传输。既然是建立 socket ,那么必然有客户端和服务端的 socket 服务建立过程。本机上的 socket 服务建立用 Nodejs 建立并监听即可。对于手机端的 socket 服务建立,我们把 Java 建立 socket 的过程放在 UIAutomator 用例的入口处,如下:

import com.android.uiautomator.testrunner.UiAutomatorTestCase; public class test extends UiAutomatorTestCase { public void testMain() throws UiObjectNotFoundException { // 建立socket服务 initSocketServer(); } }

然后我们将“ Java 端测试用例编写方法”这一小节描述的过程用 Nodejs 的代码进行封装,所涉及的 adb 命令由 macaca-adb 模块搞定,包括 ant 编译命令也通过 Nodejs 来封装执行,生成一个驱动 jar 包,最后将这个 UIAutomator 驱动模块 push 到安卓设备并启动,这样安卓设备就建立 socket 服务完毕。下面从代码上详细分析一下该过程。

安装了 uiautomator-client ,并成功跑过一次安卓测试用例的同学,可以在 uiautomator-client 的安装目录下查找 uiautomator-client 文件夹,可以发现该文件夹下包含了一个标准的 UIAutomator 的测试用例工程:

Macaca 测试 Android 原理解析 - UIAutomator 篇

这个工程就是被上图中 scripts 文件夹下的 build.js 创建的。Macaca UIAutomator 驱动的编译过程就是在build.js 中进行的。

我们来看 build.js 中的逻辑,先通过 checkEv 函数来检测系统环境变量 ANDROID_HOME 有没有配置,因为需要用到 SDK 目录下的 Android Tools 工具:

var checkEnv = function() { return JAVA_HOME.getPath().then(javaHome => { console.log('JAVA_HOME is set to ' + javaHome); var env = global.process.env; if (!env.ANDROID_HOME) { console.log('ANDROID_HOME is not set'); throw new Error('ANDROID_HOME is not set'); } var android = isWindows ? 'android.bat' : 'android'; var androidTool = path.resolve(env.ANDROID_HOME, 'tools', android); if (!_.isExistedFile(androidTool)) { console.log('`android` command was not found'); throw new Error('`android` command was not found'); } var sdkVersion = selectAndroidSdkSync(); if (!sdkVersion) { console.log('no avaliable sdk'); throw new Error('no avaliable sdk'); } sdkVersion = sdkVersion[sdkVersion.length - 1]; var args = ['create', 'uitest-project', '-n', fileName, '-t', sdkVersion, '-p', '.']; return [androidTool, args]; }); };

然后用 createUITest 函数来创建一个标准的 UIAutomator 测试工程,并生成了 ant build 文件:

var createUITest = function(res) { var androidTool = res[0]; var args = res[1]; return new Promise((resolve, reject) => { var createProcess = spawn(androidTool, args, { cwd: cwd }); createProcess.on('error', err => { console.log(err); reject(err); }); createProcess.stdout.setEncoding('utf8'); createProcess.stderr.setEncoding('utf8'); createProcess.stdout.on('data', data => { console.log(data); }); createProcess.stderr.on('data', data => { console.log(data); }); createProcess.on('exit', code => { if (code !== 0) { reject(new Error('setup failed')); } else { resolve(); } }); }); };

然后通过 buildBootstrap 函数来进行 Java 编译,其中用到一个 ant 的 npm 包:

var buildBootstrap = function() { return new Promise((resolve, reject) => { var buildProcess = spawn(ant, ['build'], { cwd: cwd }); buildProcess.on('error', err => { return reject(err); }); buildProcess.stdout.setEncoding('utf8'); buildProcess.stderr.setEncoding('utf8'); buildProcess.stdout.on('data', data => { console.log(data); }); buildProcess.stderr.on('data', data => { console.log(data); }); buildProcess.on('exit', code => { if (code !== 0) { reject(new Error('build failed')); } else { console.log(fileName + ' build success!'); resolve(); } }); }); };

需要特别注意的是,设备端 socket 服务监听的是设备端口,本地电脑端服务监听的本机的端口,要想连通这两端的 socket,需要用 adb 工具进行端口映射,命令如下:

adb forward tcp:A tcp:B

通过该 adb 命令可以将发往本机 A 端口的数据重定向到安卓设备的 B 端口。

有了 socket 连接,就可以将测试指令发往 UIAutomator 驱动,驱动根据不同的指令参数去执行用 UIAutomator API 写成的 Java 用例。

小结

将上一小节的分析用一个图来进行总结,给大家一个全局认识

<img src="http://ww1.sinaimg.cn/large/67ba1336gw1f3dt6wd946j20j40j20vf.jpg" width="350">

用 UIAutomator API 编写自动化代码

可以看到,最终我们的自动化指令是要通过 UIAutomator 这个框架来驱动的,如何用该框架的 API 进行自动化代码编写读者可以参照网上的各种教程,这里笔者通过 Swipe 操作的实现来简单地介绍 Macaca 是如何使用该框架 API 的。

首先将操作指令都用一个类表示: Swipe.java ,它实现 execute 方法,通过 socket 收到 json 字符串指令后,解析字符串,根据字符串去调用对应的指令类实例的 execute 方法。范例如下:

import com.android.uiautomator.core.UiDevice; public class Scroll { public String execute(JSONObject args) throws JSONException { try { boolean result = UiDevice.getInstance().swipe(50, 300, 50, 10, 1000); return success(result); } catch (final Exception e) { return failed("UnknownError"); } } }

其中 UiDevice 是 UIAutomator 框架下的类,且是单例的,通过 getInstance 获取实例后调用 swipe 来模拟设备上的手势滑动。

在 Macaca 测试用例中用 driver.swipe(startX, startY, endX, endY, duration) 的方式编写滑动用例,下面给出两种滑动的自动化效果范例:

  • 上下滑动:

Macaca 测试 Android 原理解析 - UIAutomator 篇

  • 左右滑动

Macaca 测试 Android 原理解析 - UIAutomator 篇

总结

本文简要分析了 Macaca 利用 UIAutomator 的原理,抛砖引玉。但是实际的代码实现需要考虑更多的东西,也更为复杂,且这部分也仅仅是 Macaca 的一个模块。但是 Macaca 代码都是开源的,觉得本文写的不够详细或有兴趣深入的同学可以亲自去看看其源码。Macaca 也还有很多不足,欢迎大家参与其中,多提意见多支持。^_^


本文转自 念槐聚 博客园博客,原文链接:http://www.cnblogs.com/haochuang/p/5816962.html,如需转载请自行联系原作者

相关实践学习
阿里云百炼xAnalyticDB PostgreSQL构建AIGC应用
通过该实验体验在阿里云百炼中构建企业专属知识库构建及应用全流程。同时体验使用ADB-PG向量检索引擎提供专属安全存储,保障企业数据隐私安全。
AnalyticDB PostgreSQL 企业智能数据中台:一站式管理数据服务资产
企业在数据仓库之上可构建丰富的数据服务用以支持数据应用及业务场景;ADB PG推出全新企业智能数据平台,用以帮助用户一站式的管理企业数据服务资产,包括创建, 管理,探索, 监控等; 助力企业在现有平台之上快速构建起数据服务资产体系
相关文章
|
18天前
|
敏捷开发 测试技术 持续交付
探索自动化测试在敏捷开发中的应用与挑战
本文深入探讨了自动化测试在现代软件开发流程,特别是敏捷开发环境中的重要作用和面临的挑战。通过分析自动化测试的基本原理、实施策略以及在实际项目中的应用案例,揭示了其在提高软件质量和加速产品交付方面的巨大潜力。同时,文章也指出了自动化测试实施过程中可能遇到的技术难题、成本考量及团队协作问题,并提出了相应的解决策略,为软件开发团队提供了有价值的参考和指导。
|
23天前
|
编解码 测试技术 开发工具
测试 iPhone 应用在不同屏幕尺寸和分辨率下的响应式效果
【10月更文挑战第23天】测试 iPhone 应用在不同屏幕尺寸和分辨率下的响应式效果是确保应用质量和用户体验的重要环节。通过手动测试、自动化测试、视觉效果评估、性能测试、用户体验测试等多种方法的综合运用,能够全面地发现应用在响应式效果方面存在的问题,并及时进行解决和优化。同时,持续的测试和优化也是不断提升应用质量和用户满意度的关键。
|
7天前
|
自然语言处理 安全 测试技术
基于大模型的应用的测试的一些注意事项
大模型应用测试需注意三大冲突:时间敏感性冲突,即模型数据可能随时间变得过时;数据真实性冲突,指训练数据中可能存在虚假信息,影响模型准确性;数据一致性冲突,表现为模型对语义相同但句法不同的输入反应不一。测试时应针对这些问题设计用例,确保模型性能。
30 4
|
17天前
|
JSON Java Android开发
探索安卓开发之旅:打造你的第一个天气应用
【10月更文挑战第30天】在这个数字时代,掌握移动应用开发技能无疑是进入IT行业的敲门砖。本文将引导你开启安卓开发的奇妙之旅,通过构建一个简易的天气应用来实践你的编程技能。无论你是初学者还是有一定经验的开发者,这篇文章都将成为你宝贵的学习资源。我们将一步步地深入到安卓开发的世界中,从搭建开发环境到实现核心功能,每个环节都充满了发现和创造的乐趣。让我们开始吧,一起在代码的海洋中航行!
|
17天前
|
存储 搜索推荐 Java
打造个性化安卓应用:从设计到实现
【10月更文挑战第30天】在数字化时代,拥有一个个性化的安卓应用不仅能够提升用户体验,还能加强品牌识别度。本文将引导您了解如何从零开始设计和实现一个安卓应用,涵盖用户界面设计、功能开发和性能优化等关键环节。我们将以一个简单的记事本应用为例,展示如何通过Android Studio工具和Java语言实现基本功能,同时确保应用流畅运行。无论您是初学者还是希望提升现有技能的开发者,这篇文章都将为您提供宝贵的见解和实用的技巧。
|
21天前
|
搜索推荐 开发工具 Android开发
打造个性化Android应用:从设计到实现的旅程
【10月更文挑战第26天】在这个数字时代,拥有一个能够脱颖而出的移动应用是成功的关键。本文将引导您了解如何从概念化阶段出发,通过设计、开发直至发布,一步步构建一个既美观又实用的Android应用。我们将探讨用户体验(UX)设计的重要性,介绍Android开发的核心组件,并通过实际案例展示如何克服开发中的挑战。无论您是初学者还是有经验的开发者,这篇文章都将为您提供宝贵的见解和实用的技巧,帮助您在竞争激烈的应用市场中脱颖而出。
|
20天前
|
前端开发 数据管理 测试技术
前端自动化测试:Jest与Cypress的实战应用与最佳实践
【10月更文挑战第27天】本文介绍了前端自动化测试中Jest和Cypress的实战应用与最佳实践。Jest适合React应用的单元测试和快照测试,Cypress则擅长端到端测试,模拟用户交互。通过结合使用这两种工具,可以有效提升代码质量和开发效率。最佳实践包括单元测试与集成测试结合、快照测试、并行执行、代码覆盖率分析、测试环境管理和测试数据管理。
37 2
|
20天前
|
Web App开发 定位技术 iOS开发
Playwright 是一个强大的工具,用于在各种浏览器上测试应用,并模拟真实设备如手机和平板。通过配置 `playwright.devices`,可以轻松模拟不同设备的用户代理、屏幕尺寸、视口等特性。此外,Playwright 还支持模拟地理位置、区域设置、时区、权限(如通知)和配色方案,使测试更加全面和真实。例如,可以在配置文件中设置全局的区域设置和时区,然后在特定测试中进行覆盖。同时,还可以动态更改地理位置和媒体类型,以适应不同的测试需求。
Playwright 是一个强大的工具,用于在各种浏览器上测试应用,并模拟真实设备如手机和平板。通过配置 `playwright.devices`,可以轻松模拟不同设备的用户代理、屏幕尺寸、视口等特性。此外,Playwright 还支持模拟地理位置、区域设置、时区、权限(如通知)和配色方案,使测试更加全面和真实。例如,可以在配置文件中设置全局的区域设置和时区,然后在特定测试中进行覆盖。同时,还可以动态更改地理位置和媒体类型,以适应不同的测试需求。
20 1
|
21天前
|
前端开发 JavaScript 数据可视化
前端自动化测试:Jest与Cypress的实战应用与最佳实践
【10月更文挑战第26天】前端自动化测试在现代软件开发中至关重要,Jest和Cypress分别是单元测试和端到端测试的流行工具。本文通过解答一系列问题,介绍Jest与Cypress的实战应用与最佳实践,帮助开发者提高测试效率和代码质量。
30 2
|
18天前
|
NoSQL 测试技术 Go
自动化测试在 Go 开源库中的应用与实践
本文介绍了 Go 语言的自动化测试及其在 `go mongox` 库中的实践。Go 语言通过 `testing` 库和 `go test` 命令提供了简洁高效的测试框架,支持单元测试、集成测试和基准测试。`go mongox` 库通过单元测试和集成测试确保与 MongoDB 交互的正确性和稳定性,使用 Docker Compose 快速搭建测试环境。文章还探讨了表驱动测试、覆盖率检查和 Mock 工具的使用,强调了自动化测试在开源库中的重要性。
下一篇
无影云桌面