Android Espresso自动化测试环境搭建

Espresso设置指令

?设置您的测试环境

?下载Espresso

?仪表设置转轮

?build.gradle 文件示例

?分析

?添加第一测试

?运行测试

本指南涵盖Espresso SDK 安装使用管理器创建信息技术使用格拉德尔.安卓工作室.

设置您的测试环境

避免片状, 我们强烈建议关闭动画系统虚拟或物理设备用于测试.

?都能在上面下设置- >显影剂选项3 禁用下列选项设置:

o动画缩放窗口

o规模过渡动画

o动画师持续时间震级

下载Espresso

?请确保已安装最新储存库 Android 的支持下额外(见指令).

?打开应用程序build.gradle文件.通常不是顶级build.gradle但文件app/build.gradle.

?中添加以下行相依性:

androidtestcompile "com.android.support.test.espresso:espresso-core: 2.2.1"

androidtestcompile "com.android.support.test:runner:0.4. 1"

?看到下载更多的程序化操纵的部 - Contrib (特Espresso, 爱斯普利索咖啡幅材等)

仪表设置转轮

?增加 build.gradle 相同则取消对 runado. cpp 中以下行的文件android.defaultConfig:

testinstrumentationrunner "android.support.te

-

st.runner.AndroidJUnitRunner"

build.gradle 文件示例

apply plugin: "com.android.application"

android {

compileSdkVersion 22

buildToolsVersion "22"

defaultConfig {

applicationId "com.my.awesome.app"

minSdkVersion 10

targetSdkVersion 22.0.1

versionCode 1

versionName "1.0"

testInstrumentationRunner

"android.support.test.runner.AndroidJUnitRunner"

}

}

dependencies {

// 这款应用的依赖项, 它包含测试

compile "com.android.support:support-annotations:22.2.0"

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - 注释: 22.2. 0

/ / 测试只依赖性

androidTestCompile "com.android.support.test:: 0.4. 1

androidTestCompile "com.android.support.test.espresso: espresso - core: 2.2.1

}

分析

, 以确保我们在正确的轨道上每一个新版本, 运行测试收集分析.更具体地, 上传的散列应用程序的分组名称为每次调用测试.这允许我们测量包裹时用独特的计数Espresso体积以及在使用.

如果您不希望该数据上传, 你可以通过给测试运行程序论说以下主

张:disableAnalytics "true"(见如何通过自定义参数).

添加第一测试

Android Studio 会创建在默认情况下试验

src/androidTest/java/com.example.package/

示例测试 junit4 使用规则:

@ Runwith(Androidjunit4.class)

@ LargeTest

