Android 2.3提供一个称为严苛模式(StrictMode)的调试特性,Google称该特性已经使数百个Android上的Google应用程序受益。它将报告与线程及虚拟机相关的策略违例。一旦检测到策略违例(policy violation),将获得警告,其包含了一个栈trace显示你的应用在何处发生违例。可以强制用警告代替崩溃(crash),也可以仅将警告计入日志,让你的应用继续执行
StrictMode最常用来捕捉应用程序的主线程,它将报告与线程及虚拟机相关的策略违例。一旦检测到策略违例(policy violation),你将获得警告,其包含了一个栈trace显示你的应用在何处发生违例。除了主线程,我们还可以在Handler,AsyncTask,AsyncQueryHandler,IntentService等API中使用StrictMode
目前有2种策略可用,第一个和线程相关,它主要针对主线程(或UI线程)。由于在主线程中读写磁盘和进行网络访问都不是好的做法,Google已经在磁盘和网络代码中添加了严苛模式(StrictMode)钩子(hook)。如果你对某个线程打开严苛模式(StrictMode),当那个线程进行磁盘和网络访问,你将获得警告。你可以选择警告方式。一些违例包含用户慢速调用(custom slow calls 这么翻译行吗?),磁盘读写,网络访问。你能选择将警告写入LogCat,显示一个对话框,闪下屏幕,写入DropBox日志文件,或让应用崩溃。最通常的做法是写入LogCat或让应用崩溃。如下代码是一个为线程策略设置严苛模式(StrictMode)的例子:
StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder()
.detectDiskReads()
.detectDiskWrites()
.penaltyDialog()
.detectNetwork()
.penaltyLog()
.build());
Builder类 使得设置变得很简单,Builder函数定义所有策略都返回Builder对象,从而这些函数能像列表那样串连在一起。最后调用build()函数返回一个ThreadPolicy对象作为StrictMode对象的setThreadPolicy()函数的参数
注:1> setThreadPolicy()是一个静态函数,因此不需要实例化StrictMode对象。在内部,setThreadPolicy()将对当前线程应用该策略。如果不指定检测函数,也可以用detectAll()来替代。penaltyLog()表示将警告输出到LogCat,可以使用其他或增加新的惩罚(penalty)函数,例如使用penaltyDeath()的话,一旦StrictMode消息被写到LogCat后应用就会崩溃
2> 不要频繁打开严苛模式(StrictMode),可以在主活动的 onCreate()函数中打开它,也可以在Application派生类的OnCreate()函数中设置严苛模式(StrictMode)。线程中运行的任何代码都可以设置严苛模式(StrictMode),但注意只需要设置一次,一次就够了
类似于线程策略(ThreadPolicy),严苛模式(StrictMode)有虚拟机策略(VmPolicy)。虚拟机策略(VmPolicy)能检查内存泄漏,譬如,当关闭一个SQLite对象前的完结操作,或其他任何类似可关闭对象在关闭前的完结操作。虚拟机策略(VmPolicy)由一个类似的 Builder类创建,如下代码所示。和线程策略(ThreadPolicy)不同的是,虚拟机策略(VmPolicy)不能通过一个对话框提供警告。如下代码中设置严苛模式(StrictMode)的虚拟机策略:
StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
.detectLeakedSqlLiteObjects()
.detectLeakedClosableObjects()
.penaltyLog()
.penaltyDeath()
.build());
因为设置发生在线程中,严苛模式(StrictMode)甚至能在从一个对象到另一个对象的控制流中找到违例事件。当违例发生,你会惊奇地注意到代码正运行于主线程,而栈trace将帮助你发现它如何发生。于是能单步调试解决问题,或是将代码移到它自己的后台线程,或是就保持原来的处理方式。这都取决与你。当然,可能希望适时关闭严苛模式(StrictMode),当你的程序作为产品发布时,可不希望它仅为了一个警告在你的用户手里崩溃
有两个方法可以关闭严苛模式(StrictMode),最直接的就是移除相应代码,但这样做不利于持续开发的产品。通常可以定义一个应用级别布尔变量来测试是否需要调用严苛模式(StrictMode)代码。在发布产品前将这个值定义为FALSE。更优雅的方式是利用调试模式(debug mode)的特点,在AndroidManifest.xml中定义这个布尔变量。<application>字段的属性之一是android:debuggable,其义自明。如下代码中给出了利用该特性的控释方法
// Return if this application is not in debug mode
ApplicationInfo appInfo = context.getApplicationInfo();
int appFlags = appInfo.flags;
if ((appFlags & ApplicationInfo.FLAG_DEBUGGABLE) != 0) {
// Do StrictMode setup here
StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
.detectLeakedSqlLiteObjects()
.penaltyLog()
.penaltyDeath()
.build());
}
使用Eclipse调试环境,ADT自动为设置debuggable属性,使项目更易于管理。当你在模拟器上或直接在设备上部署应用,debuggable属性为TRUE,当你导出应用建立一个产品版本,ADT将该属性置为FALSE
注:如果你另行设置了这个属性值,ADT不会改变它
严苛模式(StrictMode)很不错,不过在 Android 2.3 之前的版本上该模式不工作。为了避免这个问题,要在 StrictMode对象 还不存在的时候就验证版本是否在 Android2.3 及以上。能利用反射技术(reflection),当严苛模式(StrictMode)函数有效时间接调用它,反之不去调用。方法很简单,按如下代码处理,利用反射技术(reflection)调用严苛模式(StrictMode)
try {
Class sMode = Class.forName("android.os.StrictMode");
Method enableDefaults = sMode.getMethod("enableDefaults");
enableDefaults.invoke(null);
} catch(Exception e) {
// StrictMode not supported on this device, punt
Log.v("StrictMode", "... not supported. Skipping...");
}
当严苛模式(StrictMode)不存在,将捕捉到ClassNotFoundException异常。enableDefault()是严苛模式(StrictMode)类的另一个函数,它检测所有违例并写入LogCat。因为这里调用的是静态形式的enableDefault(),所以用 null 作为参数传入
某些时候不希望报告所有违例。那在主线程之外的其他线程中设置严苛模式(StrictMode)很不错。譬如,需要在正在监视的线程中进行磁盘读取。此时,要么不去调用detectDiskReads(),要么在调用detectAll()之后跟一个permitDiskReads()。类似允许函数也适用于其他操作。但要是你要在Anroid2.3之前版本上做这些事,有办法吗?当然有。当应用中严苛模式(StrictMode)无效,如果你试图访问它,将抛出一个VerifyError异常。如果你将严苛模式(StrictMode)封装在一个类里,并捕捉这个错误,当严苛模式(StrictMode)无效时,你能忽略它。如下代码显示一个简单的严苛模式(StrictMode)封装类StrictModeWrapper。如下代码显示了如何在你的应用中使用这个封装类
import android.content.Context;
import android.content.pm.ApplicationInfo;
import android.os.StrictMode;
public class StrictModeWrapper {
public static void init(Context context) {
// check if android:debuggable is set to true
int appFlags = context.getApplicationInfo().flags;
if ((appFlags & ApplicationInfo.FLAG_DEBUGGABLE) != 0) {
StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy
.Builder()
.detectDiskReads()
.detectDiskWrites()
.detectNetwork()
.penaltyLog()
.build());
StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder()
.detectLeakedSqlLiteObjects()
.penaltyLog()
.penaltyDeath()
.build());
}
}
}
StrictMode实例
在测试代码的主线程中去访问网络,一定会触发StrictMode的线程监测,示例代码如下:
public class MainActivity extends Activity {
private HttpResponse httpResponse = null;
private HttpEntity httpEntity = null;
private TextView mTextView;
@Override
protected void onCreate(Bundle savedInstanceState) {
StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder()
.detectDiskReads()
.detectDiskWrites()
.detectNetwork()
.penaltyDialog()
.penaltyLog()
.build());
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mTextView = (TextView) findViewById(R.id.text);
HttpGet httpGet = new HttpGet("http://www.baidu.com");
HttpClient httpClient = new DefaultHttpClient();
InputStream inputStream = null;
try {
httpResponse = httpClient.execute(httpGet);
httpEntity = httpResponse.getEntity();
if (httpResponse.getStatusLine().getStatusCode() == 200) {
inputStream = httpEntity.getContent();
BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
mTextView.setText(reader.readLine());
}
} catch (Exception e) {
e.printStackTrace();
} finally {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
运行代码,并将Log信息保存到本地,在Log中,我们可以搜索D/StrictMode(15454): StrictMode policy violation关键字
Log中可以显示出 StrictMode 提示的原因,通过这里的 TraceLog 就可以来找到优化的方法。除了在Logcat中查看StrictMode 的日志信息,如果使用 penaltyDropbox()方法,那么还可以通过如下所示的命令来调用DropBoxManager观察StrictMode日志:
adb shell dumpsys dropbox data_app_strictmode --print
使用penaltyDialog()方法,在应用中还会弹出如下所示的提示框:
暂停监测实例
如果在程序运行中无法避免的会违反StrictMode中的一些定义好的策略,而又希望能够暂时忽略这些策略的监视,可以使用permitXXXXX方法来暂停这些内容的监测,在做完需要忽略的监测之后,再起用监测,代码如下所示:
StrictMode.ThreadPolicy old = StrictMode.getThreadPolicy();
StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder(old)
.permitDiskWrites()
.build());
// doSomethingWriteToDisk();
StrictMode.setThreadPolicy(old);