# Adb-For-Test

**Repository Path**: liper/Adb-For-Test

## Basic Information

- **Project Name**: Adb-For-Test
- **Description**: 通过adb命令实现简单的点击、滑动、长按等效果，可通过比例定位元素、通过元素定位（需要Android版本高于4.0），拥有monkeyrunner的绝大部分功能 
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2019-01-22
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#Adb-For-Test


通过`adb命令`实现简单的点击、滑动、长按等效果，可通过比例定位元素、通过元素定位（需要Android版本高于4.0），用于`Android Test`，拥有monkeyrunner的绝大部分功能 

###2015.04.28
 * 重构`python版本`中的adbUitils模块，合并`AppInfo`、`Action`类直`ADB`中
 
 	> 初始化方法：
 
	> adb = ADB() 或 adb = ADB("device_id")
 * 重构的目的是增加python版本对多设备的支持，通过传入device_id，解决有多台设备连接USB时无法执行脚本的问题
 * `Element`类中增加通过属性`content-desc`定位元素的方法
 
###Robotium
 * 如果想用于`Robotium`处理跨进程，需要修改部分代码，请参考[Adb-For-Robotium](https://github.com/gb112211/Adb-For-Robotium)

###为何写这么个东西？

 * 目前所做的工作是对rom的测试，所以基本上所有的测试环境都集中在Android4.2、4.3、4.4平台，平台比较固定
 * Android测试中最为熟悉的就是adb命令，很多功能都可通过adb命令去实现，因此几乎可以使用任何的编程语言去编写脚本调用adb命令，去实现对设备的操作
 * 将日常工作中封装的一些由adb命令完成的功能整合在一起，方便于使用
 * 作为自己学习java、python的一种实践

###优点

 * 分别采用两种语言（java、python）实现，需要的环境都极其的简单，不需要root
 * 基本上都以adb命令完成功能，可从代码中剥离部分代码形成日常用的脚本（参考[AndroidTestScripts](https://github.com/gb112211/AndroidTestScripts)项目)
 * 由于是通过adb命令去发送事件，所以可跨应用进行测试，可用来扩展其他Android测试框架
 * 通过设备分辨率与坐标转换，可以方便的以屏幕比例作为参数来操作设备
 * 调用了`uiautomator`命令，Android4.0以上，可通过界面元素进行定位，可获取界面内单个元素区域的坐标范围，以此截取图片（区别于截取整个屏幕）
 * 可采用截图对比全图、部分区域图片、获取当前界面某个元素、获取当前界面的Activity等各种属性，对测试结果进行判断

###缺点

 * 部分功能需要较高的Android版本，低版本的未去验证，所以局限性很大，纯当练手
 * 初学java、python，代码写得比较烂
 * 很多地方未做异常处理
 * 暂时未写单元测试，所以使用时需要读者阅读具体的源码
 * 有疑问有吐槽请联系：Email: xuxu_1988@126.com  QQ:274925460

###需要的环境

 * 环境变量：需配置ANDROID_HOME
 * python：python2.7，如果用到截图对比功能，需要安装PIL库，PIL无法安装时可用[Pillow](http://www.pythonware.com/products/pil/index.htm "PIL地址")
 * java: jdk1.6以上，不需要其他任何第三方jar包,jar不可用时，可能是jdk版本问题，请自行编译

###如何使用

 * python：使用setup.py install 安装，未去强制判断要求安装PIL，使用ImageUtils时则需要安装
 * java：导入`Adb-For-Test.jar`即可

###简单例子

 * 在TestDemo目录下分别有python、java的例子，使用的apk是ApiDemos.apk

 * 这里使用python写一个截取桌面应用图标的例子：

	```
	#coding=utf-8

	import os

	from adbUtils.utils.adbUtils import ADB
	from adbUtils.utils.imageUtils import ImageUtils
	from adbUtils.utils.element import Element
	
	#单个设备可不传入device_id
	adb = ADB(“device_id”)
	element = Element("device_id")

	#获取图片区域
	icon = element.getElementBoundsByClass("android.widget.TextView")[0]
	image = ImageUtils()
	#截取图片
	image.screenShot().subImage(icon).writeToFile(os.getcwd(), "image")

	#加载需要对比的目标图片
	#load = image.loadImage(os.getcwd() + "\\image.png")
	#print image.screenShot().subImage(icon).sameAs(load)
```