AndroidWebApp官方文档翻译第四章：调试

文档内容

在Android Browser中使用控制台API

在WebView中使用控制台API

参考

调试

如果你是在为Android开发web应用&＃xff0c;那么&＃xff0c;你可以使用控制台(console)的Javascript API(the console Javascript APIs)来调试你的Javascript代码并将信息输出到logcat。如果你对使用Firebug 或 Web Inspector调试web页面比较熟悉&＃xff0c;那么&＃xff0c;你对使用console(比如console.log())也应该比较熟悉了。Android的Webkit框架支持大多数同样的API&＃xff0c;因此在Android的浏览器中或者WebView中调试的时候&＃xff0c;你可以接收来自于web页面的logs。

在Android Browser中使用控制台API

Logcat

Logcat是一个工具&＃xff0c;用来转储(dump)系统信息日志。这些信息包括设备抛出错误时的堆栈路径&＃xff0c;以及你的应用写下的日志信息和使用Javascript console API写下的日志信息。

要运行logcat并查看信息&＃xff0c;从你的Android SDK tools/目录执行adb logcat &＃xff0c;或者从DDMS选择 Device > Run logcat。当使用 ADT plugin for Eclipse时&＃xff0c;你同样可以通过打开Logcat view来查看logcat信息&＃xff0c;打开途径是 Window > Show View > Other > Android > Logcat.。

在 Debugging你可以获取更多关于.的信息。

当你调用一个console函数(在DOM的window.console对象中)&＃xff0c;输出会出现在logcat中。例如&＃xff1a;如果你的web页面执行了下面的Javascript&＃xff1a;

那么logcat 信息看起来就是类似于下面的样子&＃xff1a;

在各个信息的格式根据Android版本的不同可能看起来会有不同。在Android 2.1及更高&＃xff0c;来自于Android Browser的console信息会标记为”browser”。在Android 1.6及更低版本&＃xff0c;AndroidBrowser信息则是标记为”WebCore”。

Android的WebKit并没有实现在桌面版浏览器中所实现的所有console API。但是&＃xff0c;你可以使用下面的基本的文本日志函数(text logging function)&＃xff1a;

其他一些console函数不产生错误&＃xff0c;但是它的行为与你在其他web浏览器中预期的行为可能不一样。

在WebView中使用控制台API

如果你在应用中实现了一个定制的WebView&＃xff0c;那么&＃xff0c;当你在WebView中调试你的web页面的时候&＃xff0c;所有相同的console API也是被支持的。在Android 1.6及更低版本&＃xff0c;console信息是自动发送给logcat的&＃xff0c;并加上了”WebCore”日志标签。如果你是为Android 2.1(API Level 7)及更高版本开发&＃xff0c;那么就必须提供一个实现了onConsoleMessage() 回调方法的WebChromeClient&＃xff0c;以便让console信息显示在logcat中。

另外&＃xff0c;在API Level 7中引入的onConsoleMessage(String, int, String)方法已经弃用了&＃xff0c;而在API Level 8中使用的是onConsoleMessage(ConsoleMessage)。

无论你是在为Android 2.1(API Level 7) 或 Android 2.2 (API Level 8 或更高)开发&＃xff0c;你都需要实现WebChromeClient 并覆盖onConsoleMessage() 回调方法。然后&＃xff0c;使用setWebChromeClient()将WebChromeClient应用到你的WebView 中。

如果是使用 API Level 7,那么是使用 onConsoleMessage(String, int, String)的代码看起来可能是下面这个样子&＃xff1a;

1. WebView myWebView &＃61; (WebView) findViewById(R.id.webview); 
2. myWebView.setWebChromeClient(new WebChromeClient() { 
3. public void onConsoleMessage(String message, int lineNumber, String sourceID) { 
4. Log.d("MyApplication", message &＃43; " -- From line " 
5. &＃43; lineNumber &＃43; " of " 
6. &＃43; sourceID); 
7. } 
8. }); 

如果是使用API Level 8或更高版本&＃xff0c; 那么你使用 onConsoleMessage(ConsoleMessage)代码看起来可能是下面的样子&＃xff1a;

1. WebView myWebView &＃61; (WebView) findViewById(R.id.webview); 
2. myWebView.setWebChromeClient(new WebChromeClient() { 
3. public boolean onConsoleMessage(ConsoleMessage cm) { 
4. Log.d("MyApplication", cm.message() &＃43; " -- From line " 
5. &＃43; cm.lineNumber() &＃43; " of " 
6. &＃43; cm.sourceId() ); 
7. return true; 
8. } 
9. }); 

ConsoleMessage 还包括 MessageLevel来指示出发送的console 信息的类型。你可以通过 messageLevel()来查询信息层次(message level)&＃xff0c;以便确定信息重要性&＃xff0c;然后再使用合适的Log方法或采用其他合适的行动。

无论你是使用 onConsoleMessage(String, int, String) 还是 onConsoleMessage(ConsoleMessage)&＃xff0c;当你在web页面中执行一个console方法时&＃xff0c;Android会调用合适的 onConsoleMessage()方法&＃xff0c;以便你能报告错误。例如&＃xff0c;采用上面的示例代码&＃xff0c;一个logcat信息打印出来可能是下面这个样子的&＃xff1a;