Android Web App官方文檔翻譯第四章：調試

文檔內容
在Android Browser中使用控制台API
在WebView中使用控制台API
參考
調試
如果你是在為Android開發web應用，那麼，你可以使用控制台(console)的JavaScript API(the console JavaScript APIs)來調試你的Javascript代碼並將信息輸出到logcat。如果你對使用Firebug 或 Web Inspector調試web頁面比較熟悉，那麼，你對使用console(比如console.log())也應該比較熟悉了。Android的Webkit框架支持大多數同樣的API，因此在Android的浏覽器中或者WebView中調試的時候，你可以接收來自於web頁面的logs。
在Android Browser中使用控制台API
Logcat
Logcat是一個工具，用來轉儲(dump)系統信息日志。這些信息包括設備拋出錯誤時的堆棧路徑，以及你的應用寫下的日志信息和使用JavaScript console API寫下的日志信息。
要運行logcat並查看信息，從你的Android SDK tools/目錄執行adb logcat ，或者從DDMS選擇 Device > Run logcat。當使用 ADT plugin for Eclipse時，你同樣可以通過打開Logcat view來查看logcat信息，打開途徑是 Window > Show View > Other > Android > Logcat.。
在 Debugging你可以獲取更多關於<codelogcat< code=”">.</codelogcat<>的信息。
當你調用一個console函數(在DOM的window.console對象中)，輸出會出現在logcat中。例如：如果你的web頁面執行了下面的Javascript：
console.log("Hello World");
那麼logcat 信息看起來就是類似於下面的樣子：
Console: Hello World http://www.example.com/hello.html :82
在各個信息的格式根據Android版本的不同可能看起來會有不同。在Android 2.1及更高，來自於Android Browser的console信息會標記為”browser”。在Android 1.6及更低版本，AndroidBrowser信息則是標記為”WebCore”。
Android的WebKit並沒有實現在桌面版浏覽器中所實現的所有console API。但是，你可以使用下面的基本的文本日志函數(text logging function)：
console.log(String)
console.info(String)
console.warn(String)
console.error(String)
其他一些console函數不產生錯誤，但是它的行為與你在其他web浏覽器中預期的行為可能不一樣。
在WebView中使用控制台API  www.2cto.com
如果你在應用中實現了一個定制的WebView，那麼，當你在WebView中調試你的web頁面的時候，所有相同的console API也是被支持的。在Android 1.6及更低版本，console信息是自動發送給logcat的，並加上了”WebCore”日志標簽。如果你是為Android 2.1(API Level 7)及更高版本開發，那麼就必須提供一個實現了onConsoleMessage() 回調方法的WebChromeClient，以便讓console信息顯示在logcat中。
另外，在API Level 7中引入的onConsoleMessage(String, int, String)方法已經棄用了，而在API Level 8中使用的是onConsoleMessage(ConsoleMessage)。
無論你是在為Android 2.1(API Level 7) 或 Android 2.2 (API Level 8 或更高)開發，你都需要實現WebChromeClient 並覆蓋onConsoleMessage() 回調方法。然後，使用setWebChromeClient()將WebChromeClient應用到你的WebView 中。
如果是使用 API Level 7,那麼是使用 onConsoleMessage(String, int, String)的代碼看起來可能是下面這個樣子：
WebView myWebView = (WebView) findViewById(R.id.webview);
myWebView.setWebChromeClient(new WebChromeClient() {
public void onConsoleMessage(String message, int lineNumber, String sourceID) {
Log.d("MyApplication", message + " -- From line "
+ lineNumber + " of "
+ sourceID);
}
});
如果是使用API Level 8或更高版本， 那麼你使用 onConsoleMessage(ConsoleMessage)代碼看起來可能是下面的樣子：
WebView myWebView = (WebView) findViewById(R.id.webview);
myWebView.setWebChromeClient(new WebChromeClient() {
public boolean onConsoleMessage(ConsoleMessage cm) {
Log.d("MyApplication", cm.message() + " -- From line "
+ cm.lineNumber() + " of "
+ cm.sourceId() );
return true;
}
});
ConsoleMessage 還包括 MessageLevel來指示出發送的console 信息的類型。你可以通過 messageLevel()來查詢信息層次(message level)，以便確定信息重要性，然後再使用合適的Log方法或采用其他合適的行動。
無論你是使用 onConsoleMessage(String, int, String) 還是 onConsoleMessage(ConsoleMessage)，當你在web頁面中執行一個console方法時，Android會調用合適的 onConsoleMessage()方法，以便你能報告錯誤。例如，采用上面的示例代碼，一個logcat信息打印出來可能是下面這個樣子的：
Hello World -- From line 82 of http://www.example.com/hello.html