Android Web App官方文檔翻譯第四章：調試
文檔內容
參考
如果你是在為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
如果你在應用中實現了一個定制的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 |
