Android Web App官方文档翻译第四章：调试

文档内容

在AndroidBrowser中使用控制台API

在WebView中使用控制台API

参考

调试

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

在AndroidBrowser中使用控制台API

Logcat

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

要运行logcat并查看信息，从你的AndroidSDKtools/目录执行adblogcat，或者从DDMS选择Device>Runlogcat。当使用ADTpluginforEclipse时，你同样可以通过打开Logcatview来查看logcat信息，打开途径是Window>ShowView>Other>Android>Logcat.。

在Debugging你可以获取更多关于<codelogcat<code=”">.</codelogcat<>的信息。

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

console.log("HelloWorld");

那么logcat信息看起来就是类似于下面的样子：

Console:HelloWorldhttp://www.example.com/hello.html:82

在各个信息的格式根据Android版本的不同可能看起来会有不同。在Android2.1及更高，来自于AndroidBrowser的console信息会标记为”browser”。在Android1.6及更低版本，AndroidBrowser信息则是标记为”WebCore”。

Android的WebKit并没有实现在桌面版浏览器中所实现的所有consoleAPI。但是，你可以使用下面的基本的文本日志函数(textloggingfunction)：

console.log(String) console.info(String) console.warn(String) console.error(String)

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

在WebView中使用控制台API

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

另外，在APILevel7中引入的onConsoleMessage(String,int,String)方法已经弃用了，而在APILevel8中使用的是onConsoleMessage(ConsoleMessage)。

无论你是在为Android2.1(APILevel7)或Android2.2(APILevel8或更高)开发，你都需要实现WebChromeClient并覆盖onConsoleMessage()回调方法。然后，使用setWebChromeClient()将WebChromeClient应用到你的WebView中。

如果是使用APILevel7,那么是使用onConsoleMessage(String,int,String)的代码看起来可能是下面这个样子：

WebViewmyWebView=(WebView)findViewById(R.id.webview);
myWebView.setWebChromeClient(newWebChromeClient(){
publicvoidonConsoleMessage(Stringmessage,intlineNumber,StringsourceID){
Log.d("MyApplication",message+"--Fromline"
+lineNumber+"of"
+sourceID);
}
});

如果是使用APILevel8或更高版本，那么你使用onConsoleMessage(ConsoleMessage)代码看起来可能是下面的样子：

WebViewmyWebView=(WebView)findViewById(R.id.webview);
myWebView.setWebChromeClient(newWebChromeClient(){
publicbooleanonConsoleMessage(ConsoleMessagecm){
Log.d("MyApplication",cm.message()+"--Fromline"
+cm.lineNumber()+"of"
+cm.sourceId());
returntrue;
}
});

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

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

HelloWorld--Fromline82ofhttp://www.example.com/hello.html