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」inspect。使用開發人員工具 方法與遠端瀏覽器分頁相同

在 WebView 中檢查元素

與 WebView 一併列出的灰色圖形,代表其大小和位置相對於裝置螢幕的位置。如果您的 WebView 已設定標題,則也會列出標題。

疑難排解

chrome://inspect 頁面上找不到 WebView 嗎?

  • 確認應用程式已啟用 WebView 偵錯功能。
  • 在裝置上開啟要偵錯的 WebView 應用程式。然後重新整理 chrome://inspect 頁面。