调试 Web 应用

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

在 WebView 中使用控制台 API

WebView 中调试时,也支持控制台 API。您必须提供实现 onConsoleMessage() 方法的 WebChromeClient,以便控制台消息显示在 Logcat 中。然后,使用 setWebChromeClient()WebChromeClient 应用于 WebView。如需了解详情,请参阅 Webview 文档。

以下示例展示了如何在 WebView 中使用控制台 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 对象,用于指示传送的控制台消息的类型。您可以使用 messageLevel() 查询消息级别,以确定消息的严重性,然后使用适当的 Log 方法或采取其他适当的操作。

无论您使用的是 onConsoleMessage(String, int, String) 还是 onConsoleMessage(ConsoleMessage),当您在网页中执行控制台方法时,Android 都会调用相应的 onConsoleMessage() 方法,以便您报告错误。例如,使用上面的示例代码,系统会输出如下所示的 Logcat 消息:

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

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

测试实验性网页功能

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

为此,请按以下步骤操作:

  1. 安装某个 WebView 预发布版本(Beta 版、开发者版或 Canary 版){: .external}。

  2. 将测试设备上的 WebView 版本切换到已安装的预发布版本。

  3. 点击 WebView 开发者工具启动器:


    图 1. 设备上安装的应用的 WebView 开发者工具图标。

  4. 在开发者工具中,点击标志并搜索要启用或停用的任何实验性功能。此更改适用于设备上的所有 WebView 实例。

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

如需详细了解如何切换标志,请参阅 WebView 开发者工具文档