远程调试 WebView

使用 Chrome 开发者工具在您的原生 Android 应用中调试 WebView。

在 Android 4.4 (KitKat) 或更高版本中,使用开发者工具调试原生 Android 应用中的 WebView 内容。

摘要

  • 在原生 Android 应用中启用 WebView 调试;在 Chrome 开发者工具中调试 WebView。
  • 通过 chrome://inspect 访问已启用调试的 WebView 列表。
  • 调试 WebView 的方法与通过远程调试调试网页相同。

配置 WebView 以进行调试

必须在您的应用中启用 WebView 调试。如需启用 WebView 调试,请对 WebView 类调用静态方法 setWebContentsDebuggingEnabled

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    WebView.setWebContentsDebuggingEnabled(true);
}

此设置适用于应用的所有 WebView。

提示:WebView 调试不会受应用清单中 debuggable 标志的状态影响。如果您只想在 debuggabletrue 时启用 WebView 调试,请在运行时测试该标志。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    if (0 != (getApplicationInfo().flags & ApplicationInfo.FLAG_DEBUGGABLE))
    { WebView.setWebContentsDebuggingEnabled(true); }
}

在开发者工具中打开 WebView

chrome://inspect 页面会显示您设备上已启用调试的 WebView 的列表。

如需开始调试,请点击要调试的 WebView 下方的 inspect。使用开发者工具就像使用远程浏览器标签页一样。

在 WebView 中检查元素

与 WebView 一起列出的灰色图形表示 WebView 的大小和相对于设备屏幕的位置。如果您的 WebView 已设置标题,标题也会一并列出。

问题排查

chrome://inspect page 上看不到您的 WebView?

  • 验证是否已为您的应用启用 WebView 调试。
  • 在设备上,打开包含要调试的 WebView 的应用。然后,刷新 chrome://inspect 页面。