在Android Studio中进行单元测试和UI测试

本篇教程翻译自Google I/O 2015中关于测试的codelab,掌握科学上网的同学请点击这里阅读:Unit and UI Testing in Android Studio。能力有限,如有翻译错误,请批评指正。如需转载,请注明出处。
Github下载测试源码

目录


1.概述

在这个codelab中,你将学习如何在Android Studio中配置工程用于测试,在开发机器上编写并运行单元测试,以及如何在手机上做功能UI测试。

你会学到什么

  • 更新包含JUnit和Android Testing Support Library的Gradle构建文件
  • 编写运行在本机Java虚拟机上的单元测试
  • 编写运行在手机或者虚拟机上的Espresso测试

你需要什么


2.创建新的Android Studio工程

如果是第一次启动Android Studio,从欢迎页选择“Start a new Android Studio project”。如果已经打开了一个工程,选择File>New>New Project...

Create new project”向导会指导整个过程,在第一页输入如下内容:

Setting Value
Application Name TestingExample
Company demain testing.example.com

这样会保证你的代码同codelab讲解的内容具有一致的命名。其他的选项都设置为默认,一路点击Next直到工程创建完毕。

点击Run按钮检查app是否运行正常,要么从模拟器列表中选择一个启动,要么确认开启了debug模式的设备通过USB同电脑正确连接。

app目前没有做任何事情,但是屏幕上应该显示“Hello world!”和app的名字。

580359-839b775d39f912f6

经常被问及的问题


3.配置支持单元测试的工程

在写测试之前,让我们做下简单的检查,确保工程配置正确。

首先,确认在Build Variants窗口内的Test Artifact中选择了"Unit Tests"。

580359-ab4402443ad7dc5f

然后,在工程的src文件夹内创建testtest/java文件夹。需要注意的是,你不能在Android视图下进行这些操作,要么在系统的文件管理器内创建,要么在工程窗口左上方点击下拉菜单选择Project视图。最终的工程结构应该是这样的:

580359-9e098817f6fcca44

(在codelab的剩余部分,你可以返回继续使用Android工程视图)

最后,打开工程的build.gradle(Module:app)文件,添加JUnit4依赖,点击Gradle sync按钮。

当你同步Gradle配置时,可能需要联网下载JUnit依赖。


4.创建第一个单元测试

现在,万事俱备,让我们开始写第一个测试吧。首先,创建一个非常简单的被测类:Calculator类。

580359-20cce1345b5076de

然后,向类中添加一些基本的算术运算方法,比如加法和减法。将下列代码复制到编辑器中。不用担心实际的实现,暂时让所有的方法返回0。

Android Studio提供了一个快速创建测试类的方法。只需在编辑器内右键点击Calculator类的声明,选择Go to > Test,然后"Create a new test…"

580359-729c021ff61b0dc7

在打开的对话窗口中,选择JUnit4和"setUp/@Before",同时为所有的计算器运算生成测试方法。

580359-19f96a03d2fa811a

这样,就会在正确的文件夹内(app/src/test/java/com/example/testing/testingexample)生成测试类框架,在框架内填入测试方法即可。下面是一个示例:

请将代码复制到编辑器或者使用JUnit框架提供的断言来编写自己的测试。


5.运行单元测试

终于到运行测试的时候了!右键点击CalculatorTest类,选择Run > CalculatorTest。也可以通过命令行运行测试,在工程目录内输入:

无论如何运行测试,都应该看到输出显示4个测试都失败了。这是预期的结果,因为我们还没有实现运算操作。

580359-00a07e968baebccc

让我们修改Calculator类中的sum(double a, double b)方法返回一个正确的结果,重新运行测试。你应该看到4个测试中的3个失败了。

作为练习,你可以实现剩余的方法使所有的测试通过。

可能你已经注意到了Android Studio从来没有让你连接设备或者启动模拟器来运行测试。那是因为,位于src/tests目录下的测试是运行在本地电脑Java虚拟机上的单元测试。编写测试,实现功能使测试通过,然后再添加更多的测试...这种工作方式使快速迭代成为可能,我们称之为测试驱动开发
值得注意的是,当在本地运行测试时,Gradle为你在环境变量中提供了包含Android框架的android.jar包。但是它们功能不完整(所以,打个比方,你不能单纯调用Activity的方法并指望它们生效)。推荐使用Mockito等mocking框架来mock你需要使用的任何Android方法。对于运行在设备上,并充分利用Android框架的测试,请继续阅读本篇教程的下个部分。


6.配置支持Instrumentation测试的工程

