Known issues in Unity versions and packages

Some versions of Unity or Unity plugins contain known incompatibilities blocking apps from working as expected on HoloLens 2 or Windows Mixed Reality devices. While we generally support all Long Term Support (LTS) versions of Unity and their verified plugins, we recommend avoiding those specific builds of Unity and Unity plugins to ensure your apps work as expected.

We recommend that you use the latest patch version of 2022.3 LTS and their recommended version of Unity plugins, together with the latest Mixed Reality OpenXR plugin.

If using an earlier Unity patch release, be sure to consult the known blocking issues table to ensure that you avoid builds with other blocking issues.

Active blocking issues

Blocking issues Status & Last Update   Versions with issue     Mitigation  
HL2 apps using DirectX 12 in Unity exhibits worse rendering performance than apps using DirectX 11. Unity 6 defaults to DirectX 12, causing unexpected performance degradation. Investigating:
Unity 2021.3.0f1 to Unity 6000.*.*
with DirectX 12
Avoid using DirectX 12. In Unity go to Project Settings > Player > Other Settings > Uncheck Auto Graphics API > Add Direct3D11 > Remove Direct3D12
An HL2 app importing both MRTK3 and Azure Spatial Anchors may present 'Guid for asset conflicts with' errors when the ARFoundation package version doesn't match the imported ARSubsystems version. When using ARFoundation 5.x+, manually add com.unity.xr.arsubsystems version 5.0.2 to the project's Package Manager. You may see a warning message that states the ARSubsystems has been deprecated, but this message can be ignored.

Resolved blocking issues

Blocking issues Status & Last Update   Versions with issue     Versions with fixes  
HL2 app using URP has worse render performance in Unity 2022 compared to Unity 2021 when using the default URP Lit material. In Preview:
Unity 2022.*.*
with URP 13.*.*
Either avoid URP in Unity 2022, avoid using the default URP materials or use URP in Unity 2021.3.14+. Issue is resolved in Unity 6 Preview.
Unable to build UWP app packages (APPX or MSIX) in Unity 2021 and 2022 Fixed:
Reproducible with: 2021.3.30f1, 2022.3.8f1 Use Unity 2021.3.31f1+, Unity 2022.3.13f1+, or manually add an APPX Manifest to the app's Visual Studio project. For more information, see Unity's forum and Unity's Issue Tracker.
HL2 app crashes when hands are detected. Fixed:
Unity 2022, Unity 2021, Unity 2020 with
com.unity.inputsystem 1.5.0
Use com.unity.inputsystem 1.5.1 or later
HL2 app using URP has worse render performance in Unity 2021 compared to Unity 2020. Fixed:
Unity version < 2021.3.14f1
with URP 12.*.*
Use Unity 2021.3.14f1 and later
Building application via IL2CPP in Unity fails due to compilation errors. For more information on the root cause, see the discussion here. Fixed:
Visual Studio 2022
version 17.4+ with
Unity versions <
2020.3.42f1, 2021.3.14f1, 2022.1.23f1, 2022.2.0b16, and 2023.1.0a19
Use Visual Studio 2019 or Unity version >= 2020.3.42f1, 2021.3.14f1, 2022.1.23f1, 2022.2.0b16, or 2023.1.0a19
Holographic App Remoting remoting app using Unity's OpenXR plugin 1.5.1 fails to connect to remoting player if the hosting PC doesn't have other VR headsets attached. Fixed:
Unity 2020 or Unity 2021
with Unity OpenXR plugin =
1.5.0, 1.5.1 and 1.5.2
If using Holographic App Remoting, use Unity OpenXR plugin <= 1.4.3 or >= 1.5.3
ARM32 UWP Unity apps built in release mode using Visual Studio 2022 will hit an internal compiler error in Visual Studio. Fixed:
Visual Studio 2022
version 17.1.1+
Use Visual Studio 2019 or Visual Studio 2022 version >= 17.3.*
HL2 app using URP, WindowsXR plugin and Gamma color space rendering has worse render performance in Unity 2020 or later. Fixed:
Unity 2020.*.*
with URP 10.*.*
and Windows XR Plugin <=4.6.3
Use Windows XR Plugin version >= 4.6.4
HL2 app using Unity's Burst package (for example, commonly used when using URP) will hit ILCPP compile error in VisualStudio. Fixed:
Unity Burst package
1.6.5, 1.7.0 or 1.7.1
Use Unity Burst package 1.6.6 or 1.7.2 or later versions.
Application with default splash screen will show four spinning dots when launching on HL2, or after the application is suspended and resumed. Fixed:
Unity 2020.3.32-34f1 
and Unity 2021.2.17~19f1 and Unity 2021.3.0~3f1
Use Unity 2020.3.35f1 or Unity 2021.3.4f1 or later
HL2 application shows severely jittery image. Fixed:
Unity 2020.3.21f1 to
Unity 2020.3.23f1
Use Unity 2020.3.24f1
and later
OpenXR backend with URP can deadlock on HL2. Fixed:
Unity 2020.3.0f1 to
Unity 2020.3.7f1
Use Unity 2020.3.8f1
and later