New article "Remote debugging Xbox WebView2 WinUI 2 (UWP) apps"

microsoft-edge/devtools-guide-chromium/whats-new/2023/03/devtools-111.md

@@ -28,7 +28,7 @@ To give us feedback on the remote debugging flow for Microsoft Edge, leave a com
 See also:
 * [Remotely debug Windows devices](../../../remote-debugging/windows.md)
 * [Windows Device Portal for Desktop](/windows/uwp/debug-test-perf/device-portal-desktop)
-* [Remote debugging WebView2 WinUI 2 (UWP) apps with Remote Tools for Microsoft Edge](../../../../webview2/how-to/remote-debugging.md)
+* [Remote debugging WebView2 WinUI 2 (UWP) apps](../../../../webview2/how-to/remote-debugging.md)
 
 
 <!-- ====================================================================== -->

microsoft-edge/toc.yml

@@ -1353,9 +1353,23 @@
               href: webview2/how-to/debug-visual-studio.md
               displayName: Debug WebView2 apps with Visual Studio  # top-of-page title
 
-            - name: Remote debugging
-              href: webview2/how-to/remote-debugging.md
-              displayName: Remote debugging WebView2 WinUI 2 (UWP) apps with Remote Tools for Microsoft Edge  # top-of-page title
+            - name: Remote debugging WebView2 WinUI 2 (UWP) apps
+              items: 
+                - name: Remote debugging WebView2 WinUI 2 (UWP) apps
+                  href: webview2/how-to/remote-debugging.md
+                  displayName: remotely debug
+
+                - name: Remote debugging desktop WebView2 WinUI 2 (UWP) apps
+                  href: webview2/how-to/remote-debugging-desktop.md
+                  displayName: remotely debug, Remote Tools for Microsoft Edge
+
+                - name: Remote debugging HoloLens 2 WebView2 WinUI 2 (UWP) apps
+                  href: webview2/how-to/remote-debugging-hololens.md
+                  displayName: remotely debug, Remote Tools for Microsoft Edge
+
+                - name: Remote debugging Xbox WebView2 WinUI 2 (UWP) apps
+                  href: webview2/how-to/remote-debugging-xbox.md
+                  displayName: remotely debug
 
 # -----------------------------------------------------------------------------
         - name: Architecture

microsoft-edge/webview2/get-started/winui2.md

@@ -453,7 +453,7 @@ See also:
 <!-- ------------------------------ -->
 #### Microsoft Edge Developer Tools
 
-On WinUI 2, Microsoft Edge DevTools cannot be launched inside a store-signed WebView2 WinUI 2 (UWP) app.  However, you can work around this by using remote debugging.  See [Remote debugging WebView2 WinUI 2 (UWP) apps with Remote Tools for Microsoft Edge](../how-to/remote-debugging.md).
+On WinUI 2, Microsoft Edge DevTools cannot be launched inside a store-signed WebView2 WinUI 2 (UWP) app.  However, you can work around this by using remote debugging.  See [Remote debugging WebView2 WinUI 2 (UWP) apps](../how-to/remote-debugging.md).
 
 
 <!-- ------------------------------ -->

microsoft-edge/webview2/how-to/remote-debugging-desktop.md