虽然在Android框架内支持运行instrumentation测试,但是目前开发重心主要集中在刚刚发布的作为Android Testing Support Library一部分的新的AndroidJUnitRunner。测试库包含Espresso,用于运行功能UI测试的框架。让我们通过编辑build.gradle的相关部分来把它们添加进我们的工程。

重要:由于一些依赖版本冲突,你需要确认com.android.support:appcompat-v7库的版本号是22.0.0,像上面的代码片段一样。
另外,Android Studio可能会提醒你Build Tools 22.0.1没有安装。你应该接受修复建议,Studio会为你安装Build Tools或者在build.gradle中把这行修改成已经安装在你电脑的版本。

上面的工作完成后,在Build Variants窗口内切换成Android Instrumentation Tests,你的工程应该自动同步。如果没有,点击Gradle sync按钮。


7.为app添加简单的交互

580359-40a6436d81203a3d

在使用Espresso进行UI测试前,让我们为app添加一些Views和简单的交互。我们使用一个用户可以输入名字的EditText,欢迎用户的Button和用于输出的TextView。打开res/layout/activity_main.xml,粘贴如下代码:
activity_main.xml

还需要在MainActivity.java中添加onClick Handler

现在可以运行app并确认一切工作正常。在点击Run按钮之前,确认你的Run Configuration没有设置为运行测试。如需更改,点击下拉选项,选择app


8.创建并运行Espresso测试

580359-182d42c3cc27596a

在工程的整体视图上,找到以(androidTest)后缀结尾的包名并创建一个新的Java类。可以将它命名为MainActivityInstrumentationTest,将如下代码粘贴过去。

测试类通过AndroidJUnitRunner运行,并执行sayHello()方法。下面将逐行解释都做了什么:

  • 1.首先,找到ID为editText的view,输入Peter,然后关闭键盘;
  • 2.接下来,点击Say hello!的View,我们没有在布局的XML中为这个Button设置id,因此,通过搜索它上面的文字来找到它;
  • 3.最后,将TextView上的文本同预期结果对比,如果一致则测试通过;

你也可以右键点击域名运行测试,选择Run>MainActivityInstrume...(第二个带Android图标的)

580359-86da68654bd41cb1

这样就会在模拟器或者连接的设备上运行测试,你可以在手机屏幕上看到被执行的动作(比如在EditText上打字)。最后会在Android Studio输出通过和失败的测试结果。

Github下载测试源码


9.祝贺

我们希望你能喜欢本篇教程,并且开始着手测试你的应用程序。接着你可以学习如下内容:

出处 在Android Studio中进行单元测试和UI测试

Android Studio增加单元测试

目前最新版本的Android Studio(1.3.1)默认对测试是支持的,所以现在不需要在build.gradle中添加任何的设置语句。

对于以前的项目新增单元测试的情况,其实非常的简单,只需要在"工程目录->app->src"目录下面新建"androidTest",然后新建与项目目录完全相同的目录即可,如下图所示:

Android_Studio_Unit_Test

至于运行单元测试的方式,"app" 目录右击,点击菜单中的“Run All Test”即可,如下图所示:

Android_Studio_Run_Debug_Unit_Test

 

如果需要单独测试某个文件,则只需要在对应的测试文件中右击,选择运行即可,如下图:

Android_Studio_Unit_Test_Sigle_File

Android Studio 1.2 开发JNI工程

  • 添加native接口

注意写好native接口和System.loadLibrary()即可了,并无特别之处。

  • 执行Build->Make Project

20141215184150750
这一步骤执行一下,验证工程中并无其它错误,并对工程进行了编译,生成了.class文件.
.class文件的生成路径是在 app_path/build/intermediates/classes/debug下的.如下图:20141215184245654

  • javah生成c头文件

点击"View->Tool Windows->Terminal",即在Studio中进行终端命令行工具.执行如下命令生成c语言头文件。
这里需要注意的是要进入 \app\src\main的目录下执行javah命令,为的是生成的 .h 文件同样是在\app\src\main路径下,可以在Studio的工程结构中直接看到。

最后的生成结果:20141215184427109

  • 编辑c文件

在main.c文件中实现头文件中的方法,具体功能为直接return回一个String,并且使用android_log打印出相关日志。
代码如下:

    •  配置NDK

20141215184556957

  • Jni目录下手工创建Application.mk

里面内容如下:

  • Jni目录下手工创建Android.mk

再执行"Build->Rebuild Project",就可以编译出so文件了.

如果

Android_studio_jni

跟我的代码布局类似,增加了一个include目录,里面包含引用的第三方头文件,那么就比较折腾,因为编译的时候会报告找不到头文件,而通过设置

是可以通过命令行编译通过的,但是却不能在Gradle中编译通过。

这种情况下,需要放弃Android Studio 自带的配置,修改app目录下的“build.gradle”

