Merge pull request #2567 from michaelfarnsworth/webview2-hololens-get…

…ting-started Webview2 HoloLens 2 Getting Started Tutorial
MicrosoftDocs · May 15, 2023 · 3dd0c61 · 3dd0c61
2 parents f8b8e70 + 7a065e4
commit 3dd0c61
Show file tree

Hide file tree

Showing 30 changed files with 636 additions and 10 deletions.
diff --git a/microsoft-edge/toc.yml b/microsoft-edge/toc.yml
@@ -1144,6 +1144,10 @@
  href: webview2/get-started/win32.md
  displayName: Win32_GettingStarted, Get started with WebView2 in Win32 apps # repo dir name # top-of-page title
 
+ - name: HoloLens 2
+ href: webview2/get-started/hololens2.md
+ displayName: HoloLens2_GettingStarted, Get started with WebView2 in HoloLens 2 Unity apps (Preview) # repo dir name # top-of-page title
+
 # -----------------------------------------------------------------------------
 # Sample apps
  - name: Sample apps

diff --git a/microsoft-edge/webview2/get-started/get-started.md b/microsoft-edge/webview2/get-started/get-started.md
@@ -19,6 +19,7 @@ These articles cover how to set up your development tools and create an initial
 | [Get started with WebView2 in WPF apps](wpf.md) | [WPF_GettingStarted](https://github.com/MicrosoftEdge/WebView2Samples/tree/main/GettingStartedGuides/WPF_GettingStarted) | Use the **WPF Application** or **WPF App (.NET Framework)** project template to create a WPF app, and then install the WebView2 SDK for the project to add WebView2. |
 | [Get started with WebView2 in WinForms apps](winforms.md) | [WinForms_GettingStarted](https://github.com/MicrosoftEdge/WebView2Samples/tree/main/GettingStartedGuides/WinForms_GettingStarted) | Use the **C# Windows Forms App (.NET Framework)** project template to create a WinForms project, then install the **Microsoft.Web.WebView2** SDK package for the WinForms project. |
 | [Get started with WebView2 in Win32 apps](win32.md) | [Win32_GettingStarted](https://github.com/MicrosoftEdge/WebView2Samples/tree/main/GettingStartedGuides/Win32_GettingStarted) | Starts by opening an existing Win32 app project that has the WebView2 SDK and code already added. |
+| [Get started with WebView2 in HoloLens 2 Unity apps](hololens2.md) | [Hololens2_GettingStarted](https://github.com/MicrosoftEdge/WebView2Samples/tree/main/GettingStartedGuides/HoloLens2_GettingStarted) | Starts by opening an existing Unity project that has the WebView2 SDK package and sample code added. |
 
 
 <!-- ====================================================================== -->

diff --git a/...-edge/webview2/get-started/hololens2-images/feature_enable_preview_releases.png b/...-edge/webview2/get-started/hololens2-images/feature_enable_preview_releases.png
diff --git a/...oft-edge/webview2/get-started/hololens2-images/feature_tool_import_features.png b/...oft-edge/webview2/get-started/hololens2-images/feature_tool_import_features.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/feature_tool_review.png b/microsoft-edge/webview2/get-started/hololens2-images/feature_tool_review.png
diff --git a/...dge/webview2/get-started/hololens2-images/feature_tool_select_unity_project.png b/...dge/webview2/get-started/hololens2-images/feature_tool_select_unity_project.png
diff --git a/...oft-edge/webview2/get-started/hololens2-images/mrtk_feature_tool_start_page.png b/...oft-edge/webview2/get-started/hololens2-images/mrtk_feature_tool_start_page.png
diff --git a/...ge/webview2/get-started/hololens2-images/mrtk_feature_tool_start_page_part2.png b/...ge/webview2/get-started/hololens2-images/mrtk_feature_tool_start_page_part2.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/mrtk_webview2_selected.png b/microsoft-edge/webview2/get-started/hololens2-images/mrtk_webview2_selected.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/unity-playmode-testing.png b/microsoft-edge/webview2/get-started/hololens2-images/unity-playmode-testing.png
diff --git a/...soft-edge/webview2/get-started/hololens2-images/unity_addresswell_inspector.png b/...soft-edge/webview2/get-started/hololens2-images/unity_addresswell_inspector.png
diff --git a/...osoft-edge/webview2/get-started/hololens2-images/unity_backbutton_inspector.png b/...osoft-edge/webview2/get-started/hololens2-images/unity_backbutton_inspector.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/unity_backbutton_text.png b/microsoft-edge/webview2/get-started/hololens2-images/unity_backbutton_text.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/unity_build_settings.png b/microsoft-edge/webview2/get-started/hololens2-images/unity_build_settings.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/unity_canvas_inspector.png b/microsoft-edge/webview2/get-started/hololens2-images/unity_canvas_inspector.png
diff --git a/...soft-edge/webview2/get-started/hololens2-images/unity_canvasimage_inspector.png b/...soft-edge/webview2/get-started/hololens2-images/unity_canvasimage_inspector.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/unity_completed_scene.png b/microsoft-edge/webview2/get-started/hololens2-images/unity_completed_scene.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/unity_gobutton_inspector.png b/microsoft-edge/webview2/get-started/hololens2-images/unity_gobutton_inspector.png
diff --git a/...osoft-edge/webview2/get-started/hololens2-images/unity_inspector_change_url.png b/...osoft-edge/webview2/get-started/hololens2-images/unity_inspector_change_url.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/unity_scene_hierarchy.png b/microsoft-edge/webview2/get-started/hololens2-images/unity_scene_hierarchy.png
diff --git a/...ft-edge/webview2/get-started/hololens2-images/unity_webview_connect_prefabs.png b/...ft-edge/webview2/get-started/hololens2-images/unity_webview_connect_prefabs.png
diff --git a/...dge/webview2/get-started/hololens2-images/unity_webview_transform_inspector.png b/...dge/webview2/get-started/hololens2-images/unity_webview_transform_inspector.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/visualstudio_buildconfig.png b/microsoft-edge/webview2/get-started/hololens2-images/visualstudio_buildconfig.png
diff --git a/...bview2/get-started/hololens2-images/visualstudio_createpackage_architecture.png b/...bview2/get-started/hololens2-images/visualstudio_createpackage_architecture.png
diff --git a/microsoft-edge/webview2/get-started/hololens2-images/visualstudio_remote_ip.png b/microsoft-edge/webview2/get-started/hololens2-images/visualstudio_remote_ip.png
diff --git a/...osoft-edge/webview2/get-started/hololens2-images/visualstudio_select_device.png b/...osoft-edge/webview2/get-started/hololens2-images/visualstudio_select_device.png
diff --git a/...osoft-edge/webview2/get-started/hololens2-images/visualstudio_select_remote.png b/...osoft-edge/webview2/get-started/hololens2-images/visualstudio_select_remote.png
diff --git a/microsoft-edge/webview2/get-started/hololens2.md b/microsoft-edge/webview2/get-started/hololens2.md
diff --git a/microsoft-edge/webview2/get-started/winui2.md b/microsoft-edge/webview2/get-started/winui2.md
@@ -153,7 +153,7 @@ This article shows steps and screenshots for Visual Studio 2022 Community Editio
 
 1. Accept the defaults, and click the **OK** button.
 
-1. If the **Developer Mode** window section appears, in that section, click **On**. If you haven't already set your machine to Developer Mode, the **Use developer features** dialog opens, to confirm turning on developer mode. 
+1. If the **Developer Mode** window section appears, in that section, click **On**. If you haven't already set your machine to Developer Mode, the **Use developer features** dialog opens, to confirm turning on developer mode.
  * Click **Yes** to turn on Developer Mode for your machine, and then close the **Settings** window.
 
  Visual Studio displays the newly created solution and project:
@@ -196,6 +196,8 @@ Next, you install the **Microsoft.UI.Xaml** package for this project. Microsoft
 
  For version 2.8.0 or later, in the **Dependencies** section at the bottom, **Microsoft.Web.WebView2** is listed.
 
+ For HoloLens 2 development, the **Microsoft.Web.WebView2** package must be version 1.0.1722.45 or higher, which may be higher than the default. The WebView2 Preview is available in the Insider Preview for Microsoft HoloLens. To access this preview, you must be enrolled in the Windows Insider Program; see [Start receiving Insider builds](/hololens/hololens-insider#start-receiving-insider-builds) in _Insider preview for Microsoft HoloLens_. See also [Update HoloLens 2](/hololens/hololens-update-hololens).
+
 1. In the middle panel, in the **Version** drop-down, make sure **Latest stable** is selected, version 2.8.0 or later.
 
 1. Click the **Install** button.
@@ -258,7 +260,7 @@ Now you are ready to add WebView2 code to the project. First, add a namespace r
 <!-- ====================================================================== -->
 ## Step 7 - Build and run the project containing the WebView2 control
 
-1. Click **Debug** > **Start Debugging** (**F5**). The app window opens, briefly showing the WebView2 WebUI grid:
+1. Click **Debug** > **Start Debugging** (**F5**). (If building for HoloLens 2, see [Using Visual Studio to deploy and debug](/windows/mixed-reality/develop/advanced-concepts/using-visual-studio?tabs=hl2)). The app window opens, briefly showing the WebView2 WebUI grid:
 
  ![During debugging, the WebView2 WebUI grid briefly appears](media/winui2-getting-started-webview2-grid.png)
 

diff --git a/microsoft-edge/webview2/roadmap.md b/microsoft-edge/webview2/roadmap.md
@@ -26,36 +26,56 @@ The WebView2 team is planning the following major efforts for future updates:
 <!-- ====================================================================== -->
 ## WebView2 Runtime and Installer
 
-Evergreen distribution mode allows you to target or chain-install the WebView2 Runtime onto your users' machines. The Evergreen WebView2 Runtime and installer has reached General Availability (GA). For more information, see [Distribute your app and the WebView2 Runtime](concepts/distribution.md).
+Evergreen distribution mode allows you to target or chain-install the WebView2 Runtime onto your users' machines. The Evergreen WebView2 Runtime and installer has reached General Availability (GA). For more information, see [Distribute your app and the WebView2 Runtime](./concepts/distribution.md).
 
 
 <!-- ====================================================================== -->
 ## Fixed version
 
-Fixed version distribution mode allows you to package the Microsoft Edge binaries <!--(a specific version of the WebView2 Runtime)--> inside your native application. The Fixed Version has reached General Availability (GA). For more information, see [Distribute your app and the WebView2 Runtime](concepts/distribution.md).
+Fixed version distribution mode allows you to package the Microsoft Edge binaries <!--(a specific version of the WebView2 Runtime)--> inside your native application. The Fixed Version has reached General Availability (GA). For more information, see [Distribute your app and the WebView2 Runtime](./concepts/distribution.md).
 
 
 <!-- ====================================================================== -->
 ## General Availability
 
 The following technologies have reached General Availability (GA).
 
-### Win32 C/C++
+
+<!-- ------------------------------ -->
+#### Win32 C/C++
 
 The Win32 C/C++ SDK has reached GA.
 
-### .NET
+
+<!-- ------------------------------ -->
+#### .NET
 
 The .NET SDK has reached GA.
 
-### Windows UI Library 2
 
-You can access WebView2 controls in your UWP applications using [Windows UI Library 2 (WinUI 2)](get-started/winui2.md). This has reached GA.
+<!-- ------------------------------ -->
+#### Windows UI Library 2
+
+You can access WebView2 controls in your UWP applications using [Windows UI Library 2 (WinUI 2)](./get-started/winui2.md). This has reached GA.
 
-### Windows UI Library 3
+
+<!-- ------------------------------ -->
+#### Windows UI Library 3
 
 You can access WebView2 controls in your applications using [Windows UI Library 3 (WinUI 3)](/uwp/toolkits/winui3/index) with the Windows App SDK. This has reached GA.
 
-#### XAML limitation
+###### XAML limitation
 
 XAML Island support requires additional work and may be considered for future releases.
+
+
+<!-- ====================================================================== -->
+## Preview Availability
+
+The following technologies are now available in a Preview release.
+
+
+<!-- ------------------------------ -->
+#### HoloLens 2
+
+Starting with the Windows 11 update for HoloLens 2, a WebView2 Preview is now available on HoloLens 2 devices. The WebView2 Preview is available in the Insider Preview for Microsoft HoloLens. For more information, see [Get started with WebView2 in HoloLens 2 Unity apps (Preview)](./get-started/hololens2.md).