android中断言_android-assert是一个非常简单轻量的android断言库。类似于junit的Assert类。...

一、简介

二、什么是断言，什么情况下应该使用androidAssert？

三、在release版本中移除断言代码，只在debug中保留

四、集成AndroidAssert库

五、API

一、简介

android-assert是一个非常简单轻量的android断言库。类似于junit的Assert类。

android-assert不是用来写测试用例的，可以直接在项目代码中使用他。

在debug模式下，断言失败将会抛出断言异常 AssertionFailedError，在release模式下，将不会抛出异常。

二、什么是断言，什么情况下应该使用androidAssert？

通常断言(assert)是用在单元测试，用来校验函数返回的结果。用在自动化测试用来校验程序运行结果。

但是我们接下来要讨论的并不是单元测试中使用断言，而是在项目业务代码中使用断言。

我们一起来看几个，大家非常熟悉的例子。这些情况下使用断言会让代码更加优雅，更加健壮。

例子1，writeFile

/**

* 我们希望只在子线程中调用writeFile()，主线程中调用可能会导致ui卡顿或者anr。

*

* 如果在主线程调用writeFile()，我们打印日志警告开发者

*/

public void writeFile() {

//主线程，打印日志警告开发者

if(!ThreadTypeUtil.isSubThread()){

Log.e(TG, "you should call writeFile at sub thread");

}

// write file ...

}

当出现有开发人员，尝试在主线程中调用writeFile()方法时，我们通过 日志警告 ，开发者。但是，日志提示很弱，往往会被开发者忽略掉。

于是我们改良了下代码：

public void writeFile() {

//debug版本，主线程中调用 writeFile ，直接抛出异常中断程序运行

if(!ThreadTypeUtil.isSubThread()){

if(BuildConfig.DEBUG) {

throw new RuntimeException("you should call writeFile at sub thread");

}

}

// write file ...

}

当程序员企图在主线程中调用writeFile()，在debug模式下，我们直接抛出异常，让程序崩溃。以中断他的开发。强制他