Skip to content

Commit 0523f52

Browse files
author
David Kline
authored
Merge pull request #7958 from CDiaz-MS/docs_update
Update Build and Deploy documentation with steps for Unity 2019.3
2 parents ccf1b41 + 72a9195 commit 0523f52

File tree

1 file changed

+21
-5
lines changed

1 file changed

+21
-5
lines changed

Documentation/BuildAndDeploy.md

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,6 @@ To run an app on device as a standalone app (for HoloLens, Android, iOS, etc.),
66

77
Instructions on how to build and deploy for HoloLens 1 and HoloLens 2 (UWP) can be found at [building your application to device](https://docs.microsoft.com/windows/mixed-reality/mrlearning-base-ch1#build-your-application-to-your-device).
88

9-
>[!IMPORTANT]
10-
> If using Unity 2019.3.x, select **ARM64** and not **ARM** as the build architecture in Visual Studio. With the default Unity settings in Unity 2019.3.x, a Unity app will not deploy to a HoloLens if ARM is selected due to a Unity bug. This can be tracked on [Unity's issue tracker](https://issuetracker.unity3d.com/issues/enabling-graphics-jobs-in-2019-dot-3-x-results-in-a-crash-or-nothing-rendering-on-hololens-2).
11-
>
12-
> If the ARM architecture is required, navigate to **Edit > Project Settings, Player**, and under the **Other Settings** menu disable **Graphics Jobs**. Disabling **Graphics Jobs** will allow the app to deploy using the ARM build architecture for Unity 2019.3.x, but ARM64 is recommended.
13-
149
**Tip:** When building for WMR, HoloLens 1, or HoloLens 2, it is recommended that the build settings "Target SDK Version"
1510
and "Minimum Platform Version" look like they do in the picture below:
1611

@@ -23,6 +18,27 @@ Make sure that the "Target SDK Version" dropdown includes the option "10.0.18362
2318
[the latest Windows SDK](https://developer.microsoft.com/windows/downloads/windows-10-sdk) needs to be installed.
2419

2520

21+
### Unity 2019.3 and HoloLens
22+
23+
If a HoloLens app appears as a 2D panel on device, make sure the following settings have been configured in Unity 2019.3.x before deploying your UWP app:
24+
25+
If using the legacy XR:
26+
1. Navigate to Edit > Project Settings, Player
27+
1. Under **XR Settings** in the UWP tab, make sure **Virtual Reality Supported** is enabled and the **Windows Mixed Reality** SDK has been added to SDKs.
28+
1. Build and deploy in Visual Studio
29+
30+
If using the XR-Plugin:
31+
32+
1. Follow the steps found in [Getting Started with XRSDK](GettingStartedWithMRTKAndXRSDK.md)
33+
1. Make sure the configuration profile is the **DefaultXRSDKConfigurationProfile**
34+
1. Navigate to **Edit > Project Settings, XR-Plugin Management** and make sure **Windows Mixed Reality** is enabled.
35+
1. Build and deploy in Visual Studio
36+
37+
>[!IMPORTANT]
38+
> If using Unity 2019.3.x, select **ARM64** and not **ARM** as the build architecture in Visual Studio. With the default Unity settings in Unity 2019.3.x, a Unity app will not deploy to a HoloLens if ARM is selected due to a Unity bug. This can be tracked on [Unity's issue tracker](https://issuetracker.unity3d.com/issues/enabling-graphics-jobs-in-2019-dot-3-x-results-in-a-crash-or-nothing-rendering-on-hololens-2).
39+
>
40+
> If the ARM architecture is required, navigate to **Edit > Project Settings, Player**, and under the **Other Settings** menu disable **Graphics Jobs**. Disabling **Graphics Jobs** will allow the app to deploy using the ARM build architecture for Unity 2019.3.x, but ARM64 is recommended.
41+
2642
## Building and deploying MRTK to a Windows Mixed Reality Headset
2743

2844
The Windows Mixed Reality (WMR) headset can be used for Universal Windows Platform (UWP) and Standalone builds. A Standalone build for a WMR headset requires the following extra steps:

0 commit comments

Comments
 (0)