Android Gradle系列(六)
这一章节我将遵循以下内容:
单元测试
功能测试
测试覆盖率
单元测试
相信大家都有了单元测试的概念,那么好的单元测试不仅仅能够确保app的质量,同时还可以让新代码开发更加容易。Android studio和gradle android插件默认支持单元测试,但是在你使用它之前,你仍需配置一下。
JUnit
JUnit测试界非常流行,其使得测试代码容易编写和维护,但是记住,JUnit只能测试逻辑代码,针对和Android SDK相关的代码其会报相应的错误。
在你开始编写junit测试之前,你需要为其新建一个目录。通常呢,这个会被叫做test,其会和你的main文件夹平级。
app
└─── src
├─── main
├─── java
│ └─── com.example.app
└─── res
└─── test
└─── java
└─── com.example.app
你可以在test目录下创建测试类。
我建议你使用JUnit 4,你可以将其作为依赖添加到你的依赖库。
dependencies {
testCompile 'junit:junit:4.12'
}
注意到你使用了testCompile,这意味着该jar包只会在你测试的时候导入apk。
如果你有其他的构建版本呢,而你又只是想为特定版本添加该jar,你只需要这么做:
dependencies {
testPaidCompile 'junit:junit:4.12'
}
当所有的事情都OK了,就是时候开始写测试代码了。下面是简单的测试代码:
import org.junit.Test;
import static org.junit.Assert.assertEquals;
public class LogicTest {
@Test
public void addingNegativeNumberShouldSubtract() {
Logic logic = new Logic();
assertEquals("6 + -2 must be 4", 4, logic.add(6, -2));
assertEquals("2 + -5 must be -3", -3, logic.add(2, -5));
}
}
那么如何跑起来呢,也很简单,运行gradlew test。如果你只是想再特定版本中跑呢,那就加一个呗gradlew testDebug。如果测试失败,gradle将会打印相关错误,如果所有测试成功通过,那么会显示BUILD SUCCESSFUL 。
可能你会说,单个测试用例导致整个测试失败,这样不好,如果你想把整个测试案例都跑一遍,那也很简单啊:
$ gradlew test --continue
执行测试任务不仅仅是跑完所有的测试,而且其还会为你创建一份测试报告,你可以找到它app/build/reports/tests/debug/index.html。这份报告让你能够更快的发现问题,我觉得最重要的是当你将你的测试自动化后,这会非常有用,gradle会为每个构建版本都创建一份测试报告。如果你执行测试成功,你的测试报告会是这个样子:
说了这么多原始的做法,那么看看Android studio怎么运行测试的吧。右键项目或者选择开始按钮。。这个太基础不多说了,运行成功是这个样子:
好了,junit测试讲完了,是不是很简单。
如果你想测试你的关联Android sdk代码怎么办,单元测试不是一个好主意,幸运的是,有多个依赖包供你选择,其中最出名的是Robolectric,其可以让你更方便的测试Android功能,并且还不用在设备或者模拟器上运行。
Robolectric
通过使用Robolectrie,你可以编写测试类,这些类可以使用Android SDK和资源文件,当然其还是跑在jvm上,这会让你测试app更加迅速。
在开始使用Robolectrie之前,你需要添加依赖。注意除了Robolectric依赖,你需要添加JUnit包。
apply plugin: 'org.robolectric'
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:22.2.0'
testCompile 'junit:junit:4.12'
testCompile'org.robolectric:robolectric:3.0'
testCompile'org.robolectric:shadows-support:3.0'
}
Robolectrie测试类也需要写在test文件夹下,举个例子:
@RunWith(RobolectricTestRunner.class)
@Config(manifest = "app/src/main/AndroidManifest.xml", sdk = 18)
public class MainActivityTest {
@Test
public void clickingButtonShouldChangeText() {
AppCompatActivity activity = Robolectric.buildActivity
(MainActivity.class).create().get();
Button button = (Button)
activity.findViewById(R.id.button);
TextView textView = (TextView)
activity.findViewById(R.id.label);
button.performClick();
assertThat(textView.getText().toString(), equalTo
(activity.getString(R.string.hello_robolectric)));
}
}
功能测试
神马是功能测试,其是用来测试一个app的多个模块是否能够正常工作。举个栗子,你可以创建一个功能测试来确保你点击某一按钮后是否会有一个新的activity。依然,我们会有很多框架。但是在这里,我推荐Espresso。
Espresso
google创建Espresso的目的就是在于简化开发人员编写功能测试用例。这个包是由Android support repository提供,所以你可以通过SDK Manager使用它。
在运行测试用例之前,你需要定义一个runner。google提供了AndroidJUnitRunner测试runner,这将帮助你在手机上运行Unit测试。测试runner可以帮你安装apk以及一个测试apk,执行所有测试,生成测试报告。
假设你下载了support library包,那么你需要这么定义:
defaultConfig {
testInstrumentationRunner
"android.support.test.runner.AndroidJUnitRunner"
}
当然你需要添加一些依赖包:
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:22.2.0'
androidTestCompile 'com.android.support.test:runner:0.3'
androidTestCompile 'com.android.support.test:rules:0.3'
androidTestCompile
'com.android.support.test.espresso:espresso-core:2.2'
androidTestCompile
'com.android.support.test.espresso:espresso-contrib:2.2'
}
注意到这些依赖包使用了androidTestCompile,其不同于testCompile。当你直接运行时,会报错:
Error: duplicate files during packaging of APK app-androidTest.apk
Path in archive: LICENSE.txt
Origin 1: ...\hamcrest-library-1.1.jar
Origin 2: ...\junit-dep-4.10.jar
其意思也很清楚,因为多个文件导致,你可以简单处理下:
android {
packagingOptions {
exclude 'LICENSE.txt'
}
}
注意:功能测试需要放在AndroidTest目录下,下面是测试用例:
@RunWith(AndroidJUnit4.class) @SmallTest public class TestingEspressoMainActivityTest { @Rule public ActivityTestRulemActivityRule = new
ActivityTestRule<>(MainActivity.class);
@Test
public void testHelloWorldIsShown() {
onView(withText("Hello world!")).check
(matches(isDisplayed()));
}
}
功能测试也有测试报告,当正确执行后,应该是这样的:
最后可能有朋友问,在Android studio中执行测试,那就附图吧:
测试覆盖率
一旦你在你的项目中使用到了测试,那么你肯定想知道你的测试覆盖量。很真实,依然有很多测试覆盖率工具,我推荐的是Jacoco。
Jacoco
有一份覆盖率报告,很简单。你只需要配置一下:
buildTypes {
debug {
testCoverageEnabled = true
}
}
当你执行完构建,你可以在app/build/ outputs/reports/coverage/debug/index.html中找到,每个版本都会有一个报告。测试覆盖率会是这样的: