调试 Web 应用

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

注意： 您还可以使用 Chrome 开发者工具在 WebView 中远程调试网页。如需了解详情，请参阅远程调试 WebView。

在 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;
    }
});

警告 ：请勿在控制台消息中包含个人身份信息 (PII)。

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

注意： Logcat 是一个用于转储系统消息日志的工具。具体消息包括设备抛出错误时的堆栈轨迹，以及从应用写入和使用 JavaScript console API 写入的日志消息。如需了解详情，请参阅使用 Logcat 查看日志。

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

• 远程调试 Android 设备
• 调试应用

测试实验性 Web 功能

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

为此，请按以下步骤操作：

1. 安装 WebView 预发布渠道之一（Beta 版、开发者版或 Canary 版）{: .external}。

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

3. 点击 WebView DevTools 启动器：

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

4. 在 DevTools 中，点击标志，然后搜索您要启用或停用的任何实验性功能。此更改会应用于设备上的所有 WebView 实例。

5. 停止并重启应用，即可开始使用新功能进行测试。

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