调试 Web 应用程序

您可以使用 console JavaScript API 调试 JavaScript 并查看 Logcat 中的输出消息。如果您熟悉使用 Firebug 或 Web Inspector 调试网页,那么您可能熟悉使用 console(例如 console.log())。Android 的 WebKit 框架支持大多数相同的 API,因此您可以在 WebView 中调试时接收来自网页的日志。本主题介绍如何使用 console API 进行调试。

在 WebView 中使用 console API

WebView 中调试时,也支持 console API。您必须提供一个 WebChromeClient,它实现 onConsoleMessage() 方法,以便 console 消息显示在 Logcat 中。然后,使用 setWebChromeClient()WebChromeClient 应用于您的 WebView。有关更多信息,请参阅 WebView 文档。

以下示例演示如何在 WebView 中使用 console API

Kotlin

val myWebView: WebView = findViewById(R.id.webview)
myWebView.webChromeClient = object : WebChromeClient() {

    override fun onConsoleMessage(message: ConsoleMessage): Boolean {
        Log.d("MyApplication", "${message.message()} -- From line " +
              "${message.lineNumber()} of ${message.sourceId()}")
        return true
    }
}

Java

WebView myWebView = findViewById(R.id.webview);
myWebView.setWebChromeClient(new WebChromeClient() {
    @Override
    public boolean onConsoleMessage(ConsoleMessage consoleMessage) {
        Log.d("MyApplication", consoleMessage.message() + " -- From line " +
        consoleMessage.lineNumber() + " of " + consoleMessage.sourceId());
        return true;
    }
});

ConsoleMessage 还包含一个 MessageLevel 对象,用于指示要传递的 console 消息的类型。您可以使用 messageLevel() 查询消息级别以确定消息的严重程度,然后使用适当的 Log 方法或采取其他适当的操作。

无论您使用的是 onConsoleMessage(String, int, String) 还是 onConsoleMessage(ConsoleMessage),当您在网页中执行 console 方法时,Android 会调用适当的 onConsoleMessage() 方法,以便您可以报告错误。例如,使用上面的示例代码,打印的 Logcat 消息如下所示

Hello World -- From line 82 of http://www.example.com/hello.html

以下是与调试相关的其他资源

测试实验性 Web 功能

与 Google Chrome 的 chrome://flags 页面类似,您也可以在 WebView 中测试实验性 Web 功能。

为此,请执行以下步骤

  1. 安装 WebView 预发布通道之一(beta、dev 或 canary){: .external}。

  2. 将测试设备上的 WebView 通道切换 为已安装的预发布通道。

  3. 单击 WebView DevTools 启动器


    图 1. 在设备上安装的应用的 WebView DevTools 图标。

  4. 在 DevTools 中,单击 Flags 并搜索您要启用或禁用的任何实验性功能。该更改将应用于设备上的所有 WebView 实例。

  5. 停止并重新启动您的应用以开始使用新功能进行测试。

有关切换标志的更多信息,请参阅 WebView DevTools 文档