Android TV磁贴类app自动化框架二次改造(基于UiAutomator)

简介

项目一直是手工测试为主，加上一直是TV类应用，很多自动化工具都没有针对TV类项目做很好的适配，所以只有自己动手了。主要针对项目的特殊性进行了部分改造，不一定适用于其他项目。(涉及隐私，就不提供json文件和软件名字啦)

痛点

1.非标准控件的难处



通过uiautomatorviewer获取到的不一样的磁贴，属性全部相同(除了坐标点)，意味着没法通过id和class+index方式获取，text属性为空，也就没有办法通过byText的方式获取uiobject，高度定制的磁贴，让自动化很为难，如果通过坐标点，太坑爹，不能跨设备，还是坑。

2.TV类应用没有触摸操作

TV类安卓程序，主要面向的是遥控器，也就是接收的是keyevent，所以touch事件显得不这么全面，为了最接近用户，还是选择用key来做自动化。

架构模块

解析模块

从服务器解析json文件格式，包装成实体类CellInfo，返回一个包含磁铁信息的List。一个磁铁对应一个CellInfo，一个CellInfo需要提取的信息有

x坐标

y坐标

所属的Tab分类页

每个磁铁的说明标签

所以对应的定义如下：

package launcherClick.model;

public class CellInfo {

private String label;
private String tab;

public String getTab() {
return tab;
}

public void setTab(String tab) {
this.tab = tab;
}

private int x;
private int y;

public String getLabel() {
return label;
}

public void setLabel(String label) {
this.label = label;
}

public int getX() {
return x;
}

public void setX(int x) {
this.x = x;
}

public int getY() {
return y;
}

public void setY(int y) {
this.y = y;
}

}

解析用的是第三方开源库org.json，对应的解析代码如下：

package launcherClick;

import java.util.ArrayList;
import java.util.List;

import org.json.JSONArray;
import org.json.JSONObject;

import Utils.IOUtils;
import Utils.Println;
import launcherClick.model.CellInfo;

public class AMetroParse {

public static List<CellInfo> startParse(String url) {
String str = IOUtils.readFromNet(url);
if(str==null){
return null;
}
JSONObject jsonObject = new JSONObject(str);
List<CellInfo> list = new ArrayList<CellInfo>();
JSONArray _tabs = jsonObject.getJSONArray("tabs");
for(int i = 0;i<_tabs.length();i++){
String tab = _tabs.getJSONObject(i).getString("label");
JSONArray _cells = _tabs.getJSONObject(i).getJSONArray("cells");
for(int j=0;j<_cells.length();j++){
CellInfo cellInfo = new CellInfo();
cellInfo.setX(_cells.getJSONObject(j).getJSONObject("location").getInt("x"));
cellInfo.setY(_cells.getJSONObject(j).getJSONObject("location").getInt("y"));
cellInfo.setLabel(_cells.getJSONObject(j).getJSONObject("content").getString("label"));
cellInfo.setTab(tab);
list.add(cellInfo);
}
}
return list;
}
}

坐标转换模块

这部分的工作是把上一步骤解析后的实体类进行提取和处理，主要处理的内容是根据x y坐标计算磁铁移动量，更具x的极大值和分类页做跨分类移动的偏移计算以及一些其他处理。

通过x y计算偏移比较简单，只是简单计算距离:

for (CellInfo cellInfo : list) {
if (cellInfo.getLabel().contains(label)
&& cellInfo.getTab().contains(tab)) {
int x = cellInfo.getX();
int y = cellInfo.getY();
new Println("x:" + x + "  " + "y:" + y + "  " + "偏移量" + _offset);
// x方向
for (int i = x + _offset; i > 1; i--) {
new Println("→" + " count is " + (x + _offset));
keyRight();

}
// y方向
for (int i = y; i > 1; i--) {
new Println("↓");
keyDown();
}
}
}

恩，里面有个偏移量，跨分类用的，偏移量是通过每个分类下磁铁最大值得出来的，每一个分类最后一个磁铁的x值即为最大值，遍历当前分类下的所有磁铁的x，如果大于后面一个，则放在前面，下次再用这个值去比较下面的x值。忘记这是什么排序算法了…囧…当然，也可以用Collections的自带的算法。

private int togicOffset(String tab) {
int lineLenth = 0;
List<CellInfo> list = AMetroParse
.startParse("我是隐藏的接口");
for (CellInfo cellInfo : list) {
if (cellInfo.getTab().contains(tab)) {
int x = cellInfo.getX();
lineLenth = lineLenth >= x ? lineLenth : x;
}
}
return lineLenth;
}

那么通过上面的排序之后，就可以得到每个分类的偏移量，这样对于后面的分类磁贴，就可以知道磁贴在整体的真正位置啦，于是就可以开始移动了。

