共用方式為


遠端除錯 Xbox WebView2 WinUI 2 (UWP) 應用程式

要使用 Microsoft Edge DevTools 除錯 WebView2 WinUI 2 (UWP) 應用程式,請使用遠端除錯。 遠端除錯是 WebView2 WinUI 2 (UWP) 應用程式所必需的,因為目前內建的 DevTools 無法在已簽署的 WebView2 WinUI 2 (UWP) 應用程式中啟動。

遠端將 DevTools 連接到 Xbox WebView2 WinUI 2 (UWP) 應用程式

Microsoft遠端將 Edge DevTools 連接到 Xbox WebView2 WinUI 2 (UWP) 應用程式,方法如下:

  1. 在 Microsoft Edge 中,請前往 edge://inspect使用邊緣開發者工具檢查頁面開啟:

    DevTools 檢查工具頁面

  2. 在 Xbox 上啟用開發者模式。 請參閱 Xbox One 開發者模式啟用

  3. 在 Microsoft Edge 中,請點到 https://<System IP>:11443,該處 <System IP> 會被你的 Xbox 系統作業系統 IP 取代。 確認安全設定頁面顯示在 Windows 裝置入口網站標籤中:

    在「Windows 裝置入口網站」標籤中的「確認安全設定」頁面

  4. 點擊「 繼續使用未加密連線 」按鈕。 出現 SSL 憑證錯誤, NET::ERR__CERT_AUTHORITY_INVALID

    SSL 錯誤

  5. 點擊 進階 按鈕。 會顯示訊息:「伺服器無法證明......」:

    進階選項

  6. 點擊「 繼續」連結 (<System IP> 不安全的) 連結,該連結 <System IP> 會被你的 Xbox 系統作業系統 IP 取代。 Xbox 裝置入口開啟:

    Xbox 裝置入口網站

  7. 請前往 https://<System IP>:11443/config/rootcertificate,該處 <System IP> 被你的 Xbox 系統作業系統 IP 取代。 此檔案可下載:rootcertificate.cer

    Microsoft Edge 下載對話框中列出的根憑證檔案

  8. 打開下載的 rootcertificate.cer 檔案。 安全警告對話框會開啟:

    安全警告對話框

  9. 點擊 開啟 按鈕。 會開啟 一個憑證 對話框:

    憑證對話框

  10. 點擊 安裝憑證 按鈕。 開啟「 歡迎進入憑證匯入嚮導 」對話框:

    「歡迎來到憑證匯入精靈」對話框

  11. 選擇 「目前使用者 」選項按鈕,然後點擊 「下一 」按鈕。 憑證匯入精靈會開啟:

    憑證匯入精靈

  12. 選擇「 將所有憑證放入以下商店」選項,點擊 瀏覽 按鈕,然後選擇 受信任根憑證機構

  13. 點擊 「下一個 」按鈕。 安全 警告 對話框隨即開啟:

    安全警告對話框

  14. 點擊 「是」 按鈕。

  15. 重新啟動 Microsoft Edge。

  16. 前往 https://<System IP>:11443,該 <System IP> 處被你的 Xbox 系統作業系統 IP 取代,並確認連線是否顯示為安全 (也就是 HTTPS URL) :

    安全 XDP

  17. 在你的應用程式專案中,設定以下變數,設定 WebView2 WinUI 2 (UWP) 應用程式進行遠端除錯。

    要啟用遠端除錯,必須在專案中設定環境變數。 此變數必須在建立 CoreWebView2 實例前設定,且在設定 WebView2.Source 屬性或呼叫 WebView2.EnsureCoreWebView2Async 方法之前。

    "WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging"
    

    例如,如果你使用 WebView2 範例 UWP 應用程式,可以透過在檔案中加入以下行 Browser.xaml.cs 來設定環境變數:

    Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging");
    

    在這張截圖中,建構子中 Browser() 該行編號為 33,位於 一個 #endif 封裝現有 SetEnvironmentVariable 陳述句的 下:

    瀏覽器參數遠端除錯

  18. 用 Xbox Xbox Device Portal 部署你的應用程式並啟動應用程式。

  19. 移至edge://inspect

  20. 在「 連接遠端 Windows 裝置 」的文字框中,輸入 https://<System IP>:11443,其中 <System IP> 被你的 Xbox 系統作業系統 IP 取代,然後點擊「 連接裝置 」按鈕。

  21. 確認你能成功連線,這樣你的可除錯的 WebView2 控制項(名為 Edge)會被列在你的機器名稱下:

    Edge 檢查 Xbox

  22. Edge WebView2 控制項的底部,點擊 檢查 連結。 Microsoft Edge DevTools 開啟 WebView2 控制項:

    DevTools 檢查 Xbox

現在你可以用 Microsoft Edge DevTools 檢查並除錯 Xbox WebView2 WinUI 2 (UWP) 應用程式中的 WebView2 控制項。

另請參閱