原始内容如下:

修改后的内容如下:

参考 http://blog.csdn.net/sodino/article/details/41946607

Android Studio *.jar 与 *.aar 的生成与*.aar导入项目方法

Android Studio的一个好处在于Android函数库包格式“aar”格式。以前,Android函数库通常需要被导入到IDE以此将App需要的资源加入编译。但是现在的Android函数库可以被直接包含,与“jar”文件被Java项目包含的方式类似。这项功能虽然出现已久,但确实非常受欢迎。

  • Android Studio新建一个Library

1.点击“New Module”

Android_Studio_New_Module_Menu

2.选中新建“Android Library”Android_Studio_New_Module_Libary_Wards

3.根据向导一步一步继续下去就可以了。

  • 简单介绍

在Android Studio中对一个自己库进行生成操作时将会同时生成*.jar与*.aar文件。

分别存储位置:

*.jar:库 /build/intermediates/bundles/debug(release)/classes.jar

*.aar:库 /build/outputs/aar/libraryname.aar

两者区别:

*.jar: 只包含了class文件与清单文件 ,不包含资源文件,如图片等所有res中的文件。

*.aar: 包含所有资源 ,class以及res资源文件全部包含

如果你只是一个简单的类库那么使用生成的*.jar文件即可;如果你的是一个UI库,包含一些自己写的控件布局文件以及字体等资源文件那么就只能使用*.aar文件。

使用方式:

*.jar:拷贝到:libs目录,eclipse直接导入即可,AndroidStudio项目中添加:

重新编译一次项目既可完成加载。

*.aar:有两种方式,分别为本地加载以及网络加载,由于网络加载涉及到发布到mavenCentral托管的问题这里不做讨论;另外eclipse很久没有使用了也不做讨论;在这里给大家说一种本地加载的方式,简单快捷。

这里演示的aar文件为: “genius.aar”

第一步:拷贝到:libs目录

第二步:build.gradle 配置文件中更改为

分别添加了 “repositories” 与更改了 “dependencies” ,然后重新编译一次项目就可以正常使用了。

这时打开你的项目地址 “\build\intermediates\exploded-aar\” 你会发现下面多了一个文件夹 “genius”打开后能看见里边包含了一个 “classes.jar” 文件与一些 资源文件和“R.txt”文件 。

r6BBviN

这就是Android Studio自动解析了aar文件后出现的东西。

对于比较常见的项目配置,有如下的参考,可以看到带版本号的情况,使用的aar跟jar文件还是有差别的,aar文件,最后要增加一个“@aar”的标记。

参考链接


[Android][Android Studio] *.jar 与 *.aar 的生成与*.aar导入项目方法

Crosswalk入门

Crosswalk是一款开源的WEB引擎。目前Crosswalk正式支持的移动操作系统包括Android和Tizen,在Android 4.0及以上的系统中使用Crosswalk的Web应用程序在HTML5方面可以有一致的体验,同时和系统的整合交互方面(比如启动画面、权限管理、应用切换、社交分享等等)可以做到类似原生应用。现在Crosswalk已经成为众多知名HTML5平台和应用的推荐引擎,包括Google Mobile Chrome App、Intel XDK、Famo.us和Construct2等等,未来的Cordova 4.0也计划集成Crosswalk。

下载的时候有些小迷茫,不知道应该下载哪个,入门的话,还是使用下图的稳定版本好了。
CrossViewDownload

  • 集成到应用中

1.下载zip包,然后参考 Android Studio如何Import Module 即项目依赖(针对非Gradle项目,以Crosswalk为例) 中的介绍,建立Android Studio工程,并且导入到项目中。

2.在AndroidManifest.xml中增加如下权限

使用XWalkView必须开启硬件加速,修改AndroidManifest.xml

  • 基本使用

Crosswalk中用来替代WebView的控件叫XWalkView

1.layout文件写法

2.代码中使用
和其他Android的控件不同,这个类需要监听系统事件。例如:生命周期、intent、Activity result。
控件内置的Web引擎需要获取并处理这些信息。并且当XWalkView 不再需要使用的时候,在onDestroy方法中XWalkView必须显式的调用destroy方法,否则容易造成Web引擎的内存泄漏。

3.loadUrl去哪了?

上面的代码中其实已经剧透了,使用load方法即可。

4.WebViewClient?

对应WebView的WebViewClient,XWalkView中有XWalkResourceClient。

  • 调用JavaScript

不像WebView一样获取setting设置setJavaScriptEnabled为true才能执行。
Crosswalk可以直接执行js。