public class helloworldespressotest {

@ Rule

public activitytestrule mactivityrule = new activitytestrule(mainactivity.class);

@ Test

public void listgoesoverthefold() {

onview(withtext("Hello

world!")).check(matches(isDisplayed()));

}

}

运行测试

Android Studio

创建一个测试配置

Android 工作室:

?打开运行菜单- >编辑配置

?添加新安卓试验配置

?选择模块

?添加特殊管理规范:

android.support.test.runner.AndroidJunitRunner

运行新生成配置.

从命令行通过Gradle

执行

./gradlew connectedAndroidTest

https://google.github.io/android-testing-support-library/docs/espresso/setup/index.html Espresso基础

?onview 与取景

?视图上执行动作的

?如果满足检查断言视图

?开始 onview 来试试就成.

?基于与使用AdapterView(控制ListView,GridView,...)

?开始相对来试试就成.

?调试

API 测试浓缩咖啡鼓励作者认为用户可能进行交互时做定位应用 UI 元素, 并且和他们互动.同时, 框架阻碍直接接入活动和在应用程序视图因为持有了这些对象和操作它们关闭 UI 线程的一个主要来源是测试片状.因此, 您将不会看到getcurrentactivity getview 方法中被和 API.你上操作仍能安全实现自己意见ViewAction和ViewAssertion的.

这里有一个的主要部件的概况图制作浓缩咖啡时,:

?Espresso入口点——视图 (通过相互作用onView和onData). API 也暴露出不一定只做任何视图 (例如pressBack).

?viewmatchers(由小泡沫堆积对象实现Matcher接口.你可以通过一个或多个这些onView定位方法当前视图视图层次.

?viewactions(由小泡沫堆积ViewAction的, 可以被传递到

ViewInteraction.perform()方法 (例如,click()).

?viewassertions(由小泡沫堆积ViewAssertion能够在通过

ViewInteraction.check()方法.大多数时间, 你是利用比赛主张, 使用

视图断言匹配器的当前状态选择的视图.

示例:

onview(withID 的(R.ID., 用视图)) r.id withID 的 / / (.) 是, 用视图 viewmatcher

.执行(点击()) / / viewaction 是 click ()

.检查(匹配(年薪制())); / / (匹配 (年薪制)) 是 viewassertion onview 与取景

在绝大多数的案件中都是 onview Hamcrest 匹配器 (matcher), 提高徐州市农业现代化水平, 实现依靠科技进步解决 "三农" 问题被匹配上的指导, 而且这

仅有的一次唯一的) 当前视图层次视图.匹配器将有强大的熟悉那些与她的孩子们一起玩这些橡皮泥, JUnit 或 Mockito.如果您不熟悉 Hamcrest 匹配器, 我们建议你首先了解看看这呈现.

经常期望视图具有独特R.id和简单withId综合显示上传, 删除, 保护, 查封匹配器将缩小搜索.然而, 有许多合法的情况下当您不能确定R.id在测试开发时间.例如, 可能不具有特定视图或 r.id r.id 不是唯一.这可以使复杂仪表和脆性试验正常去写作因为以常规的方式对访问视图 (findViewById()) 根本不可

能运行.因此, 您可能需要访问的私有成员保持活性或片段视图或容器, 具有已知找到并定位到其 r.id 内容视图 # "前面.

Espresso允许胶带可均匀地将处理这个问题去现有视图中的栏目ViewMatcher

或您自定义的.

认为 r.id 苦恼一样简单:

onView(withIid (R.id.my_view))

有时, r.id 多个视图之间共享值.当这一切发生的时候尝试使用特定R.id给你一个AmbiguousViewMatcherException(例如).您提供异常消息的文本表示当前

视图层次, 您可以去搜寻并找到意见非唯一匹配R.id:

https://www.doczj.com/doc/601032800.html,ng.抛出 RuntimeException:

com.谷歌.安卓.应用程序.共同.测

试.UI.Espresso.ambiguousviewmatcherexception:

这匹配器匹配多个视图在的层次: (withID 的: 是 <123456789>)

.

+----->SomeView{ID=123456789, res-name=plus_one_standard_ann_button, 能见度=VISIBLE, 宽度=523, 高度=48, has-focus=false, has-focusable=true, window-focus=true,

is-focused=false, is-focusable=false, 启用=true, 选择=false,

is-layout-requested=false, 文本=, root-is-layout-requested=false,

X=0.0, Y=625.0, child-count=1}

****MATCHES****

-

+------>OtherView{ID=123456789, res-name=plus_one_standard_ann_button, 能见度=VISIBLE, 宽度=523, 高度=48, has-focus=false, has-focusable=true, window-focus=true,

is-focused=false, is-focusable=true, 启用=true, 选择=false,

is-layout-requested=false, 文本=Hello!,

root-is-layout-requested=false, X=0.0, Y=0.0, child-count=1}

****MATCHES****

通过意见的各种属性, 您可能会发现唯一可标识的特征 (在上述示例中, 一个具有意见文本 "你好!"). 你能使用它作为缩小您的采用组合搜索匹配器:

onview(所有(withID 的(R.ID., 用视图), withtext("Hello!")))

您还可以使用not撤销任何的匹配器:

onview(所有(withID 的(R.ID., 用视图), 不(withtext("Unwanted"的性态

看到viewmatchers视图匹配器的意式咖啡提供.

注:在一个功能良好的应用程序, 所有视图用户可与之互动的要么应当具有的描述性文本或内容描述 (参见安卓易读性指引. 如果您无法搜索 onview 减少 "或" 使用 "withcontentdescription withtext, 考虑错误当成一种无障碍处理.

注:至少使用描述性视图匹配器 (matcher), 找到你想找.不过头, 因为这将迫使一点的框架不只是必要的操作.例如, 如果视图其唯一地识别出文本, 不需要规定你的观点不也正从可分配TextView许多的意见R.id应该足够的.

注:如果对象视野, 是内AdapterView(例如

ListView,GridView,Spinner)onView方法可能不会工作和建议使用onData方法.

视图上执行动作的

当您找到了合适的匹配器, 用于对象视野, 可以执行ViewAction平台上使用的perform方法.

例如, 点击 "视图: 视图 1"

onview(......).执行(点击());

你一次能执行几个只要用一个执行呼叫:

onview(......).执行(typetext("Hello"), 点击());

如果视图的工作是你位于ScrollView(垂直或水平), 考虑前需要要显示的视图(如click()和typeText())scrollTo()这确保了. 视图显示方式进行其他行动之前:

onview(......).执行(浏览(), 点击());

注: scrollTo()如果将没有影响已经在英国很有限, 该项目主要是通过安全利

用储存的显示就显示视图时由于更大的屏幕尺寸 (例如, 当这两者之上运行测

试较小和较大屏幕分辨率).

看到viewactions视图的意式咖啡提供的动作.

如果满足检查断言视图

断言能被应用至当前与所选视图check()方法.声明是指最常用matches()声明时, 它使用ViewMatcher断言的当前状态选择的视图.

例如, 以检查看法将文本 "你好!":

onview(......).检查(匹配(withtext("Hello!")));

注:做没有说明是 "断言" 到 "论说 onview 相反, 清楚具体说明你正在检查检查块.例如:

如果你想观点, 即在你好! "是视图集的内容, 考虑以下情况不好的做法:

/ / 不要使用断言 onview withtext 内部等.

onview(所有(withID 的, (...), withtext("Hello!"))).检查(匹配(年薪制()));

另一方面, 如果你想给人视图机制可以确定一种将文本 "你好!" 是有目共睹的, 例如意见改变之后的代码标志能见度很好.

注:必须注意差异一个观众没有声称显示和断言不存在视图的在视图层次.

开始 onview 来试试就成.

在该示例中SimpleActivity包含Button和TextView当按钮点击的内容TextView改变"Hello Espresso!". 如何测试这场Espresso与:

1.点击按钮

第一步先研究属性寻找按钮.按钮SimpleActivityR.id 具有独特完美!

onview(withID 的(R.ID.button _ 简单))

现在进行点选:

onview(withID 的(R.ID.button _ 简单)).执行(点击());

2.检查TextView现在包含 "你好Espresso!"

的TextView与文本具有独特 r.id 验证:

onview(withID 的(R.ID.简单文本 _))

现在核实内容文本:

onview(withID 的(R.ID.简单文本 _)).检查(匹配(withtext("Hello Espresso!")));

基于与使用AdapterView(控制ListView,GridView,...)

adapterview是一种特殊类型的界面部件, 其动态地从加载其数据适配器.的最普通例子AdapterView是ListView而静态. 开发很多插件, 比如在LinearLayout第二算子指示一时间, 以在该时间处,AdapterView儿童可被加载到当前视图层次和简单onView()搜索不会找到尚未加载视图.Espresso提供单独的多个实例,onData()入口点上第一负载能够适配器 (项目聚焦的对象) 的距离使其操作在其上的或之前任何带走了自己的孩子.

注:你可以选择绕过onData()加载动作项目视图适配器, 因为他们最初显示已

加载.然而, 使用更安全的做法是始终对onData().

警告:自定义执行,AdapterView问题可以具有onData()方法, 如果犯规 (特别是继承合同getItem()API).在这种情况下, 最好的办法就是把重构您的应用代码.如果你们不能那样做的话, 你可以实现自定义匹配AdapterViewProtocol. 请看默认adapterviewprotocols留连法式咖啡座提供更多信息.

开始相对来试试就成.

这个简单的测试演示如何使用onData().SimpleActivity包含Spinner一些项目- 串调制后符号 422 表示的咖啡饮料.当选择一个项时, 存在TextView更改"One %s a day!"S% 其中所选择的项目.目标本试验的打开Spinner选择特定项, 然后验证TextView包含项目.作为Spinner类基于AdapterView建议使用onData()而不是onView()项目匹配.

1.点击旋转器打开该项选择

onview(withID 的(R.ID._ 简单旋转器)).执行(点击());

2.点击 "美式咖啡"

选中项创建旋转器ListView- 内容这可以时间长, 未归于元件视图层次 - 浇

上曲onData()我们强迫我们到视图层次所需元素.项目Spinner是字符串, 那么我们希望随时满足项目是串, 并且等于字符串 "美式咖啡":

基于(所有(是(instanceof(串.类)), 是("Americano"))).执行(点击());

3.验证TextView包含字符串 "美式咖啡"

onview(withID 的(R.ID.spinnertext _ 简单))

.检查(匹配(withtext(containsstring("Americano"坐标;

调试

提供有用的调试信息Espresso当测试失败:

测井

Espresso到 LogCat 所有视图操作日志.例如:

ViewInteraction: Performing 点击 "" action on view with text: Espresso 视图层次

Espresso中打印视图层次当异常字符串onView()失败. * 如果onView()没有找到对象视野,NoMatchingViewException.你可以检查在视图层次分析为什麽异常字符串匹配器不匹配任何意见. * 如果onView()发现符合给定多个视图匹配

器,AmbiguousViewMatcherException.印刷和视图层次进行匹配后的所有视图与标记与标签匹配:

https://www.doczj.com/doc/601032800.html,ng.RuntimeException:

https://www.doczj.com/doc/601032800.html,mon.testing.ui.espresso.AmbiguousViewMatch erException:

This matcher matches multiple views in the hierarchy: (withId: is

<123456789>)

.

+----->SomeView{ID=123456789, res-name=plus_one_standard_ann_button, 能见度=VISIBLE, 宽度=523, 高度=48, has-focus=false, has-focusable=true, window-focus=true,

is-focused=false, is-focusable=false, 启用=true, 选择=false,

is-layout-requested=false, 文本=, root-is-layout-requested=false,

X=0.0, Y=625.0, child-count=1}

****MATCHES****

-

+------>OtherView{ID=123456789, res-name=plus_one_standard_ann_button, 能见度=VISIBLE, 宽度=523, 高度=48, has-focus=false, has-focusable=true, window-focus=true,

is-focused=false, is-focusable=true, 启用=true, 选择=false,

is-layout-requested=false, 文本=Hello!,

root-is-layout-requested=false, X=0.0, Y=0.0, child-count=1}

****MATCHES****

当处理复杂的视图层次或意料之外的行为是很有用的小部件使用安卓视图层次

观众解释.

AdapterView警告

警告使用者曝光率的EspressoAdapterView小部件.当onView()操作将抛出一个NoMatchingViewException和AdapterView小部件视图层次中存在, 最常见的办法就是用onData()异常消息将包括. 警告列表视图的适配器.你可以使用该信

息来调用基于视图的用于加载目标.

Espresso备忘单

的Espresso备忘单你是一个快速参考期间可以使用的发展.这样骗人版票最可

用Matchers,ViewActions和ViewAssertions.

也离线版本的 PDF 版本如下:意式Espresso小抄 - 2.1. 0.pdf

Espresso意图

?意式Espresso意图下载

?intentstestrule

?验证意图

?清除意图

?意图匹配器

意式Espresso扩展目的的意式咖啡 (Espresso) 的验证和意图能够清除由应用程序发送.这就像Mockito安卓, 但意图.

意式Espresso意图下载

?请确保已安装储存库 Android 的支持(见指令).

?打开应用程序build.gradle文件.通常不是顶级build.gradle但文件app/build.gradle.

添加以下行内部相依性:

androidtestcompile "com.android. support.test. Espresso 咖啡: 浓缩 - 意图: 2.2. 1

意式EspressoEspresso意图只与一般 HDMI 兼容支持库测试 2.1 和 0.3 所以确保你更新这些线:

androidtestcompile "com.android. support.test:: 0.4. 1 androidtestcompile "com.android. support.test: 规则: 0.4. 1 androidtestcompile "com.android. support.test. Espresso 咖啡: 浓缩 - Core: 2.2. 1

intentstestrule

使用IntentsTestRule而不是ActivityTestRule当使用意式Espresso意

图.IntentsTestRule更能让用户在使用时得心应手意式Espresso意图功能 UI 测试 API.这个类是的延伸ActivityTestRule意式Espresso意图, 它初始化在每个试验之前注释@Test意式Espresso意图并释放每次运行测试之后.活性后终止每个考验, 而这个规则可用于相同的方式ActivityTestRule.

验证意图

意式Espresso意图记录所有意图尝试从应用活动.使用的所要求的 API (表兄Mockito.verify), 你可以断言给定意图.

示例输出验证根本意图:

@ test

公共空隙 validateintentsenttopackage() {

/ / 用户动作导致外部 "电话" 活动.

用户.clickonview(系统.getview(R.ID.amp;));

/ / 使用罐头 recordedintentmatcher 意图解决验证

/ / "电话" 活动.

预期(topackage("com.android.phone"));

}

清除意图

使用 API (表兄的未来Mockito.when), 可以提供一个响应和后号发起的活动startActivity (这特别适用于外部操纵既然我们无法活动的用户接口的深层的活性又不能控制ActivityResult下活动返回测试):

示例性测试意图清除:

@ test

公共空隙 ishandledproperly activityresult _() {

/ / 中构建一个结果, 等准备好再来活动.

意图 resultdata = 新意图();

串 PhoneNumber = "123-345-6789";

resultdata.putextra("phone", PhoneNumber);

activityresult 结果 = 新 activityresult(活性.结果 _ OK, resultdata);

/ / 设置清除结果当意图派人来 "接触".

打算(topackage("com.android.contacts")).respondwith(结果));

/ / 用户动作导致 "接触" 活动.

/ / PhoneNumber 预计发射返回活性显示在该屏幕上的对应部分.

onview(withID 的(R.ID.pickbutton)).执行(点击());

/ / 我们断言, 研究并提出了区域抗旱减灾的数据.

onview(withID 的(R.ID.PhoneNumber).检查(匹配

(withtext(PhoneNumber)));

}

意图匹配器

intending和intended方法对例 HamcrestMatcher作为参数.Hamcrest 匹配器的对象是图书馆 (也称为谓词或约束).你有这些选项: * 匹配器使用现有意图: 最简单的选择, 在大多数情况下, 应该优选的. * 匹配器实现自己的意图: 最灵活的选择, (参见, 请您按 "反战者国际匹配器自定义汀 "Hamcrest 教程)

示例意图意向书与现有验证匹配器:

预期(所有(

hasaction(等于(意图.行动 _ view)),

hascategories(hasitem(等于(意图.类别可浏览 _))),

hasdata(hashost(等于("https://www.doczj.com/doc/601032800.html,"))),

hasextras(所有(

hasentry(等于("key1"), 等于("value1")),

hasentry(等于("key2"), 等于("value2"的性态,

topackage("com.android.browser")));

前寄样品Espresso

?查看下一个匹配另一种意见认为

?基于匹配数据使用和定制 viewmatcher

?匹配的特定的的视场

?匹配的视图在列表视图中不需使用页脚 / 报头

?匹配内部的视图列即可

?一个观众没有声称显示

?断言不存在视图的

?表示政府的 "中无数据适配器

?使用自定义资源同步 registeridlingresource

?使用自定义失败处理机

?目标配合使用非默认 Windows

viewmatchers

查看下一个匹配另一种意见认为

布局可以包含某些视图不唯一的 (例如重复调用按钮表具有相同的联系人的r.id, 和包含相同文本具有相同的特性其他视图层次内呼叫按钮).

例如, 在本练习中, 该图用文本 "7" 跨多个重复行:

通常, 非唯一视图将一些独特的音乐与它紧邻办公大楼 (例如联系人的名字在呼叫按钮旁边).在这种情况下, 您可以使用匹配器 hassibling 缩小您选择:

onview(所有(withtext("7"), hassibling(withtext("item: 0"的性态

.执行(点击());

基于匹配数据使用和定制 viewmatcher

ListView 线下活动包含支持的由simpleadapter, 用来保存数据的每一行Map每个 MAP 具有带有关键字"STR"包含内容 (String,: 消息: "X") 和钥匙"LEN"包含整数, 内容的长度.

代码的点击行: 消息: "50" 看起来像这样:

基于(所有(是(instanceof(地图.类)), hasentry(等于("STR"), 是("item: 50")))

.执行(点击());

让我们剖析Matcher