Skip to content

Latest commit

 

History

History
70 lines (44 loc) · 3.58 KB

choosing-unity-version.md

File metadata and controls

70 lines (44 loc) · 3.58 KB
title description author ms.author ms.date ms.topic keywords
Choosing a Unity version and XR plugin
Stay up to date on the latest Unity and XR plugin recommendations for HoloLens application development.
qianw211
qianwen
01/10/2022
article
mixedrealitytoolkit, mixedrealitytoolkit-unity, mixed reality headset, windows mixed reality headset, virtual reality headset, unity

Choosing a Unity version and XR plugin

While we recommend that you use Unity LTS (Long Term support) versions with the latest Mixed Reality OpenXR plugin for HoloLens 2 and Windows Mixed Reality development, you can build apps with other Unity configurations as well.

Unity 2020.3 LTS or 2021.3 LTS (Recommended)

[!INCLUDE]

Important

Unity 2020 does not support targeting HoloLens (1st gen). These headsets remain supported in Unity 2019 LTS with Legacy Built-in XR for the full lifecycle of Unity 2019 LTS through mid-2022.

The best way to install and manage Unity is through the Unity Hub:

  1. Install Unity Hub.
  2. Select the Installs tab and choose Add.
  3. Select Unity 2020.3 LTS and click Next.

Unity Hub install new version

  1. Check the following components under 'Platforms':
    • Universal Windows Platform Build Support
    • Windows Build Support (IL2CPP)

Unity Universal Windows Platform Build Support option

  1. If you previously installed Unity without these options, you can add them through 'Add Modules' menu in Unity Hub:

Unity Windows Build Support option

Once you have Unity 2020.3 installed, get started creating a project or upgrading an existing project using the Mixed Reality OpenXR plugin:

[!div class="nextstepaction"] Set up a new OpenXR project with MRTK

Note

While we recommend using OpenXR for all new projects, Unity 2020.3 LTS also supports the Windows XR plugin. This plugin is fully supported, although it won't receive new features such as AR Foundation 4.0 support.

Unity 2019.4 LTS

Unity 2019.4 LTS has reached the end of Unity's two-year Long-Term Support window and is no longer receiving updates from Unity, although your projects will continue to run.

If you need to use Unity 2019, you can use Unity 2019 LTS with Legacy Built-in XR.

Note

Unity has deprecated its Legacy Built-in XR support as of Unity 2019. While Unity 2019 does offer a new XR Plug-in framework, Microsoft is not currently recommending that path in Unity 2019 due to Azure Spatial Anchors incompatibilities with AR Foundation 2. In Unity 2020, Azure Spatial Anchors is supported within the XR Plug-in framework.

If you are developing apps for HoloLens (1st gen), these headsets remain supported in Unity 2019 LTS with Legacy Built-in XR for the full lifecycle of Unity 2019 LTS through mid-2022.

Unity 2018.4 LTS

Unity 2018.4 LTS has reached the end of Unity's two-year Long-Term Support window and is no longer receiving updates from Unity, although your projects will continue to run.

If you have a Unity 2018 project, you should consider planning for a migration forward to Unity 2020.3 LTS and the Mixed Reality OpenXR plugin.

Next steps

[!div class="nextstepaction"] Set up a new OpenXR project with MRTK Set up a new OpenXR project without MRTK