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