for (CellInfo cellInfo : list) {
if (cellInfo.getLabel().contains(label) && cellInfo.getTab().contains(tab)) {
int x = cellInfo.getX();
int y = cellInfo.getY();
new Println("x:" + x + "  " + "y:" + y + "  " + "偏移量" + _offset);
// x方向
for (int i = x + _offset; i > 1; i--) {
new Println("→" + " count is " + (x + _offset));
keyRight();

}
// y方向
for (int i = y; i > 1; i--) {
new Println("↓");
keyDown();
}
}
}

图片比较模块

来源于monkeyrunner的思路，原理是计算两个bitmap的长宽，然后提取出里面每个像素的像素值，如果相同，相似度+1，最后再除以总像素值(比如1280x720)，这样就可以把相似程度转为一个一个可以衡量的具体值了，那么判断这个界面是不是我需要点击的时候，只需要截屏当前图片和预期的图片对比，相似度达到100的时候就认为是正确的。当然也提供了局部比较的功能，比如获取不到数据的异常提示。那么代码如下，提供了多种重载的方法以及两个assert判断。

package Utils;

import junit.framework.Assert;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;

public class ImageCompare {

public  static void AssertBitmapEqual(Bitmap bitmap0, Bitmap bitmap1){
/**
* 百分百图片相同断言-.-
*/
Assert.assertEquals(100, ImageCompare(bitmap0,bitmap1));
}

public  static void AssertBitmapNotEqual(Bitmap bitmap0, Bitmap bitmap1){
/**
* 百分之零图片相同断言
*/
Assert.assertEquals(0, ImageCompare(bitmap0,bitmap1));
}

public static int ImageCompare(String path0,String path1) {
/**
* 提供根据路径直接比较
*/
Bitmap bitmap0 = BitmapFactory.decodeFile(path0);
Bitmap bitmap1 = BitmapFactory.decodeFile(path1);
return ImageCompare(bitmap0,bitmap1);
}

public static int ImageCompareChild(Bitmap bitmap0, Bitmap bitmap1,int x,int y,int width,int height) {
/**
* 裁剪子图并比较，主要是为了解决拉取动态数据不同，但是局部提示不变的比较场景。
*/
Bitmap bitmap00 = bitmap0.createBitmap(bitmap0, x, y, width, height);
Bitmap bitmap01 = bitmap1.createBitmap(bitmap1, x, y, width, height);
return ImageCompare(bitmap00,bitmap01);
}

public static int ImageCompare(Bitmap bitmap0, Bitmap bitmap1) {
/**
* 比较的主函数
* 只能比较相同长宽的图片，不相等返回-1失败
* 相似度为1~100
* 原理是提取每一个像素点比较，整张图相似度取决于像素点相同个数，所以还是比较准确的
*/
int picPct = 0;
int picCount = 0;
int picCountAll = 0;
new Println("begin to compare");
if (bitmap0 == null || bitmap1 == null) {
new Println("null bitmap");
return -1;
}
if (bitmap0.getWidth() != bitmap1.getWidth()
|| bitmap0.getHeight() != bitmap1.getHeight()) {
return -1;
}
new Println("宽度为:" + bitmap1.getWidth() + "高度为:" + bitmap1.getHeight());
for (int j = 0; j < bitmap1.getWidth(); j++) {
for (int i = 0; i < bitmap0.getHeight(); i++) {
if (bitmap0.getPixel(j, i) == bitmap1.getPixel(j, i)) {
picCount++;
}
picCountAll++;
}
}
int result = (int) (((float) picCount) / picCountAll * 100);
new Println(picCount + "/" + picCountAll);
new Println("相似度为:" + result);
return result;
}
}

异常&&其他模块

定义了一些异常类，主要功能用于提示，这个提示的作用后面会用到。

增加了启动应用和关闭应用的方法，原理是用到了shell命令。

Runtime.getRuntime().exec("am start -n 我是包名隐藏者");

初始化方法，主要用于异常时能够一键重新开始，以及磁贴复原功能，还有其他一些小的处理就不多说啦，下面开始持续构建。

自动化的持续集成

还是那句话，不持续集成的自动化不是自动化，所以这里介绍的是基于jenkins的自动化集成，其实UiAutomator做集成还是很容易的，只要把jar包放在一个固定的目录，然后shell命令执行就完事了。



然后定时任务自己选吧，构建失败的邮件提醒这里设置的是，上面我自定义的异常类，当控制台输出我的异常类，那么会认为不通过，然后触发邮件提醒。



那么至此，一个较为完整的流程就完成啦,那么在此框架上组员们(就我一个)就可以更进一部去完善二级页面的自动化用例了。