当然,按照Kitkat引入的方式,使用evaluateJavascript方法也是可以的。(大神们推荐)

  • JavaScript回调Java

  1. 定义js回调接口

    Caution: If you've set your targetSdkVersion to 17 or higher, you must add the @JavascriptInterface annotation to any method that you want available to your JavaScript (the method must also be public). If you do not provide the annotation, the method is not accessible by your web page when running on Android 4.2 or higher.
    From developer.android.com

    备注:这里的

    所在的包是

  2. XWalkView设置JavaScript可用且绑定对象

  3. 调用html执行JavaScript或直接执行Javascript调用Java

    index.html源码:

  • 高级使用

调试

Kitkat开始,Android提供了和Chrome联调功能。可以很方便的在Chrome中调试WebView中的代码。
Crosswalk使用Chromium内核当然也具备这个功能。
开启调试的语句如下:

对于Crosswalk来说,这个设置是全局的。

使用动画或者设置隐藏可见注意

默认XWalkView不能使用动画,甚至setVisibility也不行。

XWalkView represents an Android view for web apps/pages. Thus most of attributes for Android view are valid for this class. Since it internally uses android.view.SurfaceView for rendering web pages by default, it can't be resized, rotated, transformed and animated due to the limitations of SurfaceView. Alternatively, if the preference key ANIMATABLE_XWALK_VIEW is set to True, XWalkView can be transformed and animated because TextureView is intentionally used to render web pages for animation support. Besides, XWalkView won't be rendered if it's invisible.

开启动画模式:

由于设置也像调试一样是全局的,在onDestroy时记得关闭。

暂停JS timer

html代码

XWalkView对应方法:

这也在防止内存泄漏,监听系统事件示例代码中提到过:

历史记录

自动视频暂停

loadAppFromManifest

manifest.json

参考链接


Android Studio如何Import Module 即项目依赖(针对非Gradle项目,以Crosswalk为例)

我们要写一个使用CrosswalkWebView的项目,就要依赖Crosswalk的工程,在Eclipse中存在Workspace的概念,对应到Android Studio 就变成了Module.

我们下载到的Crosswalk-WebView的工程是Eclipse建立的项目,此时项目是不能被Android Studio直接引用的,因此需要导入成Android Studio项目的一个Module。

  • 导入Module

1.选择"Import Module"菜单

选择导入Android Studio项目的一个Module
选择导入Android Studio项目的一个Module

2.选择项目的路径,并且重命名 Module Name

导入项目路径并且重命名Module的名字
导入项目路径并且重命名Module的名字

3.完成导入

导入项目的最后一步
导入项目的最后一步

4.查看导入完成后的项目中,出现了新导入的 "CrosswalkWebview",实质上是拷贝了所需要的文件到工程的目录中

导入完成后的模块,出现在工程中
导入完成后的模块,出现在工程中

  • 设置Module之间项目依赖

1.选择"Open Module Settings"
Config_Module_Settings

2.设置模块依赖Module_Depends_Setting

3.选择依赖的ModuleModule_Depends_Select

4.选中依赖的模块,点击“OK”Checked_Selected_Modules

国内Android SDK 镜像

最近更新Android SDK的时候奇慢无比,频繁失败,到了无法使用的地步,搜索了一下找到一个比较好用的国内镜像。
北京化工大学镜像站 http://ubuntu.buct.edu.cn/

Android镜像设置如下
1.点击选项
android-step-1

2.代理服务器填写ubuntu.buct.edu.cn或ubuntu.buct.cn或ubuntu.buct6.edu.cn(IPv6),端口80,强制HTTP
注:该代理并非正向代理也不是反向代理,所有代理请求将被重定向至本站镜像

android-step-2
3.关闭SDK Manager

android-step-3
4.单击Reload,选择需要的组件,即可安装

android-step-4

Android Studio中创建keystore

一直在Eclipse中开发Android,切换到Android Studio中之后,各种不习惯。基本的创建keystore文件的操作也是找了半天才找到。

1.点击Build ,在下拉框中选择 "Generate Signed APK"

Signed_APK

2.选择 "Create new"

New_APK_Wizard

3.按照里面的内容填写即可,注意最后文件的扩展名变为".jks",而不是以前的".keystore".

New_Key_Store

注意:最新的Android Studio 4.x版本已经没办法按照上面的办法创建证书了,创建证书会报告如下错误:

解决方法是在Android Studio的命令行中执行证书创建命令,创建pkcs12格式的证书,如下:

参考下图:

根据提示,补充内容即可。

Android Studio中使用证书:

参考链接


使用keytool 生成证书

升级到OS X Yosemite后 Android Studio启动崩溃 Symbol not found: _CGContextSetAllowsAcceleration

Mac OS 升到Yosemite后, 打开 Android Studio报

解决方法,是重新安装Apple的Java支持:
Apple官网下载或者本站下载