要使用 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) 應用程式,方法如下:
在 Microsoft Edge 中,請前往
edge://inspect。 使用邊緣開發者工具檢查頁面開啟:
在 Xbox 上啟用開發者模式。 請參閱 Xbox One 開發者模式啟用。
在 Microsoft Edge 中,請點到
https://<System IP>:11443,該處<System IP>會被你的 Xbox 系統作業系統 IP 取代。 確認安全設定頁面顯示在 Windows 裝置入口網站標籤中:
點擊「 繼續使用未加密連線 」按鈕。 出現 SSL 憑證錯誤, NET::ERR__CERT_AUTHORITY_INVALID:
點擊 進階 按鈕。 會顯示訊息:「伺服器無法證明......」:
點擊「 繼續」連結 (
<System IP>不安全的) 連結,該連結<System IP>會被你的 Xbox 系統作業系統 IP 取代。 Xbox 裝置入口開啟:
請前往
https://<System IP>:11443/config/rootcertificate,該處<System IP>被你的 Xbox 系統作業系統 IP 取代。 此檔案可下載:rootcertificate.cer
打開下載的
rootcertificate.cer檔案。 安全警告對話框會開啟:
點擊 開啟 按鈕。 會開啟 一個憑證 對話框:
點擊 安裝憑證 按鈕。 開啟「 歡迎進入憑證匯入嚮導 」對話框:
選擇 「目前使用者 」選項按鈕,然後點擊 「下一 」按鈕。 憑證匯入精靈會開啟:
選擇「 將所有憑證放入以下商店」選項,點擊 瀏覽 按鈕,然後選擇 受信任根憑證機構。
點擊 「下一個 」按鈕。 安全 警告 對話框隨即開啟:
點擊 「是」 按鈕。
重新啟動 Microsoft Edge。
前往
https://<System IP>:11443,該<System IP>處被你的 Xbox 系統作業系統 IP 取代,並確認連線是否顯示為安全 (也就是 HTTPS URL) :
在你的應用程式專案中,設定以下變數,設定 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陳述句的 下:
用 Xbox
Xbox Device Portal部署你的應用程式並啟動應用程式。移至
edge://inspect。在「 連接遠端 Windows 裝置 」的文字框中,輸入
https://<System IP>:11443,其中<System IP>被你的 Xbox 系統作業系統 IP 取代,然後點擊「 連接裝置 」按鈕。確認你能成功連線,這樣你的可除錯的 WebView2 控制項(名為 Edge)會被列在你的機器名稱下:
在 Edge WebView2 控制項的底部,點擊 檢查 連結。 Microsoft Edge DevTools 開啟 WebView2 控制項:
現在你可以用 Microsoft Edge DevTools 檢查並除錯 Xbox WebView2 WinUI 2 (UWP) 應用程式中的 WebView2 控制項。