@@ -0,0 +1,101 @@
+---
+title: Remote debugging desktop WebView2 WinUI 2 (UWP) apps
+description: How to remotely debug desktop WebView2 WinUI 2 (UWP) apps by using Remote Tools for Microsoft Edge. 
+author: MSEdgeTeam
+ms.author: msedgedevrel
+ms.topic: conceptual
+ms.prod: microsoft-edge
+ms.technology: webview
+ms.date: 09/27/2023
+---
+# Remote debugging desktop WebView2 WinUI 2 (UWP) apps
+
+To use [Microsoft Edge DevTools](/microsoft-edge/devtools-guide-chromium/landing/) to debug a WebView2 WinUI 2 (UWP) app, use remote debugging.  Remote debugging is necessary for WebView2 WinUI 2 (UWP) apps because currently, the built-in DevTools can't be launched inside a store-signed WebView2 WinUI 2 (UWP) app.
+
+
+<!-- ========================================================================== -->
+## Attach DevTools remotely to a desktop WebView2 WinUI 2 (UWP) app
+
+Attach Microsoft Edge DevTools remotely to a desktop WebView2 WinUI 2 (UWP) app as follows:
+
+1.  In Microsoft Edge, go to `edge://inspect`.  The **Inspect with Edge Developer Tools** page opens:
+
+    ![DevTools Inspect utility page](./remote-debugging-desktop-images/inspect-devtools-page-supported.png)
+
+1.  Enable `Developer Mode`: Open Windows **Settings**, select **Privacy & security** > **For developers**, and then turn on the **Developer Mode** toggle.
+
+1.  In the same **Settings** page, turn on the **Device Portal** toggle:
+
+    ![Enable Developer Mode](./remote-debugging-desktop-images/enable-developer-mode.png)
+
+    If your operating system isn't up-to-date, you might get a message in the **Settings** window: "The Windows Developer Mode package couldn't be found in Windows Update, so remote deployment and Windows Device Portal are unavailable.  [Learn more](/windows/uwp/debug-test-perf/device-portal-desktop#failed-to-locate-the-package)."
+
+1.  If you get such a message, update your operating system (OS) to the latest version, and then turn on the **Device Portal** toggle.
+
+1.  When prompted to **Install Windows Developer Mode package**, click **Yes**:
+
+    ![Install Windows Developer Mode package](./remote-debugging-desktop-images/install-developer-mode-package.png)
+
+    After the installation is complete, note the URL that will be used for the remote debugging connection. To find this URL, expand the **Device Portal** dropdown.  In this case, the Device Portal URL that will be used is `http://localhost:50080`:
+
+    ![Remote Debugging URL](./remote-debugging-desktop-images/remote-debugging-url.png)
+
+1.  Install [Remote Tools for Microsoft Edge](https://www.microsoft.com/store/productId/9P6CMFV44ZLT) from the Microsoft Store.
+
+1.  In Microsoft Edge, go to the Device Portal URL that you previously noted.  Verify that the **Confirm security settings** page is loaded (in the **Windows Device Portal** tab):
+
+    ![The 'Confirm security settings' page in the 'Windows Device Portal' tab](./remote-debugging-desktop-images/open-device-portal.png)
+
+1.  If you are only debugging apps that are running locally, you can select the **Continue with an unsecured connection** button.
+
+    Or, if you aren't running the app locally, or if you need to connect over HTTPS, select the **Configure a secure connection** link, and then follow the steps in the page that you're redirected to.
+
+1.  Verify that you're redirected to the **Apps manager: Windows Device Portal** page:
+
+    ![Device Portal](./remote-debugging-desktop-images/device-portal.png)
+
+1.  Go to `http://<Device Portal URL>/msedge` and verify Remote Tools for Microsoft Edge are functioning. The page loads an empty list: `[]`, unless there's an application running that is debuggable by remote tools.
+
+1.  Configure your WebView2 WinUI 2 (UWP) app for remote debugging:
+
+    To enable remote debugging, an environment variable must be set in your project.  This variable must be set before creating the `CoreWebView2` instance, and before either setting the `WebView2.Source` property or calling the `WebView2.EnsureCoreWebView2Async` method.
+
+    Set the following variable:
+
+    ```
+    "WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging"
+    ```
+
+    For example, if you're using the [WebView2 Sample UWP app](https://github.com/MicrosoftEdge/WebView2Samples/tree/main/SampleApps/webview2_sample_uwp), you can set the environment variable by adding the following line in the `Browser.xaml.cs` file:
+
+    ```csharp
+    Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging");
+    ```
+
+    The line is numbered 33 in this screenshot, in the `Browser()` constructor, below an `#endif` that wraps an existing `SetEnvironmentVariable` statement:
+
+    ![Browser Arguments Remote Debugging](./remote-debugging-desktop-images/browser-arguments-remote-debugging.png)
+
+1.  Launch your app.
+
+1.  Go to `http://<Device Portal URL>/msedge`, such as `http://localhost:50080/msedge`, and make sure your WebView2 instance appears in the list:
+
+    ![Debuggable WebView2 Instance](./remote-debugging-desktop-images/debuggable-webviews.png)
+
+1.  Go to `edge://inspect`.  In the **Connect to a remote Windows device** text box, enter `http://<Device Portal URL>`, such as `http://localhost:50080`, and then click **Connect to Device**.
+
+1.  Verify that you can successfully connect, so that your debuggable WebView2 control, named **Edge**, is listed under your machine name:
+
+    ![Connect to WebView2](./remote-debugging-desktop-images/connect-to-webview2.png)
+
+1.  At the bottom of the **Edge** WebView2 control entry, click the **inspect** link.  Microsoft Edge DevTools opens for the WebView2 control:
+
+    ![DevTools Inspect Window](./remote-debugging-desktop-images/devtools-inspect.png)
+
+Now you can use Microsoft Edge DevTools to inspect and debug the WebView2 control.
+
+
+<!-- ========================================================================== -->
+## See also
+
+* [Remote debugging WebView2 WinUI 2 (UWP) apps](./remote-debugging.md)

microsoft-edge/webview2/how-to/remote-debugging-hololens.md

@@ -0,0 +1,95 @@
+---
+title: Remote debugging HoloLens 2 WebView2 WinUI 2 (UWP) apps
+description: How to remotely debug HoloLens 2 WebView2 WinUI 2 (UWP) apps by using Remote Tools for Microsoft Edge. 
+author: MSEdgeTeam
+ms.author: msedgedevrel
+ms.topic: conceptual
+ms.prod: microsoft-edge
+ms.technology: webview
+ms.date: 09/27/2023
+---
+# Remote debugging HoloLens 2 WebView2 WinUI 2 (UWP) apps
+
+To use [Microsoft Edge DevTools](/microsoft-edge/devtools-guide-chromium/landing/) to debug a WebView2 WinUI 2 (UWP) app, use remote debugging.  Remote debugging is necessary for WebView2 WinUI 2 (UWP) apps because currently, the built-in DevTools can't be launched inside a store-signed WebView2 WinUI 2 (UWP) app.
+
+WebView2 on HoloLens 2 and the WebView plugin for Unity are both in Preview and are subject to change before general availability.  
+
+WebView2 and the WebView2 plugin are only supported on HoloLens 2 devices running the Windows 11 update. For more information, see [Update HoloLens 2](/hololens/hololens-update-hololens).
+
+
+<!-- ========================================================================== -->
+## Attach DevTools remotely to a HoloLens 2 WebView2 WinUI 2 (UWP) app
+
+Attach Microsoft Edge DevTools remotely to a HoloLens 2 WebView2 WinUI 2 (UWP) app as follows:
+
+1.  In Microsoft Edge, go to `edge://inspect`.  The **Inspect with Edge Developer Tools** page opens:
+
+    ![DevTools Inspect utility page](./remote-debugging-hololens-images/inspect-devtools-page-supported.png)
+
+1.  Enable Device Portal: Open Windows **Settings**, select **Update & Security** > **For developers**, and then turn on the **Device Portal** toggle:
+
+    ![Enable Device Portal](./remote-debugging-hololens-images/enable-device-portal-holo.png)
+
+    In **Connect using** > **Ethernet**, note the URL that will be used for the remote debugging connection.
+
+1.  Install [Remote Tools for Microsoft Edge](https://www.microsoft.com/store/productId/9P6CMFV44ZLT) from the Microsoft Store on your HoloLens 2 device.
+
+1.  In Microsoft Edge, go to the Device Portal URL that you previously noted.  Verify that the **Confirm security settings** page is loaded (in the **Windows Device Portal** tab):
+
+    ![The 'Confirm security settings' page in the 'Windows Device Portal' tab](./remote-debugging-hololens-images/open-device-portal.png)
+
+1.  If you are only debugging apps that are running locally, you can select the **Continue with an unsecured connection** button.
+
+    Or, if you aren't running the app locally, or if you need to connect over HTTPS, select the **Configure a secure connection** link, and then follow the steps in the page that you're redirected to.
+
+1.  Verify that you're redirected to the **Apps manager: Windows Device Portal** page:
+
+    ![Device Portal](./remote-debugging-hololens-images/device-portal.png)
+
+1.  Go to `http://<Device Portal URL>/msedge` and verify Remote Tools for Microsoft Edge are functioning. The page loads an empty list: `[]`, unless there's an application running that is debuggable by remote tools.
+
+1.  Configure your WebView2 WinUI 2 (UWP) app for remote debugging:
+
+    To enable remote debugging, an environment variable must be set in your project.  This variable must be set before creating the `CoreWebView2` instance, and before either setting the `WebView2.Source` property or calling the `WebView2.EnsureCoreWebView2Async` method.
+
+    Set the following variable:
+
+    ```
+    "WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging"
+    ```
+
+    For example, if you're using the [WebView2 Sample UWP app](https://github.com/MicrosoftEdge/WebView2Samples/tree/main/SampleApps/webview2_sample_uwp), you can set the environment variable by adding the following line in the `Browser.xaml.cs` file:
+
+    ```csharp
+    Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--enable-features=msEdgeDevToolsWdpRemoteDebugging");
+    ```
+
+    The line is numbered 33 in this screenshot, in the `Browser()` constructor, below an `#endif` that wraps an existing `SetEnvironmentVariable` statement:
+
+    ![Browser Arguments Remote Debugging](./remote-debugging-hololens-images/browser-arguments-remote-debugging.png)
+
+1.  Launch your app on your HoloLens 2 device.
+
+1.  Go to `http://<Device Portal URL>/msedge`, such as `http://localhost:50080/msedge`, and make sure your WebView2 instance appears in the list:
+
+    ![Debuggable WebView2 Instance](./remote-debugging-hololens-images/debuggable-webviews.png)
+
+1.  Go to `edge://inspect`.  In the **Connect to a remote Windows device** text box, enter `http://<Device Portal URL>`, such as `http://localhost:50080`, and then click **Connect to Device**.
+
+1.  Verify that you can successfully connect, so that your debuggable WebView2 control, named **Edge**, is listed under your machine name:
+
+    ![Connect to WebView2 on HoloLens 2](./remote-debugging-hololens-images/connect-to-webview2-hololens.png)
+
+1.  At the bottom of the **Edge** WebView2 control entry, click the **inspect** link.  Microsoft Edge DevTools opens for the WebView2 control:
+
+    ![DevTools Inspect Window](./remote-debugging-hololens-images/devtools-inspect.png)
+
+Now you can use Microsoft Edge DevTools to inspect and debug the WebView2 control in your HoloLens 2 WebView2 WinUI 2 (UWP) app.
+
+
+
+
+<!-- ========================================================================== -->
+## See also
+
+* [Remote debugging WebView2 WinUI 2 (UWP) apps](./remote-debugging.md)