Long Term Support
Unity 2022 LTS provides a stable foundation for projects that are in production or about to ship. Unity 2022.3 LTS release has the same feature set as the 2022.2 Tech Stream release.
We’re committed to supporting 2022 LTS releases with biweekly updates until mid-2024, after which updates will be monthly until mid-2025 (two years after the initial release date). These updates will only cover fixes aimed at improving the stability of the product to enable users to ship their projects.
Unity 2021.3 is now the legacy LTS. It will be updated monthly until it reaches the end of its support cycle in mid-2024.
LTS Release 2018.4.32f1
LTS Release 2018.4.32f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2018.4.32f1
macOS: If the Android Tools are not installed through the Hub, macOS 10.15 (Catalina) default security settings will prevent the Android NDK binaries being executed. These settings have to be changed or a signed Android NDK (r16b) will be needed to build Android. More information here: https://developer.android.com/ndk/downloads/older_releases.
Package Manager: Immutable packages altered by the API Updater are reverted to their original state when packages are resolved, which can lead to slower import performance in that context.
Windows: The Cursor is visible when Cursor.visible is set to false and new InputSystem package is used (1273522)
Polybrush: [PolyBrush] Something went wrong saving brush settings Warning is thrown when Saving a Brush after opening the PolyBrush Window (1315475)
Shader System: Freeze or crash with various stack traces when opening a project while connected to a VPN service (1025558)
Audio: [editor][fmod][macOS] Editor is preventing Mac OS from entering sleep mode automatically (995866)
Packman: Package Manager doesn't show available updates (1304459)
Linux: Focus cannot be properly gained on play mode, making keyboard input switch screens (1109908)
Audio: Crash on AudioSource::Stop when exiting Play mode (1079263)
2018.4.32f1 Release Notes
Fixes
Build Pipeline: Fixed a case where IOrderedCallback returning int.Max or int.Min could be called in incorrect order. (1282571)
Build Pipeline: Fixed a case where selecting a dll while the Build Window was open could throw exceptions. (1137088)
Build Pipeline: Fixed instability in Lzma compressor where a complete signal could be fired and the compressor will exit before processing all data. (1170712)
Editor: Fixed audio clip preview playback position when clicking on the waveform. (1294273)
Editor: Fixed pop-up windows like Color Picker close upon clicking them when they are hovered on immediately after opening. (1239613)
iOS: Fixed GetKeyUp and GetKeyDown functions returning true on every frame. (1218784)
iOS: Fixed rare osver/device dependent crash on exit, when [UIViewController viewWillTransitionToSize:withTransitionCoordinator:] is called on killing unity view. (1278124)
iOS: Fixed UnityPause/UnityIsPaused to not crash when called with unity runtime not inited. (1278746)
iOS: Fixed UnityWebRequest sometimes getting stuck on iOS 14.2+ when using ARFoundation. (1299873)
Particles: Fixed material batching and shadow rendering by making the particle system trail material optional. (1264831)
Profiler: Fixed Hierarchy view expansion state not persisting properly across frames stemming from the same session and between Hierarchy and Raw Hierarchy views. Additionally this fixes a potential NullPointerException in ProfilerFrameDataTreeView.AddExpandedChildrenRecursively. (1242253)
Scene Manager: Fixed GetManagerFromContext crash when unloading a Scene while loading another Scene asynchronously with allowSceneActivation = false. (1092438)
Scripting: Fixed incorrect UTC offset during daylight savings time transitions. (1288231)
Scripting: Fixed issue where Editor could freeze when enabling play mode after building. (1300269)
Text: Fixed / added support for selecting which font face and style will be loaded from TrueType Collection (TTC) font files. (1309610)
Text: Fixed excessive memory overhead when loading font files from Font objects. (1309608)
Text: Fixed glyph positional adjustments sometimes returning a value of -Infinity. (1309609)
LTS Release 2020.2.4f1
LTS Release 2020.2.4f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2020.2.4f1
Global Illumination: [macOS] BugReporter doesn't get invoked when the project crashes (1219458)
uGUI: AspectRatioFitter gives a warning when changing the Components Aspect Ratio if it's attached to a Canvas (1302464)
Templates: [Linux] Missing libdl.so library causes crash when entering Playmode for the second time or closing the Editor (1237642)
Global Illumination: Reflection Probe is not baked after pressing "Bake" button in the per-probe Inspector window (1311231)
Scene Management: Freeze or crash on EditorSceneManager::ReloadScene when importing an Asset and reloading the opened Scene (1309393)
Asset Import Pipeline: Crash on core::StringStorageDefault::append when importing assets from the Asset Store (1300615)
Scripting: Application.quitting event is not raised when closing build (1309540)
CodeEditors: Crash on System.Net.Sockets.Socket:QueueIOSelectorJob when using a VPN and opening a project that uses Visual Studio (1308797)
Cloth: Skinned Mesh Renderer's Bounds Extent is set to half of the Transform's Scale when using a Cloth Component (1209765)
Templates: Editor Crashes when performing Undo and Redo after duplicating Game Object with LEGO Model Asset component (1298503)
Texture: uGUI in Texture2D is different than in the Game view when calling ToTexture2D() method on a RenderTexture (1301378)
Asset Importers: [Performance Regression] Importing an fbx model is noticeably slower when the model contains Animations (1265275)
Linux: InputSystem's Mouse delta values do not change when the Cursor lockState is set to Locked (1248389)
Scene/Game View: [Wild Crash] Editor crashes on mono_aot_get_cached_class_info when GizmoSetup has cached an outdated data (1259765)
Build Pipeline: [Cache Server] Building process freezes on compiling shader variants when connected to Accelerator (1296800)
Input: [Input System] MultiplayerEventSystem throws a warning when more than one MultiplayerEventSystem is active (1303961)
Shuriken: Infinity loop issue about Sub-Emitters of Particle System Editor (1311111)
UI Toolkit: Editor Crashes when name of Serialized Sprite variable is edited (1302872)
Windows: The Cursor is visible when Cursor.visible is set to false and new InputSystem package is used (1273522)
XR: [XR SDK][Oculus] EarlyUpdate.XRUpdate spikes inconsistently (1262597)
2020.2.4f1 Release Notes
System Requirements Changes
Fixes
Android: Fixed rendering artifacts when using HDR rendering with MSAA on sold Mali Bifrost GPUs. (1303685)
Asset Pipeline: The Assembly version is no longer included in the script type hashes that was used for script type dependencies. (1294785)
Build Pipeline: During Player build, the progress bar would display the message "Bunding and compressing data", which contains a typo. This has been fixed to read "Bundling and compressing data". (1298398)
Burst: Fixed a crash when a call to
System.Diagnostics.Debugger.Breakfrom a Burst-compiled job or function pointer was called without a debugger attached. (1304756)DX12: Fixed GPU hang due to corrupt SRV. (1290125)
Editor: Fixed an issue with the progress bar on windows when user code drives it in "non-modal" way. (1294895, 1294898)
Editor: Fixed crash in some progress bar scenarios that resulted in recursive repaints (e.g. after turning on raytracing support in HDRP) (1299576)
GI: Fixed an issue of a missing occlusion when baking LODs with the CPU lightmapper. (1296326)
GI: Make the default skybox probe and ambient probe automatically baked until a first manual bake is done. (1250293)
Graphics: Fixed a Severe one frame Motion blur artifacts issue that occurred on editing of blend shapes. (1299209)
Graphics: Fixed an incorrect GeometryJob Fence initialisation that caused graphical corruption in UI canvas rendering. (1290714)
Graphics: Fixed an issue where ComputeShader.SetConstantBuffer caused a freeze. (1299319)
IL2CPP: Emit compilable C++ code for C# string literals containing the "\//" character sequence. (1288271)
IL2CPP: Ensure that FieldInfo objects for the same base class field from two different derived types do not match. (1295396)
IL2CPP: Fixed an incorrect behavior of asynchronous file stream reads. (1295116)
IL2CPP: Fixed an issue with re-throwing an exception from a catch that includes a nested try/catch block. (1281069)
iOS: Fixed an issue where UnityWebRequest sometimes got stuck on iOS 14.2+ when using ARFoundation. (1299873)
Kernel: Fixed random crash while executing TLSAllocator::FrameMaintenance. (1297307)
Linux: Automatically install toolchain for building Linux IL2CPP players when Linux IL2CPP component present. (1275117)
Package: Fixed an issue where Burst would erroneously error on BurstCompile.CompileFunctionPointer calls when building for the DOTS Runtime.
Package: Fixed an issue where clang segmentation fault on iOS when member function debug information were emitted, it is disabled for this platform now.
Package: Fixed an issue where explicitly casting from an int to IntPtr would not sign extend the value.
Package: Fixed DOTS Runtime JobProducer Bursting code to support JobProducers with multiple generic arguments, complex job wrapper and generic jobs.
Package: Fixed managed implementations of blend_epi32 and mm256_blend_epi32 intrinsics on Mono
Package: Intrinsics: Neon - fixed vget_low and vget_high producing suboptimal code
Package Manager: Fixed an issue where users cannot use downloaded filter for the
My Assetstab in Package Manager UI. (1307862)Particles: Fixed an issue where Rate over Distance emission sets particle ages correctly. (1261813)
Profiler: Fixed an issue with sending enable/disable recording messages to connected players, where the player would not respond to the message correctly. (1271012)
Scripting: Fixed an issue where Response files list (csc.rsp) was not passed up to external compilers. (1307780)
Serialization: Fixed a crash when opening the Preset window on an object containing SerializeReference with instances accessible from multiple property path. (1290753)
Shaders: Fixed an issue where the Shader compiler did not handles CR line endings. (1297115)
Shaders: Fixed an issue where the Shader compiler would generate calls to bitfieldExtract when building for OpenGL ES 3 or WebGL 2. (1297812)
Shaders: Fixed incorrect code being generated for GATHER_PO instruction on Vulkan. (1299508)
Text: Fixed an issue where changes to TextMesh.color could be rendered a frame too early. (1252193)
UI: Fixed an issue where if a aspectRatioFitter has a parent assigned afterwards the cached parent wouldn't update properly. (1291977)
UI Toolkit: Binding operations are done asynchronously to improve performance and avoid editor lockups (1243897)
UI Toolkit: Fixed an issue where Right-click context menu on properties would not show on every bound field. (1197268)
UI Toolkit: Fixed an issue where UQuery: Query would not correctly returns all elements. (1288531)
UI Toolkit: Fixed an issue with Focus() method on TextField controls. (1206181)
UI Toolkit: Fixed Element not visible after being hidden/shown in a specific sequence issue.
UI Toolkit: Fixed missing icons when the atlas render texture was destroyed by the engine.
UI Toolkit: Fixed wrong addressing of dynamic transforms issue when new atlas slot is used. (1293058)
Video: Fixed an issue where the VideoPlayer.frameReady was not invoked for some frames. (1187256)
Video: [MacOS] Fixed an issue where UrlSource streaming stuttered in Video Player. (1227128)
XR: Fixed a deadlock when Windows player is invisible with VR enabled. (1304200)
XR: Updated the verified AR Foundation related packages to 4.0.10. Please see the AR Foundation package changelog for details.
API Changes
GI: Added: Added two new callbacks: LightProbes.needsRetetrahedralization which is called whenever the current registered probes and tetrahedralization are out of sync, and LightProbes.tetrahedralizationCompleted which fires after (re-)tetrahedralization is done.
UI Toolkit: Changed: ChangeEvent are now called on bound field when value is first set on the control and matches default value (1273589)
Changes
Graphics: Update SRP packages to 10.3.1 (1300426)
Package Manager: Update com.unity.purchasing to 2.2.2
Timeline: Updated Timeline package to version 1.4.6
Improvements
Package: Update ProBuilder to 4.5.0.
Package: Upgrading input system package to 1.0.2
Scripting: Added support for Unity Version Defines in Assembly definition import options.
This feature improvement allows scripts to easily specify different code snippets for different unity version ranges. This is especially useful for introducing calls to newly added public APIs, in which case these API calls needs to be guarded by defines based on a unity version range of a given unity version or later.
Unity version range expression syntax is the same as package version range expressions. Unity version format differs from package version format, thus Unity version expressions are evaluated based on some rules specific to the Unity version format:Comparison of release types follows the following rules: a<b<f=c<p<x. So eg. an alpha version is always smaller (earlier) than a beta version, regardless of the Incremental version.
The unity versions are allowed to have suffixes (e.g 2020.1.3-bonfire) which are ignored by the unity version comparison code
Chinese releases are equivalent to public releases (f) so for the sake of comparison in the version range expression 2020.1f3 would be equal to 2020.1c3[
experimental releases don't include an Incremental Version - e.g. everything after 2020.2.1x would be treated as suffix and ignored by the version comparison.
Scripting: Improved code readability and naming consistency with the Unity 2021.2 and 2021.1 codebase.
Shaders: Shaders can now use UNITY_PLATFORM_<PLATFORM_NAME> defines to specialize compilation per build target platform (examples: UNITY_PLATFORM_OSX, UNITY_PLATFORM_WINDOWS).
System Requirements
For development
OS: Windows 7 SP1+, 8, 10, 64-bit versions only; macOS 10.12+. (Server versions of Windows & OS X are not tested.)
CPU: SSE2 instruction set support.
GPU: Graphics card with DX10 (shader model 4.0) capabilities.
The rest mostly depends on the complexity of your projects.
Additional platform development requirements:
iOS: Mac computer running minimum macOS 10.12.6 and Xcode 9.0 or higher.
Android: Android SDK and Java Development Kit (JDK); IL2CPP scripting backend requires Android NDK.
Universal Windows Platform: Windows 10 (64-bit), Visual Studio 2015 with C++ Tools component or later and Windows 10 SDK
For running Unity games
Generally content developed with Unity can run pretty much everywhere. How well it runs is dependent on the complexity of your project. More detailed requirements:
Desktop:
- OS: Windows 7 SP1+, macOS 10.12+, Ubuntu 16.04+
- Graphics card with DX10 (shader model 4.0) capabilities.
- CPU: SSE2 instruction set support.
iOS player requires iOS 10.0 or higher.
Android: OS 4.4 or later; ARMv7 CPU with NEON support; OpenGL ES 2.0 or later.
WebGL: Any recent desktop version of Firefox, Chrome, Edge or Safari.
Universal Windows Platform: Windows 10 and a graphics card with DX10 (shader model 4.0) capabilities
Exported Android Gradle projects require Android Studio 3.4 and later to build
LTS Release 2019.4.20f1
LTS Release 2019.4.20f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2019.4.20f1
Asset Import Pipeline: Crash on mdb_txn_begin when SourceAssetDB has a lock on it from another process (1208749)
Android: Crash with GenericRemote::CheckAndroidSDKPath when entering play mode (1302221)
Global Illumination: Reflection Probe is not baked after pressing "Bake" button in the per-probe Inspector window (1311231)
Asset Import Pipeline: Prefabs are reimporting every time a code change is made (1294785)
Mobile Rendering: [Android][URP][OpenGLES] Only RenderQueue Transparent GameObjects are rendered if Opaque Texture is enabled and MSAA is 4x or 8x (1303685)
Metal: [Apple M1] Crash on MTLGetEnvCase on startup when 'm_Automatic' is set to 0 in the ProjectSettings (1306688)
Cloth: Skinned Mesh Renderer's Bounds Extent is set to half of the Transform's Scale when using a Cloth Component (1209765)
Terrain: Terrain Lit Opacity as Density option causes alpha'd areas on the 5th layer or greater to appear with artifacts (1283124)
Shadows/Lights: Crash on ProgressiveRuntimeManager::GetGBufferChartTexture when entering UV Charts mode before baking lights (1309632)
Global Illumination: gi::InitializeManagers() takes 0.6s during Editor startup (1162775)
Global Illumination: [macOS] BugReporter doesn't get invoked when the project crashes (1219458)
Texture: uGUI in Texture2D is different than in the Game view when calling ToTexture2D() method on a RenderTexture (1301378)
Windows: The Cursor is visible when Cursor.visible is set to false and new InputSystem package is used (1273522)
Linux: InputSystem's Mouse delta values do not change when the Cursor lockState is set to Locked (1248389)
Graphics Device Backends: [Mac] Editor crashes on MTLGetEnvCase on startup when metalEditorSupport is set to 0 in the ProjectSettings (1298617)
Audio: [editor][fmod][macOS] Editor is preventing Mac OS from entering sleep mode automatically (995866)
Scene/Game View: [Wild Crash] Editor crashes on mono_aot_get_cached_class_info when GizmoSetup has cached an outdated data (1259765)
Profiling: Once paused, the Profiler does not resume recording when profiling WebGL player (1271012)
Profiling: [Profiler] playerLoop call is automatically expanded in Raw Hierarchy when Profiler.CollectEditorStats is expanded in Hierarchy (1242253)
Asset Import Pipeline: UnobservedTaskException:System.Exception: Failed to load an internal asset stored when using LoadInternalResource (1296212)
Global Illumination: [URP] Transparencies are ignored because URP uses _BaseMap as main texture identifier (1246262)
iOS: UnityWebRequest doesn't work when using a 14.2+ iOS device (1299873)
XR: [XR SDK][Oculus] EarlyUpdate.XRUpdate spikes inconsistently (1262597)
2019.4.20f1 Release Notes
Fixes
AI: Fix issue with crash during building Navmesh from multi-floor multi-area-type source. (1273805)
Animation: Fixed an issue where low numbers of Animators would not multithread correctly. (1297358)
Asset Import: Removed unsupported layerElement reference mode error logs. (1225010)
Asset Pipeline: Fixed an issue where the AssetDatabase could unload active AssetBundle streams, causing object data to be incomplete (1256745, 1281356)
Burst: Fixed a bug where explicitly casting from an int to IntPtr would not sign extend the value.
Burst: Fixed a crash when a call to
System.Diagnostics.Debugger.Breakfrom a Burst-compiled job or function pointer was called without a debugger attached. (1304756)Burst: Fixed an issue where Burst would erroneously error on BurstCompile.CompileFunctionPointer calls when building for the DOTS Runtime.
Burst: Fixed clang segmentation fault on iOS when member function debug information was emitted, it is disabled for this platform now.
Burst: Fixed DOTS Runtime JobProducer Bursting code to support JobProducers with multiple generic arguments, complex job wrapper and generic jobs.
Burst: Fixed managed implementations of blend_epi32 and mm256_blend_epi32 intrinsics on Mono
Burst: Intrinsics: Neon - fixed vget_low and vget_high producing suboptimal code
Editor: Fixed audio clip preview playback position when clicking on the waveform (1294273)
Editor: When installing the Windows editor, installing Linux Mono support alongside Linux IL2CPP support will no longer overwrite Linux IL2CPP support (1276104)
GI: Make reflection probe encoding independent of convolution type on mobile. (1269207)
Graphics: Fixed incorrect GeometryJob Fence initialisation causing graphical corruption in UI canvas rendering. (1290714)
Graphics: Fixed issue where reflections flicker when using SRP Batcher and Custom SRP (1301727)
Graphics: Missing clamp in spawn count when the system support reaping particles (1122404)
iOS: Fixed builtin deferred renderer using 2 extra encoders to just clear GBuffer (1277009)
iOS: Fixed Unity Framework warnings in built iOS project.
Particles: Fixed material batching and shadow rendering by making the particle system trail material optional. (1264831)
Particles: Fixed ParticleSystemRenderer GetMeshes freezing when one of its meshes had been destroyed and had gone null. (1238765)
Scripting: Allow CreateDelegate to work when the delegate type returns an integer, but the method type returns an enum. (1288796)
Scripting: Fixed crash that would occur when we would attempt to deserialize and new a class that is not fully instantiated. (1293534)
Scripting: Fixed incorrect UTC offset during daylight savings time transitions (1288231)
Scripting: Fixed issue where CreateNLSocket on posix systems would return an incorrect handle. (1292368)
Shaders: Fixed a crash when trying to set keywords on a material that has no shader assigned (1297087)
Shaders: Fixed an issue where saving a ShaderVariantCollection could result in shaders missing from the file. (1293591)
Shaders: Fixed Editor failures due to shader compiler communication issues when using some VPN solutions.
Shaders: Fixed local keyword from UsePass not working in the shader that uses the pass (1292128)
Shaders: Fixed shader memory being attributed to ShaderLab instead of individual shaders (1292198)
Text: Fixed bug where changes to TextMesh.color could be rendered a frame too early. (1252193)
UI Toolkit: Fixes performance of Line Renderer list of positions when its size is big enough to require scroll on the Inspector view (1296193)
Video: [MacOS] UrlSource streaming stutters in Video Player (1227128)
WebGL: Fixed a crash at startup that occurred if initial filesystem data triggered a heap resize. (1174367)
Windows: Fixed rendering freezing when switching from windowed mode to exclusive fullscreen and back on D3D11 and D3D12 graphics API when Nahimic software is installed and NahimicOSD.dll injects itself into the game. (1265095)
Windows: Fixed Windows player infrequently deadlocking when changing fullscreen modes on D3D11 and D3D12 graphics APIs.
XR: ApplicationInfo was not being properly populated on Lumin platfom. (1304736)
XR: Updated the verified AR Foundation related packages to 2.1.14. Please see the AR Foundation package changelog for details.
API Changes
- iOS: Added:
iOS.Device.iosAppOnMacflag to check if app built for iOS is running on Mac equipped with Apple Silicon chip.
Changes
GI: Make the default skybox probe and ambient probe automatically baked until a first manual bake is done. (1250293)
XR: Updated verified Windows Mixed Reality package to version 2.6.0.
Improvements
iOS: Under some circumstances, interim AA resolve will no longer result in an extra texture copy
Package: Upgrading input system package to 1.0.2
Shaders: Improved a warning about arrays in property sheets being capped to previous size (1297245)
Timeline: Updated Timeline package to version 1.2.18
System Requirements
For development
OS: Windows 7 SP1+, 8, 10, 64-bit versions only; macOS 10.12+. (Server versions of Windows & OS X are not tested.)
CPU: SSE2 instruction set support.
GPU: Graphics card with DX10 (shader model 4.0) capabilities.
The rest mostly depends on the complexity of your projects.
Additional platform development requirements:
iOS: Mac computer running minimum macOS 10.12.6 and Xcode 9.4 or higher.
Android: Android SDK and Java Development Kit (JDK); IL2CPP scripting backend requires Android NDK.
Universal Windows Platform: Windows 10 (64-bit), Visual Studio 2015 with C++ Tools component or later and Windows 10 SDK
For running Unity games
Generally content developed with Unity can run pretty much everywhere. How well it runs is dependent on the complexity of your project. More detailed requirements:
Desktop:
- OS: Windows 7 SP1+, macOS 10.12+, Ubuntu 16.04+
- Graphics card with DX10 (shader model 4.0) capabilities.
- CPU: SSE2 instruction set support.
iOS player requires iOS 10.0 or higher.
Android: OS 4.4 or later; ARMv7 CPU with NEON support; OpenGL ES 2.0 or later.
WebGL: Any recent desktop version of Firefox, Chrome, Edge or Safari.
Universal Windows Platform: Windows 10 and a graphics card with DX10 (shader model 4.0) capabilities
Exported Android Gradle projects require Android Studio 3.4 and later to build
LTS Release 2020.2.3f1
LTS Release 2020.2.3f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2020.2.3f1
Scene/Game View: [Wild Crash] Editor crashes on mono_aot_get_cached_class_info when GizmoSetup has cached an outdated data (1259765)
uGUI: AspectRatioFitter gives a warning when changing the Components Aspect Ratio if it's attached to a Canvas (1302464)
Global Illumination: Reflection Probe is not baked after pressing "Bake" button in the per-probe Inspector window (1311231)
Build Pipeline: [Cache Server] Building process freezes on compiling shader variants when connected to Accelerator (1296800)
Shuriken: Infinity loop issue about Sub-Emitters of Particle System Editor (1311111)
Templates: Editor Crashes when performing Undo and Redo after duplicating Game Object with LEGO Model Asset component (1298503)
Android: Crash with GenericRemote::CheckAndroidSDKPath when entering play mode (1302221)
Global Illumination: [macOS] BugReporter doesn't get invoked when the project crashes (1219458)
Visual Effects: [URP] OutputUpdate.compute: Kernel at index (0) is invalid when using compute culling, Lod, or Multi-mesh (1309174)
Cloth: Skinned Mesh Renderer's Bounds Extent is set to half of the Transform's Scale when using a Cloth Component (1209765)
UI Toolkit: Editor Crashes when name of Serialized Sprite variable is edited (1302872)
Input: [Input System] MultiplayerEventSystem throws a warning when more than one MultiplayerEventSystem is active (1303961)
Texture: uGUI in Texture2D is different than in the Game view when calling ToTexture2D() method on a RenderTexture (1301378)
Asset Importers: [Performance Regression] Importing an fbx model is noticeably slower when the model contains Animations (1265275)
Linux: InputSystem's Mouse delta values do not change when the Cursor lockState is set to Locked (1248389)
Asset Import Pipeline: UnobservedTaskException:System.Exception: Failed to load an internal asset stored when using LoadInternalResource (1296212)
Quality of Life: Infinite load when trying to display Lists of custom classes in Inspector (1298594)
Profiling: Once paused, the Profiler does not resume recording when profiling WebGL player (1271012)
Asset Import Pipeline: Prefabs are reimporting every time a code change is made (1294785)
Vulkan: Crash in Windows Standalone when Vulkan is set as rendering API and player window is out of focus (1309519)
Profiling: [Profiler] playerLoop call is automatically expanded in Raw Hierarchy when Profiler.CollectEditorStats is expanded in Hierarchy (1242253)
Asset Import Pipeline: CPU usage spikes in the Loading.LockPersistentManager when async loading/unloading Scenes with Terrain (1276854)
UI Toolkit: [UIR] Rendering is broken with UIToolkit with many Intel GPUs (driver-bug) (1309555)
XR: [XR SDK][Oculus] EarlyUpdate.XRUpdate spikes inconsistently (1262597)
iOS: UnityWebRequest doesn't work when using a 14.2+ iOS device (1299873)
Scene Management: Crash on StackAllocator::WalkAllocations when loading another Scene whilst in Play Mode (1297307)
Shadows/Lights: Skybox lighting is not rendered after creating gameobjects in the new scene until the lighting is rebaked (1250293)
Packman: Unable to filter on downloaded assets (1307862)
2020.2.3f1 Release Notes
System Requirements Changes
Fixes
2D: Fixed TilemapRenderer in Individual mode not rendering Tiles with Tilemap Color. (1295449)
Android: Fix Application.targetFrameRate and Screen.currentResolution.refreshRate on some variable refresh rate displays (1297149)
Android: Fixed Android Export Project option when Il2CPP used with C++ Compiler Configuration Master (1273917)
Animation: Fixed a bug where the most recent Animation Event is not triggered again when resetting Playable Time with SetTime(-1) (1230810)
Asset Import: Removed unsupported layerElement reference mode error logs. (1225010)
Audio: Fixed DSPGraph mixer thread exceptions. (1297730)
Audio: Fixed DSPGraph playback not pausing when player is paused.
Build Pipeline: Fix Unity command line player build failing due to invalid path argument to '-buildLinux64Player' (1285375)
Burst: Support for loading additional burst libraries in playmode/standalone for modding support. (1294664)
DX12: Fix for shader resource view of indirect argument buffer (1276431)
Editor: Added missing keycode mappings for special characters (e.g. ^, ~, |) (1281473)
Editor: Ensure there's proper Prefab and context menu handling for a ReorderableList as a whole, also when removing elements from the list. (1292522)
Editor: Exposed BuildUtility.BuildCanBeAppended to check for possibility of BuildOptions.AcceptExternalModificationsToPlayer usage (1288856)
Editor: Fix SceneHierarchy renaming using the context menu while a renaming is already active. (981190)
Editor: Fixed an issue where Asset Database dependencies were not included when exporting packages. (1250495)
Editor: Fixed AppStatusBar throwing MissingReferenceException when the Editor Layout is reset during Progress Bar updates. (1296666)
Editor: Fixed audio clip preview playback position when clicking on the waveform. (1294273)
Editor: Fixed Game Objects with Playable Director component can't be turned into a prefab when Timeline window is open in preview mode. (1223541)
Editor: Fixed ReorderableList not being drawn correctly while in horizontal layout (1289222)
Editor: Fixed serialized private inherited arrays not being reorderable by default (1298115)
Editor: Fixed [NonReorderable] not being applied to a private arrays inside a struct (1298288)
GI: Fixed color space for directional lightmap while baking with progressive updates. (1296784)
GI: Increase numerical stability in tetrahedralization code. (1287878)
Graphics: Added support for CreateExternalTexture with the Vulkan API
Graphics: Fixed an issue where the was no warning about double usage in shaders on metal. (1281502)
Graphics: Fixed incorrect shadows when using DrawMeshInstancedIndirect. (1281700)
Graphics: Fixed issue where speedtree textures were becoming unbound after clicking "Regenerate materials". (1231184)
Graphics: Fixed metal/vulkan shaders sometimes referencing inputs omitted by the compiler. (1277144)
Graphics: Fixed metal/vulkan shaders sometimes referencing outputs omitted by the compiler. (1290551)
Graphics: Fixed shaders that use immediate consts failing compilation under some circumstances (1283218)
Graphics: Fixed situation where Hybrid Renderer could throw errors because of invalid reflection data
Graphics: Issue an error message when trying to use the Hybrid Renderer V2 with SRP Batcher OFF. Also deterministically skip the rendering in this case. (1300072)
Graphics: Readded VSync Count tooltip in Quality Settings (1296699)
Graphics: Removed excessive CustomRenderTexture updates and fixed various dependency issues. (1249916, 1279212)
Graphics: Support for Crunched 16k textures. (1286157)
Graphics: Texture2D.PackTextured changes so that compressed textures with mips and a padding greater than zero are now decompressed (see documentation for details) (1063640)
IL2CPP: Avoid a crash on startup for assemblies that use nested types in the type. Google Ad Mobs has one such assembly, for example. (1287997)
IL2CPP: Fixed file and directory patterns ending with ".*" incorrectly including files names that partially match on non Windows platforms. (1286554)
IMGUI: Fixed the MissingMethodException when adding elements to ReorderableList with String type (1289219)
iOS: When selected XCode project build destination is not allowed (root project folder, Assets folder, etc.) warning is displayed.
Linux: Fixed an issue where the Linux Downloader would not properly extract files (1278063)
Linux: Fixed tooltip shows up in the window switcher as a separate window (1287440)
macOS: When selected XCode project build destination is not allowed (root project folder, Assets folder, etc.) warning is displayed.
Networking: UnityWebRequest: DownloadHandler.text will handle exception if encoding is not supported (fallback to UTF-8). (1288445)
Package Manager: Fixed 'My Registries' menu not showing up after configuring a scoped registry.
Package Manager: Fixed an issue where missing
localhostin the hosts file configuration could prevent Unity from connecting to the Unity Package Manager. (1295543)Package Manager: Fixed issues when using Unity Package Manager on Intel's 10th generation processor. (1238432)
Package Manager: Fixed issues where updates to outdated Assets does not show up in the Package Manager UI (1304459)
Package Manager: Fixed the issue where
Open in Unityfrom Asset Store results in endless loading in Package Manager (1297749)Particles: Fixed ParticleSystemRenderer GetMeshes freezing when one of its meshes had been destroyed and had gone null. (1238765)
Physics: Display Linear and Angular damping in the root of the ArticulationBody.
Prefabs: Fixed that dragging a Prefab asset to the Scene view while in Prefab Mode in Context did not render the dragged object normally but instead using the context render mode. (1279539)
Profiler: Fixed crash due to used textures stats counting when gfx jobs are enabled (1293569)
Profiler: Fixed ProfilerRecorder for "GC Allocated In Frame" reports 0 bytes if the Profiler isn't currently recording (1293607)
Profiler: Prevent disabled Profiler modules from pulling Profiler statistics. (1293059)
Profiler: Prevent the chart separator lines from disappearing when resizing or scrolling in the Profiler window. (1293049)
Scripting: Changed NativeArray limit of 2GiB in size, and now it can contain 2^31 items instead. (1262850)
Scripting: Fixed ApiUpdater internal recursion when assigning to deprecated Component.rigidbody (1276562)
Scripting: Fixed hang that would be encountered when mono's finalizer thread would compete with the debugger thread for a lock. (1288953)
Scripting: Fixed potential AsseblyUpdater assembly corruption when applying Camera.GetScreenHeight() / GetScreenWidth() -> Screen.height/width updates.
Scripting: Fixed potential AsseblyUpdater assembly corruption when field name and type needs updating.
Serialization: Fixed crash reordering array of struct, containing SerializeReference fields and non SerializeReference fields as well under certain circumstances. (1302360)
Serialization: FormerlySerializedAs attribute now correctly new value instead of old value if both are present. (1296458)
Serialization: ProjectSettings will now get re-serialized as text instead of as binary. (1289736)
Shaders: Fixed a crash when trying to set keywords on a material that has no shader assigned (1297087)
Shaders: Fixed compute and raytracing shader caching regression. (1306116)
Shaders: Fixed handling of the scalar after the matrix that is not 4xN. (1242345)
Shaders: Fixed local keyword from UsePass not working in the shader that uses the pass (1292128)
Shaders: Fixed shader memory being attributed to ShaderLab instead of individual shaders (1292198)
Terrain: Fix the case where terrain appears temporarily white during a scene save. (1304414)
Terrain: Fixed a crash when neighboring terrains have inconsistent heightmap settings. (1300660)
Terrain: Fixed terrain GI baking where holes are painted. (1300585)
Terrain: Fixed terrain normal maps and mask textures around holes. (1301214)
Terrain: Fixed the terrain geometry after painting holes. (1299939)
UI: Fix issue where a Graphic could be set as a raycast target even is disabled. (1290917)
UI Toolkit: Fixed performance of Line Renderer list of positions when its size is big enough to require scroll on the Inspector view. (1296193)
Video: [osx] Fixed a crash when playing a video at speed > 2x. (1240116)
XR: Fix Vulkan broken on Oculus Quest. (1304463)
Changes
Shaders: Increased the global shader keyword limit to 384.
XR: The Oculus XR Plugin package has been updated to 1.7.0.
XR: Updated Windows XR SDK Plug-in to 4.4.0
XR: Updated XR Plug-in Management to 3.2.17
Improvements
Physics: Rearrange the ArticulationBody properties so that damping and friction is located right after mass and is not visually separated from it by the anchor properties
Prefabs: Undo operations on objects in nested prefabs has been optimized by up to 30%
Shaders: Improved a warning about arrays in property sheets being capped to previous size (1297245)
System Requirements
For development
OS: Windows 7 SP1+, 8, 10, 64-bit versions only; macOS 10.12+. (Server versions of Windows & OS X are not tested.)
CPU: SSE2 instruction set support.
GPU: Graphics card with DX10 (shader model 4.0) capabilities.
The rest mostly depends on the complexity of your projects.
Additional platform development requirements:
iOS: Mac computer running minimum macOS 10.12.6 and Xcode 9.0 or higher.
Android: Android SDK and Java Development Kit (JDK); IL2CPP scripting backend requires Android NDK.
Universal Windows Platform: Windows 10 (64-bit), Visual Studio 2015 with C++ Tools component or later and Windows 10 SDK
For running Unity games
Generally content developed with Unity can run pretty much everywhere. How well it runs is dependent on the complexity of your project. More detailed requirements:
Desktop:
- OS: Windows 7 SP1+, macOS 10.12+, Ubuntu 16.04+
- Graphics card with DX10 (shader model 4.0) capabilities.
- CPU: SSE2 instruction set support.
iOS player requires iOS 10.0 or higher.
Android: OS 4.4 or later; ARMv7 CPU with NEON support; OpenGL ES 2.0 or later.
WebGL: Any recent desktop version of Firefox, Chrome, Edge or Safari.
Universal Windows Platform: Windows 10 and a graphics card with DX10 (shader model 4.0) capabilities
Exported Android Gradle projects require Android Studio 3.4 and later to build
LTS Release 2019.4.19f1
LTS Release 2019.4.19f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2019.4.19f1
Asset Import Pipeline: UnobservedTaskException:System.Exception: Failed to load an internal asset stored when using LoadInternalResource (1296212)
Graphics Device Backends: [Mac] Editor crashes on MTLGetEnvCase on startup when metalEditorSupport is set to 0 in the ProjectSettings (1298617)
Audio: [editor][fmod][macOS] Editor is preventing Mac OS from entering sleep mode automatically (995866)
Asset Import Pipeline: Prefabs are reimporting every time a code change is made (1294785)
Android: Crash with GenericRemote::CheckAndroidSDKPath when entering play mode (1302221)
Mobile Rendering: [Android][URP][OpenGLES] Only RenderQueue Transparent GameObjects are rendered if Opaque Texture is enabled and MSAA is 4x or 8x (1303685)
iOS: UnityWebRequest doesn't work when using a 14.2+ iOS device (1299873)
Global Illumination: gi::InitializeManagers() takes 0.6s during Editor startup (1162775)
Global Illumination: [macOS] BugReporter doesn't get invoked when the project crashes (1219458)
Texture: uGUI in Texture2D is different than in the Game view when calling ToTexture2D() method on a RenderTexture (1301378)
Global Illumination: [URP] Transparencies are ignored because URP uses _BaseMap as main texture identifier (1246262)
Linux: InputSystem's Mouse delta values do not change when the Cursor lockState is set to Locked (1248389)
Shadows/Lights: Skybox lighting is not rendered after creating gameobjects in the new scene until the lighting is rebaked (1250293)
Profiling: [Profiler] playerLoop call is automatically expanded in Raw Hierarchy when Profiler.CollectEditorStats is expanded in Hierarchy (1242253)
UI Toolkit: [UIR] Rendering is broken with UIToolkit with many Intel GPUs (driver-bug) (1309555)
XR: [XR SDK][Oculus] EarlyUpdate.XRUpdate spikes inconsistently (1262597)
Shader System: Freeze or crash with various stack traces when opening a project while connected to a VPN service (1025558)
Profiling: Once paused, the Profiler does not resume recording when profiling WebGL player (1271012)
Window Management: A second blank editor window is opened and may cause a crash when opening a project (1286251)
Scene/Game View: [Wild Crash] Editor crashes on mono_aot_get_cached_class_info when GizmoSetup has cached an outdated data (1259765)
2019.4.19f1 Release Notes
Fixes
2D: Fix TilemapRenderer in Individual mode not rendering Tiles with Tilemap Color (1295449)
AI: Fixed exception when requesting a path with a negative agent type ID. (1278829)
Android: Fix Application.targetFrameRate and Screen.currentResolution.refreshRate on some variable refresh rate displays (1297149)
Android: Fix regression in 180 degree rotation reporting. (1273594)
Android: SafeArea size not being correctly calculated when resolution is changed. (1285223)
Animation: Fixed crash caused by AnimationState using invalid reference. (1256962)
Asset Pipeline: 'Verify Saving Assets' option causes a NullReferenceException to be thrown when saving certain Assets (1257929)
Asset Pipeline: Fix for bug where the main object would change after renaming a native asset (1189089)
Asset Pipeline: Fixed an issue where an inconsistency can be introduced in the asset database when duplicating folders - affects ADBv1 only. (1292015)
Audio: Fix certain audio clips encoded to Vorbis or for WebGL builds from failing playback despite completing import without errors. (1293595)
Build Pipeline: Fix Unity command line player build failing due to invalid path argument to '-buildLinux64Player' (1285375)
Build Pipeline: Fixed a case where calling GetImplicitAssetBundleName or GetImplicitAssetBundleVariantName on a deleted asset would throw an incorrect exception and return invalid values. (913864)
Build Pipeline: Fixed a case where IOrderedCallback returning int.Max or int.Min could be called in incorrect order. (1282571)
Build Pipeline: Fixed a case where selecting a dll while the Build Window was open could throw exceptions. (1137088)
Build Pipeline: Fixes instability in Lzma compressor where a complete signal could be fired and the compressor will exit before processing all data. (1170712)
Editor: added missing keycode mappings for special characters (e.g. ^, ~, |) (1281473)
Editor: Fixed issue where scene visiblity/picking didn't work with objects in the DontDestroyOnLoad scene. (1234777)
GI: Increase numerical stability in tetrahedralization code. (1287878)
Graphics: Fix Particle System incorrect rendering order when using 'Sorting Fudge'. (1256788)
Graphics: Fixed cascaded shadows from directional lights suddenly disappearing under certain nearplane/shadow distance constellations. This error was occurring when Stable Fit shadow cascades were used. (1225499)
Graphics: fixed metal/vulkan shaders sometimes referencing inputs omitted by the compiler. (1277144)
Graphics: fixed metal/vulkan shaders sometimes referencing outputs omitted by the compiler. (1290551)
Graphics: Fixed missing support for coarse/fine derivatives in shader code.
Graphics: properly warn about double usage in shaders on metal. (1281502)
Graphics: Texture2D.PackTextured changes so that compressed textures with mips and a padding greater than zero are now decompressed (see documentation for details) (1063640)
IMGUI: Fixed the text cursor becoming invisible if an exception was thrown from inside of SelectableLabel. (1293370)
iOS: Added iPhone SE 2nd Generation to DeviceGeneration (1280059)
iOS: Fixed game crashing after using Social.LoadUsers and then changing scene (1270230)
Kernel: Print info about which allocator Unity engine is using. (1296992)
Linux: Fixed crash on startup if the layout file is corrupted. (1275287)
Networking: UnityWebRequest: DownloadHandler.text will handle exception if encoding is not supported (fallback to UTF-8) (1288445)
Package Manager: Fixed an issue where missing
localhostin the hosts file configuration could prevent Unity from connecting to the Unity Package Manager. (1295543)Package Manager: Fixed issues when using Unity Package Manager on Intel's 10th generation processor. (1238432)
Package Manager: Fixed issues where updates to outdated Assets does not show up in the Package Manager UI (1304459)
Prefabs: Fix distorted UI for Prefab override comparison window when a changed component is selected. (1069062)
Profiler: Fixed "Show Calls" view not counting Calls correctly for the "Called From" section in Profiler Window (1180144)
Profiler: Prevent the chart separator lines from disappearing when resizing or scrolling in the Profiler window. (1293049)
Scene Manager: Fix GetManagerFromContext crash when unloading a Scene while loading another Scene asynchronously with allowSceneActivation = false (1092438)
Serialization: Fix crash reordering array of struct, containing SerializeReference fields and non SerializeReference fields as well under certain circumstances. (1302360)
Serialization: FormerlySerializedAs attribute now correctly new value instead of old value if both are present. (1296458)
Serialization: ProjectSettings will now get re-serialized as text instead of as binary. (1289736)
Shaders: Exposed Render Queue control on the Standard shader (1287934)
Shaders: fixed handling of the scalar after the matrix that is not 4xN (1242345)
SpeedTree: A Fix button now will appear in Mesh Renderer and LOD Group component inspector if Unity detects wrong SpeedTree shader is used (for instance Nature/SpeedTree8 shader is used for meshes that come from SpeedTree 7 assets, and vice versa), and will correct them if clicked. (1237736)
UI: Add option to not activate the inputfield on selection. Helpful for controller based platforms where navigating to items is required to navigate UI. (1268708)
Universal Windows Platform: Fixes a rare crash within TouchScreenKeyboard caused by a race condition (1286442)
Universal Windows Platform: Fixes old TouchScreenKeyboard and XAML forms from being used in XAML HoloLens apps (1256386)
Video: VideoPlayer.frameReady not invoked for some frames. (1187256)
WebGL: Fix a memory error crash when using the "Convert To Entity" component. (1254779)
Windows: Fix Cursor not updating in the Player when using NewInput (1238158)
Windows: We now log the full Windows 10 version including edition, build (with UTR) Version, and architecture when running the editor for better diagnosis. (1251004)
API Changes
- Build Pipeline: Added: Backported NonRecursive Dependency Calculation and Fast Asset Representation Build Pipeline APIs for improvements in the Scriptable Build Pipeline.
Changes
Shaders: Increased the global shader keyword limit to 384.
XR: The Oculus XR Plugin package has been updated to 1.7.0.
System Requirements
For development
OS: Windows 7 SP1+, 8, 10, 64-bit versions only; macOS 10.12+. (Server versions of Windows & OS X are not tested.)
CPU: SSE2 instruction set support.
GPU: Graphics card with DX10 (shader model 4.0) capabilities.
The rest mostly depends on the complexity of your projects.
Additional platform development requirements:
iOS: Mac computer running minimum macOS 10.12.6 and Xcode 9.4 or higher.
Android: Android SDK and Java Development Kit (JDK); IL2CPP scripting backend requires Android NDK.
Universal Windows Platform: Windows 10 (64-bit), Visual Studio 2015 with C++ Tools component or later and Windows 10 SDK
For running Unity games
Generally content developed with Unity can run pretty much everywhere. How well it runs is dependent on the complexity of your project. More detailed requirements:
Desktop:
- OS: Windows 7 SP1+, macOS 10.12+, Ubuntu 16.04+
- Graphics card with DX10 (shader model 4.0) capabilities.
- CPU: SSE2 instruction set support.
iOS player requires iOS 10.0 or higher.
Android: OS 4.4 or later; ARMv7 CPU with NEON support; OpenGL ES 2.0 or later.
WebGL: Any recent desktop version of Firefox, Chrome, Edge or Safari.
Universal Windows Platform: Windows 10 and a graphics card with DX10 (shader model 4.0) capabilities
Exported Android Gradle projects require Android Studio 3.4 and later to build
LTS Release 2018.4.31f1
LTS Release 2018.4.31f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2018.4.31f1
macOS: If the Android Tools are not installed through the Hub, macOS 10.15 (Catalina) default security settings will prevent the Android NDK binaries being executed. These settings have to be changed or a signed Android NDK (r16b) will be needed to build Android. More information here: https://developer.android.com/ndk/downloads/older_releases.
Package Manager: Immutable packages altered by the API Updater are reverted to their original state when packages are resolved, which can lead to slower import performance in that context.
Audio: [editor][fmod][macOS] Editor is preventing Mac OS from entering sleep mode automatically (995866)
WebGL: [2018.4 only] Editor freezes when enabling Play mode after Building (1300269)
Packman: Package Manager doesn't show available updates (1304459)
Shader System: Freeze or crash with various stack traces when opening a project while connected to a VPN service (1025558)
Audio: Crash on AudioSource::Stop when exiting Play mode (1079263)
Linux: Focus cannot be properly gained on play mode, making keyboard input switch screens (1109908)
Window Management: Pop-up windows like Color Picker close upon clicking them when they are hovered on immediately after opening (1239613)
2018.4.31f1 Release Notes
Fixes
Android: Fixed Application.targetFrameRate and Screen.currentResolution.refreshRate on some variable refresh rate displays. (1297149)
Audio: Fixed "Assertion failed on expression" message in console when disabling the audio system from the project settings while an audio clip preview is playing. Also, the preview playback will now stop in this scenario. (1232267)
Audio: Fixed audio in timeline preview not pausing/resuming when changing focus between the editor and other applications. (1016423)
Build Pipeline: Fixed to refresh code compiling after force quit. (1289931)
Editor: Added a new prompt for a user to attach a managed debugger when on Linux, on a headless server build. Also prevents timeout to attach Profiler triggering when allowDebugging is set. (1274332)
Editor: Fixed exception when deleting folder in Favorite. (1229937)
Graphics: Fixed a crash when resizing the materials array on a renderer when using material property blocks. (1188507)
Graphics: Fixed crash when loading assetbundle texture with out-of-bound mipmap bias value in DX12. (1179311)
Graphics: Fixed metal/vulkan shaders sometimes referencing inputs omitted by the compiler. (1277144)
Graphics: Fixed metal/vulkan shaders sometimes referencing outputs omitted by the compiler. (1290551)
Graphics: Fixed shaders that use immediate consts failing compilation under some circumstances. (1283218)
Graphics: Fixed Texture2DArray, CubemapArray and SparseTexture being not supported in batch mode. (1291999)
IL2CPP: Fixed file and directory patterns ending with ".*" incorrectly including files names that partially match on non Windows platforms. (1286554)
iOS: Added iPad Pro 4th Generation and iPad Pro 11" 2nd Generation to DeviceGeneration. (1280059)
iOS: Fixed crash when closing app while still loading ODR. (1289143)
Mobile: Fixed iOS 11+ motion API feature access generating warnings on iOS 10 builds.
Networking: Fixed possible data corruption in UploadHandlerFile. (1238418)
Profiler: Fixed Hierarchy Views randomly collapsing (i.e. hiding their children) parts of the sample tree when Editor Only samples are present in a frame and the "Collapse EditorOnly Samples" option is turned on (default setting is on). (1297955)
Profiler: Fixed scrollbar in timeline not responding to clicks.
Profiler: Fixed scrollbar in timeline view stopping responding to clicks. (1280332)
Scripting: Fixed 'unexpected internal compiler error' when executing a job. (1278041)
Scripting: Fixed modules being disabled by a platform not getting reenabled when switching platforms which could cause incorrect compiler errors. (1286509)
Shaders: Fixed handling of the scalar after the matrix that is not 4xN. (1242345)
Terrain: Fixed such that Paint Terrain Help properly wraps. (1281097)
Terrain: Fixed such that undoing after removing terrain layer correctly restores alphamaps. (1276283)
WebGL: Fixed a crash with Unity web loader on new macOS Big Sur.
Changes
- Package Manager: Updated com.unity.purchasing to 2.2.1, adding full support for the implementation of GooglePlay Billing Library v3 library in the Asset Store In-App Purchasing module (includes an essential runtime hotfix over 2.2.0).
LTS Release 2020.2.2f1
LTS Release 2020.2.2f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2020.2.2f1
Packman: Unable to filter on downloaded assets (1307862)
Input: [Input System] MultiplayerEventSystem throws a warning when more than one MultiplayerEventSystem is active (1303961)
iOS: UnityWebRequest doesn't work when using a 14.2+ iOS device (1299873)
Asset Import Pipeline: Prefabs are reimporting every time a code change is made (1294785)
Global Illumination: [macOS] BugReporter doesn't get invoked when the project crashes (1219458)
UI Toolkit: Editor Crashes when name of Serialized Sprite variable is edited (1302872)
Texture: uGUI in Texture2D is different than in the Game view when calling ToTexture2D() method on a RenderTexture (1301378)
Asset Import Pipeline: UnobservedTaskException:System.Exception: Failed to load an internal asset stored when using LoadInternalResource (1296212)
Quality of Life: Infinite load when trying to display Lists of custom classes in Inspector (1298594)
Build Pipeline: [Cache Server] Building process freezes on compiling shader variants when connected to Accelerator (1296800)
Templates: Editor Crashes when performing Undo and Redo after duplicating Game Object with LEGO Model Asset component (1298503)
Asset Importers: [Performance Regression] Importing an fbx model is noticeably slower when the model contains Animations (1265275)
Cloth: Skinned Mesh Renderer's Bounds Extent is set to half of the Transform's Scale when using a Cloth Component (1209765)
Linux: InputSystem's Mouse delta values do not change when the Cursor lockState is set to Locked (1248389)
XR: [XR SDK][Oculus] EarlyUpdate.XRUpdate spikes inconsistently (1262597)
Shadows/Lights: Skybox lighting is not rendered after creating gameobjects in the new scene until the lighting is rebaked (1250293)
Serialization: Crash on WalkTypeTreeComplete<
SerializedProperty::ContainsManagedReferences'::2'::IsManagedReferenceVisitor> (1302360)Profiling: Once paused, the Profiler does not resume recording when profiling WebGL player (1271012)
Scene Management: Crash on StackAllocator::WalkAllocations when loading another Scene whilst in Play Mode (1297307)
Packman: Package Manager doesn't show available updates (1304459)
HD RP: Upgrading a HDRP project results in numerous Kernel at index invalid errors (1306116)
Terrain: Crash on TerrainManager::CullAllTerrains when opening a scene with neighboring terrains (1300660)
Linux: Linux Editor tooltip shows up in the window switcher as a separate window (1287440)
2020.2.2f1 Release Notes
System Requirements Changes
Fixes
AI: Fix NavMeshAgent oscillates across a point when moving close to edges (1274343)
AI: Fixed a crash that occured during building Navmesh from multi-floor multi-area-type source. (1273805)
AI: Fixed an editor crash when a mesh used for baking the NavMesh got destroyed. (1070148)
AI: Fixed exception when requesting a path with a negative agent type ID. (1278829)
Android: Export gradle project failing when using custom base build.gradle only the first time. (1245249)
Android: Fix regression in 180 degree rotation reporting. (1273594)
Android: Fixed a framebuffer fetch on Adreno issue. (1271787)
Android: Fixed an issue where draws after indirect draw result in corrupt geometry on Adreno. (1271258)
Android: Fixed issue when Unity Remote system is unable to connect to Android devices due to incorrect adb executable file path. (1251622)
Animation: Fixed a crash caused by Avatars in Prefabs. (1278233)
Animation: Fixed crash when calling SamplePlayableGraph with Custom Playable (1272325)
Asset Bundles: Fixed occasional graphics job related crash when unloading an AssetBundle that contains Shaders (1264580)
Asset Import: Fixed "ArgumentOutOfRangeException: StartIndex cannot be less than zero" errors when selecting some specific Models. (1287132)
Asset Import: Fixed issue where meshes with no material assigned in FBX files are imported with a transparent material. (1290483)
Asset Import: Fixed wrong pivot conversion when ResampleCurves is disabled in ModelImporter. (1283884)
Asset Pipeline: Fixed an issuw where previews of assets using SRP were pink when the pipeline hasn't been persisted. (1264676)
Asset Pipeline: Fixed issue where Assertion failed on expression: 'txn.IsBlacklistEmpty()' was being triggered, due to certain checks not happening before a Refresh was deemed completed. (1247090)
Audio: In the editor the audio output device is now automatically suspended after a longer duration of inactivity in order to allow the operating system to enter sleep mode. This can be disabled in the audio project settings. (995866)
Burst: Fixed a bug in LLVM that it would incorrectly convert some memset -> memcpy if both pointers derived from the same memory address, and where one indexed into the 0th element of the pointer.
Burst: Fixed a failure on linux builds where libdl.so cannot be found.
Burst: Fixed managed implementation of sub_ss intrinsic.
Burst: Made
math.shufflecompile correctly when non-constantShuffleComponent's are used.DX12: Fixed a crash when executing a CommandBuffer that references a deleted RayTracingAccelerationStructure object. (1296035)
DX12: Fixed recurring errors in the Console window when using Light Probe mode Off usage and ray tracing. (1291419)
DX12: Fixed [D3d12 - "Failed to create a heap!"] message when starting editor in D3D12 mode (1284462)
Editor: C# scripts containing instructions in disabled conditional sections that are located before preprocessor directives are now correctly imported. (1295088)
Editor: Fixed a crash occurring in the Recent Scenes menu option when a Scene is unloaded in SceneOpenedCallback. (1294937)
Editor: Fixed a FileNotFoundException issue when using gzip compression for WebGL on Linux. (1268262)
Editor: Fixed an issue that would result in the Unity Editor Update Check window opened in an incorrect state followed by the Editor crashing. (1285668)
Editor: Fixed an issue when pop-up windows like Color Picker closed upon clicking them when they were hovered on immediately after opening. (1239613)
Editor: Fixed an issue where deselecting floating preview window throws null reference exception and GUI errors. (1278192)
Editor: Fixed an issue where SearchField showed a clear button when passed a null search text string. (1252262)
Editor: Fixed array element selection being lost after performing undo. (1292456)
Editor: Fixed array inspector header not opening a context menu issue. (1282685)
Editor: Fixed issue where scene visiblity/picking didn't work with objects in the DontDestroyOnLoad scene. (1234777)
Editor: Fixed missing icon size slider in project browser in one column layout. (1295227)
Editor: Fixed ReorderableList having wrong label/field width ratio
Editor: Fixed ReorderableList not being correctly indented while defined in serializable classes and structs (1292183)
Editor: Fixed Script Execution Order Add Item drop-down menu in Project Setings was not opening in the Windows Editor when there were over 1000 items, prevents drop down menu item insertion when system limit was reached instead of preventing insertion above 1000 item. (1265757)
Editor: Fixed spurious memory leak warning when using JobHandle.CombineDependencies() with long-running jobs. (1284488)
Editor: Fixed the null reference exception that occurs each time a user game is recompiled. (1273144)
Editor: Properly show update check window in the editor on application launch when a new version is available. (1274737)
Editor: Reverted fontRenderingMode from FontRenderingMode.Smooth back to FontRenderingMode.OSDefault. (1262281)
Editor: Windows Download Assistant no longer calculates the install size as being the same as the download size (1297868)
GI: Fixed a crash in Enlighten::CpuUpdateManager::UpdateGpuTexture when starting GI bake after baking previous scene with GPU progressive lightmapper. (1250819)
GI: Fixed a crash in progressive lightmapper seam stitching when a mesh containing NaNs was added. (1263058)
GI: Fixed an issue wehre the reflection probe encoding was not independent of convolution type on mobile. (1269207)
GI: Fixed an issue where realtime textures could be assigned to a customProbe. A warning is now displayed. (1243849)
Graphics: Added ability to check equality for SwapChainConfiguration.
Graphics: Added fast bath for ComputeShader.Begin/EndWrite on Console DX11 (1295411)
Graphics: CPU optimisation for graphics memory allocation/deallocations.
Graphics: Disabled Texture MipMap Stripping of Crunch Compressed textures. (1295490)
Graphics: Fix targetTexture rendering black screen when changing it in OnPreRender(). (1274376)
Graphics: Fixed a crash when optimizing Mesh which contained overlapped indices in sub meshes. (1288561)
Graphics: Fixed a performance isssue with SRP Batcher ON and very specific highly static batched scene. (1295145)
Graphics: Fixed a Player crash with Size overflow in allocator from AllocAndFillInstancedData (hybrid v1). (1289613)
Graphics: Fixed an incorrect rendering order issue by the Particle System when using 'Sorting Fudge'. (1256788)
Graphics: Fixed an issue where a list of exposed VT formats were out of sync. (1283237)
Graphics: Fixed an issue where the Editor text on Mac OSX would randomly become corrupted. (1267885)
Graphics: Fixed assert triggered when using RenderTexture with a VT stack. (1284710)
Graphics: Fixed cascaded shadows from directional lights suddenly disappearing under certain nearplane/shadow distance constellations. This error was occurring when Stable Fit shadow cascades were used. (1225499)
Graphics: Fixed data race on constant buffer data on DX12. (1299525)
Graphics: Fixed GLES device leaking texture IDs in some circumstances (1261513)
Graphics: Fixed mastertexture limit affecting the miplevel of cubemaps in the player. (1277191)
Graphics: Fixed Texture2DArray, CubemapArray and SparseTexture being not supported in batch mode (1291999)
Graphics: terrain tree imposters transparency fix on GLES (1287879)
Graphics: Using Mesh Compression import setting on non-standard vertex data formats no longer crashes. (1267820)
Graphics: [VFX] SRP Batcher issues with VFX Shadow-casters (1296980)
IL2CPP: Fix a case where an interface could be incorrectly removed from a type when no .ctor for that type was marked. (1222808)
IMGUI: Fixed an issue when Event.mousePosition value was not updated throughout the drag operation while dragging assets in scene. (1287856)
IMGUI: Fixed the text cursor becoming invisible if an exception was thrown from inside of SelectableLabel. (1293370)
Kernel: Print info about which allocator Unity engine is using. (1296992)
License: Client can now parse latest PACL xml schema
License: Fixed license validation when serial number is empty on macOS (1279866)
Linux: Fixed an issuw with Invalid window layouts crashing the editor when loaded. (1286251)
Linux: Fixed game controller and joystick serial numbers (1269974)
macOS: Fixed Apple silicon DTK freezing when running Unity. (1292999)
Networking: UnityWebRequest: fix possible data corruption in UploadHandlerFile (1238418)
Package: The Post-Processing package has been updated to version 3.0.1. See package change log for full details.
Package Manager: Fixed an issue on startup where assets in immutable packages could be incorrectly logged as having been modified. (1279382, 1287305)
Package Manager: Fixed an issue when a user switches an account and the package list refresh the new assets, a null ref exception occured.
Package Manager: Fixed the issue where TextFields added to Package Manager window as extensions being set to readonly by default. (1285806)
Package Manager: Recommend update to latest version for packages that is not part of the Unity registry and packages that are in preview.
Particles: Fixed inspector switching from multi edit mode to single edit whilst making changes. (1282252)
Physics: Added a missing property tooltips for Physics 2D project setting properties of "Gizmos" and "Layer Collision Matrix". (1276423)
Physics: Ensure that changing a Rigidbody2D constraint on a prefab instance results in the change being indicated by a bold label in the inspector. (1265836)
Physics: Ensure that changing the Rigidbody2D mass distribution correctly adjusts the center of mass velocity. (1272075)
Physics: Ensure the 2D per-frame SimulationMode2D correctly runs the simulation after the Update script callback and not before it to match FixedUpdate script callback. (1274820)
Physics: Fixed an issue when filtering out bad 2D physics collision shapes produced by the internal shape tessellator where occasionally a good shape is filtered out. (1274172)
Physics: Fixed an issue where OnCollision events wer not happening when the listening script was added to a GameObject after the ArticulationBody component. (1258247)
Physics: Fixed an occasional crash when destroying a PhysicsScene2D while destroying active contacts or collider-ignore-collision settings. (1268659)
Playables: Fixed crash in playable graphs when multiple notification receivers callbacks exist and change the source playable graph in a destructive manner (1290690)
Prefabs: Fixed a distorted UI for Prefab override comparison window when a changed component is selected. (1069062)
Prefabs: Fixed a regression preventing both required component and the dependent from both being removed from a prefab instance. (1277654)
Prefabs: Fixed collection of direct dependencies on Prefabs (1178737)
Prefabs: Fixed lost reference issues when applying added GameObject from context menu. (1237942)
Prefabs: Improved error handling when loading broken prefab files (1278298)
Profiler: Fixed a situation when Profiler remains active even with Profiler window closed in play mode. (1249581)
Profiler: Fixed an issue where Hierarchy Views randomly collapsed (i.e. hiding their children) parts of the sample tree when Editor Only samples were present in a frame and the "Collapse EditorOnly Samples" option was turned on (default setting is on). (1297955)
Profiler: Fixed an issue where the Profiler connection dropdown was not showing multiple players running on the same machine. (1271502)
Profiler: Fixed CPU Module Detailed view sorting when search field is active (1214785)
Profiler: Fixed visualization of a selected frame which is no longer available in Profiler hierarchy view to unify hierarchy and timeline view behavior. (1242627)
Scene Manager: Allow scenes to be saved to packages from the save panel. (1276187)
Scripting: Added an option to disable Signed Assembly version validation. (1193928)
Scripting: DEVELOPMENT_BUILD is included in Assembly define list when EditorUserBuildSettings.development is set to true (1294142)
Scripting: Fix minor documentation issue in Player Settings for Get/SetAdditionalCompilerArgumentsForGroup.
Scripting: Fixed a compilation problem when using Reference assemblies and an assembly has compiler errors, some dependent assemblies might not get recompiled
Scripting: Fixed a StackOverflow isue when building player in certain cases. (1288883)
Scripting: Fixed crash during Domain Reloads after modifying scripts. (1262671)
Serialization: Ensure that SerializedProperty.DataEquals works consistently even on fields prior to an alignment boundary. (1294238)
Serialization: Fixed crash in player due to corruption in GlobalGameManager caused by usage of UIToolkit package under specific scenario. (1296253)
Shaders: Exposed Render Queue control on the Standard shader (1287934)
Shaders: Fixed allocator errors due to orphaned memory when canceling a build during shader compilation. (1224325)
Shaders: Fixed an Editor failurs due to shader compiler communication issues when using some VPN solutions. (1025558)
Shaders: Fixed bad GLSL code generation on some cases accessing loop inductor inside the loop. (1267920)
Shaders: Fixed missing shader warnings when getting the shader variant from cache server. (1283021)
Shaders: Fixed missing shared compiler warnings when targeting GL/Vulkan/Metal/Switch. (1281243)
SpeedTree: Fixed an issuw where the button would not appear in Mesh Renderer and LOD Group component inspector if Unity detected wrong SpeedTree shader is used (for instance Nature/SpeedTree8 shader is used for meshes that come from SpeedTree 7 assets, and vice versa), and will correct them if clicked. (1237736)
UI: Add option to not activate the inputfield on selection. Helpful for controller based platforms where navigating to items is required to navigate UI. (1268708)
UI: Fallback to non SRP when rendering uGUI's profiler rerender even if SRP is in use. (1275870)
UI: Fixed an issue where OnDrop callback was not being called when using a TouchScreen. (1279352)
UI: Fixed an issue where the tiling and offset were no longer applied at the material level. (1287864)
Universal Windows Platform: Fixed a rare crash within TouchScreenKeyboard caused by a race condition (1286442)
Universal Windows Platform: Fixed Backspace and Selection not working properly on Xbox and HoloLens (1288229)
Universal Windows Platform: Fixed old TouchScreenKeyboard and XAML forms from being used in XAML HoloLens apps (1256386)
Universal Windows Platform: Fixed TouchScreenKeyboard immediately hiding on Xbox One when focusing an InputField (1287100)
Version Control: Fixed a crash on initial script recompilation when script tried to checkout assets (1275692)
Video: [macOS][iOS][tvOS] Fixed a Video Player lags issue when Playback Speed is changed. (1168597)
Virtual Texturing: Fixed a crash that occured during tile extraction of invalid virtual texture stacks.
WebGL: Fixed a bug where calling unityInstance.Quit() from JavaScript would not let JS VM garbage collect away the Unity game instance. (1188667)
WebGL: Fixed a memory error crash when using the "Convert To Entity" component. (1254779)
Windows: Fixed an issue where the full Windows 10 version including edition, build (with UTR) Version, and architecture was not logged when running the editor for diagnosis. (1251004)
XR: Updated the com.unity.xr.legacyinputhelpers to 2.1.7 package. Fixes automation compilation error when URP and HDRP are in the same project and fix for isolation compilation. (1297184)
API Changes
- Build Pipeline: Added: ContentBuildInterface.CalculatePlayerSerializationHashForType for providing precise per type dependency tracking for incremental rebuild of asset bundles.
Changes
Asset Import: When Meshes have no material defined in the imported file, the ModelImporter will now assign the default material to them rather than creating a 'No name' material sub-asset.
Burst: Preserve the frame pointer when debugging is enabled to aid debugging.
Package Manager: com.unity.purchasing updated to 2.2.1, adding full support for the implementation of GooglePlay Billing Library v3 library in the Asset Store In-App Purchasing module (includes an essential runtime hotfix over 2.2.0).
Timeline: Updated Timeline package to version 1.4.5
UI: Changed the Shader property for soft masking from _MaskSoftnessX / Y to _UIMaskSoftnessX / Y so we dont overlap with TMP's shader properties.
Improvements
Graphics: Improved handling of VirtualTexturing enabled state outside of the player settings UI. (1264576)
WebGL: Added support for PVRTC and RG16 textures. Enable use of high-performance WebGL GPU powerPreference. (1187965)
System Requirements
For development
OS: Windows 7 SP1+, 8, 10, 64-bit versions only; macOS 10.12+. (Server versions of Windows & OS X are not tested.)
CPU: SSE2 instruction set support.
GPU: Graphics card with DX10 (shader model 4.0) capabilities.
The rest mostly depends on the complexity of your projects.
Additional platform development requirements:
iOS: Mac computer running minimum macOS 10.12.6 and Xcode 9.0 or higher.
Android: Android SDK and Java Development Kit (JDK); IL2CPP scripting backend requires Android NDK.
Universal Windows Platform: Windows 10 (64-bit), Visual Studio 2015 with C++ Tools component or later and Windows 10 SDK
For running Unity games
Generally content developed with Unity can run pretty much everywhere. How well it runs is dependent on the complexity of your project. More detailed requirements:
Desktop:
- OS: Windows 7 SP1+, macOS 10.12+, Ubuntu 16.04+
- Graphics card with DX10 (shader model 4.0) capabilities.
- CPU: SSE2 instruction set support.
iOS player requires iOS 10.0 or higher.
Android: OS 4.4 or later; ARMv7 CPU with NEON support; OpenGL ES 2.0 or later.
WebGL: Any recent desktop version of Firefox, Chrome, Edge or Safari.
Universal Windows Platform: Windows 10 and a graphics card with DX10 (shader model 4.0) capabilities
Exported Android Gradle projects require Android Studio 3.4 and later to build
LTS Release 2019.4.18f1
LTS Release 2019.4.18f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2019.4.18f1
Asset Import Pipeline: Prefabs are reimporting every time a code change is made (1294785)
Serialization: Crash on WalkTypeTreeComplete<
SerializedProperty::ContainsManagedReferences'::2'::IsManagedReferenceVisitor> (1302360)Shadows/Lights: Skybox lighting is not rendered after creating gameobjects in the new scene until the lighting is rebaked (1250293)
Audio: [editor][fmod][macOS] Editor is preventing Mac OS from entering sleep mode automatically (995866)
Global Illumination: [URP] Transparencies are ignored because URP uses _BaseMap as main texture identifier (1246262)
Graphics Device Backends: [Mac] Editor crashes on MTLGetEnvCase on startup when metalEditorSupport is set to 0 in the ProjectSettings (1298617)
Profiling: Once paused, the Profiler does not resume recording when profiling WebGL player (1271012)
Shader System: Freeze or crash with various stack traces when opening a project while connected to a VPN service (1025558)
Linux: InputSystem's Mouse delta values do not change when the Cursor lockState is set to Locked (1248389)
Global Illumination: [macOS] BugReporter doesn't get invoked when the project crashes (1219458)
Global Illumination: gi::InitializeManagers() takes 0.6s during Editor startup (1162775)
iOS: [iOS 14] VideoPlayer crashes on EXC_BAD_ACCESS or signal SIGABRT when audioOutputMode is set to APIOnly or Audio Source (1274837)
Asset Import Pipeline: Parent and child nested Scriptable Object Assets switch places when parent Scriptable Object Asset is renamed (1189089)
iOS: Crash on il2cpp::vm::LivenessState::AddProcessObject when using Social.LoadUsers and then changing scenes (1270230)
XR: [XR SDK][Oculus] EarlyUpdate.XRUpdate spikes inconsistently (1262597)
Packman: Package Manager doesn't show available updates (1304459)
WebGL: [Audio] "Cannot create FMOD" Error when importing 3D Game Kit project on webGL (1293595)
2019.4.18f1 Release Notes
Fixes
2D: Reduce memory used for Automatic Slicing of Sprites. (1263213)
Android: Disable Optimized Frame Pacing on Android 4.4-5.1 to fix crash/freeze (1268910)
Asset Import: Ensure 3DS Importer handles NaN vertices. (1268563)
Asset Import: Fixed issue with OnAssignMaterialModel next methods not called even when the first one returns a null object. (1280978)
Build Pipeline: SerializeReference instance types are now preserved when setting Player.Optimization.Managed Stripping Level to Medium or High. (1232785)
Build Pipeline: StreamingAssets AssetBundle manifest is now provided by default to PlayerBuild, which will result in types being referred by AssetBundle being kept in the build even if Player.Optimization.Managed Stripping Level is set to Medium or High.
Editor: Fixed "Run in background" option causing a dramatic increase in CPU usage. (1275832)
Editor: Fixed an issue where 'Failed to destroy editor window' warning message appears on the console when the project is migrated from 2019.4 to 2020.1(or higher)
Editor: Fixed cannot load editor layout, stuck in infinite loop of "failed to load window layout". (1275270)
GI: Fixed crash in Enlighten::CpuUpdateManager::UpdateGpuTexture when starting GI bake after baking previous scene with GPU progressive lightmapper. (1250819)
GI: Fixed debug Editor failing in CheckAutoLDA.AssertLightprobesInAutoLDA. (1216793)
Graphics: - When allocating textures that go over the limit of Unity 2019.4 we display an error message instead of crash. (1267258)
Graphics: Editor text on Mac OSX will no longer randomly become corrupted. (1267885)
Graphics: Fixed Texture2DArray, CubemapArray and SparseTexture being not supported in batch mode (1291999)
Graphics: Update SRP packages to 7.5.2
Graphics: [SRP] Shadows could flicker when more than one Spot Light is set on multi-thread machine (1190147)
IL2CPP: Fix file and directory patterns ending with ".*" incorrectly including files names that partially match on non Windows platforms. (1286554)
macOS: Fixed Apple silicon DTK freezing when running Unity. (1292999)
Mobile: Fix InputField errors when selecting text with Hide Mobile Input enabled. (1247399)
Particles: Fixed assertion failure caused by active ParticleSystems. (1272220)
Prefabs: Fix lost references when applying added GameObject from context menu. (1237942)
Profiler: Fixed Hierarchy Views randomly collapsing (i.e. hiding their children) parts of the sample tree when Editor Only samples are present in a frame and the "Collapse EditorOnly Samples" option is turned on (default setting is on). (1297955)
Profiler: Fixed Profiler connection dropdown not showing multiple players running on the same machine (1271502)
Scripting: Fix crash that may occur when using stackalloc. (1172987)
Terrain: Paint Tools which are overriden forward shortcut selection to the tool that is overriding them. (1251645)
UI: Fixed issue where the tiling and offset were no longer applied at the material level (1287864)
Video: [macOS][iOS][tvOS] Video Player lags when Playback Speed is changed (1168597)
Video: [osx] crash when playing a video at speed > 2x. (1240116)
Video: [Test][Video][Android]VideoTrack tests broken (1203336)
Web: UnityWebRequest: fix possible data corruption in UploadHandlerFile (1238418)
Windows: Fixes crashed in PhraseRecognizer when mic disconnected (1268538)
XR: updates com.unity.xr.legacyinputhelpers to 2.1.7
fixes automation compilation error when URP and HDRP are in the same project.
fix for isolated compilation (1297184)
Changes
UI: Changed the Shader property for soft masking from _MaskSoftnessX / Y to _UIMaskSoftnessX / Y so we dont overlap with TMP's shader properties.
XR: Updated Windows XR SDK Plug-in to 2.5.2
XR: Updated XR Plug-in Management to 3.2.17
System Requirements
For development
OS: Windows 7 SP1+, 8, 10, 64-bit versions only; macOS 10.12+. (Server versions of Windows & OS X are not tested.)
CPU: SSE2 instruction set support.
GPU: Graphics card with DX10 (shader model 4.0) capabilities.
The rest mostly depends on the complexity of your projects.
Additional platform development requirements:
iOS: Mac computer running minimum macOS 10.12.6 and Xcode 9.4 or higher.
Android: Android SDK and Java Development Kit (JDK); IL2CPP scripting backend requires Android NDK.
Universal Windows Platform: Windows 10 (64-bit), Visual Studio 2015 with C++ Tools component or later and Windows 10 SDK
For running Unity games
Generally content developed with Unity can run pretty much everywhere. How well it runs is dependent on the complexity of your project. More detailed requirements:
Desktop:
- OS: Windows 7 SP1+, macOS 10.12+, Ubuntu 16.04+
- Graphics card with DX10 (shader model 4.0) capabilities.
- CPU: SSE2 instruction set support.
iOS player requires iOS 10.0 or higher.
Android: OS 4.4 or later; ARMv7 CPU with NEON support; OpenGL ES 2.0 or later.
WebGL: Any recent desktop version of Firefox, Chrome, Edge or Safari.
Universal Windows Platform: Windows 10 and a graphics card with DX10 (shader model 4.0) capabilities
Exported Android Gradle projects require Android Studio 3.4 and later to build
LTS Release 2020.2.1f1
LTS Release 2020.2.1f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2020.2.1f1
Asset Import Pipeline: Prefabs are reimporting every time a code change is made (1294785)
Asset Importers: [Performance Regression] Importing an fbx model is noticeably slower when the model contains Animations (1265275)
Audio: [editor][fmod][macOS] Editor is preventing Mac OS from entering sleep mode automatically (995866)
Build Pipeline: [Cache Server] Building process freezes on compiling shader variants when connected to Accelerator (1296800)
Cloth: Skinned Mesh Renderer's Bounds Extent is set to half of the Transform's Scale when using a Cloth Component (1209765)
Global Illumination: [macOS] BugReporter doesn't get invoked when the project crashes (1219458)
Installer: WindowsInstallerSet builder calculates compressed install sizes (1297868)
Linux: InputSystem's Mouse delta values do not change when the Cursor lockState is set to Locked (1248389)
Linux: Linux Editor tooltip shows up in the window switcher as a separate window (1287440)
Packman: Package Manager doesn't start anymore on Windows 7 (1298330)
Physics: A hard stack overflow happens when raycasting vs a dense mesh in BV4_ProcessStreamKajiyaOrderedQ (1297721)
Profiling: Once paused, the Profiler does not resume recording when profiling WebGL player (1271012)
Profiling: [Profiler] Hierarchy randomly hides parts of the sample hierarchy if Editor Only Samples are present and set to be Collapsed (1297955)
Project Browser: Icon size slider is missing in Project Browser in One Column Layout (1295227)
Scene Management: Crash on EditorUserSettings::UpdateRecentSceneConfigValues when opening multiple Scenes several times one by one through Script (1294937)
Shader System: Freeze or crash with various stack traces when opening a project while connected to a VPN service (1025558)
Shadows/Lights: Skybox lighting is not rendered after creating gameobjects in the new scene until the lighting is rebaked (1250293)
Terrain: Normals don't appear around terrain holes (1301214)
Terrain: Paint Holes Undo Action will corrupt Terrain Objects (1299939)
WebGL: [Linux] WebGL build always fails and throws a FileNotFoundException (1268262)
XR: [XR SDK][Oculus] EarlyUpdate.XRUpdate spikes inconsistently (1262597)
2020.2.1f1 Release Notes
System Requirements Changes
Fixes
Documentation: Fixed an issue with the editor documentation redirect links. (1300346)
Editor: Fixed an issue where the Asset Store tools were no longer working. (1299815)
WebGL: Fixed an audio clip autoplay regression in WebGL builds. (1276713)
System Requirements
For development
OS: Windows 7 SP1+, 8, 10, 64-bit versions only; macOS 10.12+. (Server versions of Windows & OS X are not tested.)
CPU: SSE2 instruction set support.
GPU: Graphics card with DX10 (shader model 4.0) capabilities.
The rest mostly depends on the complexity of your projects.
Additional platform development requirements:
iOS: Mac computer running minimum macOS 10.12.6 and Xcode 9.0 or higher.
Android: Android SDK and Java Development Kit (JDK); IL2CPP scripting backend requires Android NDK.
Universal Windows Platform: Windows 10 (64-bit), Visual Studio 2015 with C++ Tools component or later and Windows 10 SDK
For running Unity games
Generally content developed with Unity can run pretty much everywhere. How well it runs is dependent on the complexity of your project. More detailed requirements:
Desktop:
- OS: Windows 7 SP1+, macOS 10.12+, Ubuntu 16.04+
- Graphics card with DX10 (shader model 4.0) capabilities.
- CPU: SSE2 instruction set support.
iOS player requires iOS 10.0 or higher.
Android: OS 4.4 or later; ARMv7 CPU with NEON support; OpenGL ES 2.0 or later.
WebGL: Any recent desktop version of Firefox, Chrome, Edge or Safari.
Universal Windows Platform: Windows 10 and a graphics card with DX10 (shader model 4.0) capabilities
Exported Android Gradle projects require Android Studio 3.4 and later to build
LTS Release 2019.4.17f1
LTS Release 2019.4.17f1
Windows (X86-64)
Component Installers
macOS (X86-64)
Release Notes
Known Issues in 2019.4.17f1
Asset Import Pipeline: Parent and child nested Scriptable Object Assets switch places when parent Scriptable Object Asset is renamed (1189089)
Asset Import Pipeline: Prefabs are reimporting every time a code change is made (1294785)
Global Illumination: [URP] Transparencies are ignored because URP uses _BaseMap as main texture identifier (1246262)
Global Illumination: [macOS] BugReporter doesn't get invoked when the project crashes (1219458)
Global Illumination: gi::InitializeManagers() takes 0.6s during Editor startup (1162775)
IL2CPP: UnityLinker strips classes used with the SerializeReference attribute (1232785)
Linux: InputSystem's Mouse delta values do not change when the Cursor lockState is set to Locked (1248389)
Profiling: Once paused, the Profiler does not resume recording when profiling WebGL player (1271012)
Profiling: [Profiler] Hierarchy randomly hides parts of the sample hierarchy if Editor Only Samples are present and set to be Collapsed (1297955)
Shader System: Freeze or crash with various stack traces when opening a project while connected to a VPN service (1025558)
Shadows/Lights: Skybox lighting is not rendered after creating gameobjects in the new scene until the lighting is rebaked (1250293)
WebGL: [Audio] "Cannot create FMOD" Error when importing 3D Game Kit project on webGL (1293595)
XR: [XR SDK][Oculus] EarlyUpdate.XRUpdate spikes inconsistently (1262597)
iOS: Crash on il2cpp::vm::LivenessState::AddProcessObject when using Social.LoadUsers and then changing scenes (1270230)
iOS: [UaaL] UnityFramework with 3rd party plugins triggers watchdog termination after launch (1262272)
iOS: [iOS 14] VideoPlayer crashes on EXC_BAD_ACCESS or signal SIGABRT when audioOutputMode is set to APIOnly or Audio Source (1274837)
2019.4.17f1 Release Notes
Fixes
2D: Added missing tooltips in the Sprite Skin inspector (1285255)
2D: Added missing UIElement dependency for 2d common package
2D: Fixed 2D Animation Package doesn't reflect its dependency to the com.unity.modules.animation package
2D: Fixed vertical slider handle is not aligned and placed slightly to the right side in the Bone Influence wind (1260568)
Android: Export gradle project failing when using custom base build.gradle only the first time. (1245249)
Android: Fix bug where draws after indirect draw result in corrupt geometry on Adreno (1271258)
Android: Fixed issue when Unity Remote system is unable to connect to Android devices due to incorrect adb executable file path. (1251622)
Android: When running external tools, print error messages as two items in Editor console instead of item per line. (1269685)
Animation: Fixed a Playmode crash in the Editor that happens after modifying scripts while animating certain UI Components using the Animation Component. (1238859)
Asset Import: Import Fixed issue with ModelImporter not using rotation pivots as centers during pivot conversion when resampleCurves is disabled. (1283884)
Audio: Fixed audio in timeline preview not pausing/resuming when changing focus between the editor and other applications. (1016423)
Core: Fixes crash when IME Strings got too long. (1226610)
Editor: Fixed an issue that would result in the Unity Editor Update Check window opened in an incorrect state followed by the Editor crashing. (1285668)
Editor: Fixed an issue where clicking the right edge of textures icon in material inspector would open a asset selection window. (1248553)
Editor: Fixed exception when deleting folder in Favorite (1229937)
Editor: Reverted fontRenderingMode from FontRenderingMode.Smooth back to FontRenderingMode.OSDefault (1262281)
Editor: The Linux editor main window now correctly remembers saved window layout (1258663)
GI: Make GPU lightmapper work on Apple Silicon
GI: Prevent user from assigning realtimeTexture to a customProbe, and show a warning if he tries. (1243849)
Graphics: Correct priority for the vfx assets (1284439)
Graphics: CPU optimisation for graphics memory allocation/deallocations.
Graphics: Fix missing type check from VFX component sheet, error possible if (1258022)
Graphics: Fix targetTexture rendering black screen when changing it in OnPreRender(). (1274376)
Graphics: Fixed corruption that can occur in font characters texture on some iOS 14 devices when using RequestCharactersInTexture. (1290509)
Graphics: Fixed frame debugger not showing correct keywords when stage-specific shader features are used (1261620)
Graphics: Fixed GLES device leaking texture IDs in some circumstances (1261513)
Graphics: Fixed issue where speedtree textures were becoming unbound after clicking "Regenerate materials". (1231184)
Graphics: Player crashes with Size overflow in allocator from AllocAndFillInstancedData (hybrid v1) (1289613)
Graphics: terrain tree imposters transparency fix on GLES (1287879)
Graphics: Texture2D arrays will no longer crash when using the metal renderer if the color format is invalid.
Graphics: Tree billboards now rotate correctly while the camera is moving on mobile platforms (1242389)
Graphics: [VFX] SRP Batcher issues with VFX Shadow-casters (1296980)
IL2CPP: Fix a case where an interface could be incorrectly removed from a type when no .ctor for that type was marked. (1222808)
Linux: Fixed game controller and joystick serial numbers (1269974)
Mobile: Fix iOS 11+ motion API feature access generating warnings on iOS 10 builds
Package: Clean up bundled burst packages to reduce installer size
Package: Debug information for instance methods is now correctly scoped. This means instance variables can now be inspected correctly.
Package: Fixed a bug in LLVM that it would incorrectly convert some memset -> memcpy if both pointers derived from the same memory address, and where one indexed into the 0th element of the pointer.
Package: Fixed a bug whereby if you had an assembly that was guarded by UNITY_SERVER, Burst would be unable to find the assembly when Server Build was ticked.
Package: Fixed a failure on linux builds where libdl.so cannot be found.
Package: Fixed alignment issues associated with xxHash3 on ArmV7 (case 1288992)
Package: Fixed issues with Intel intrinsics mm256_inserti128_si256, mm256_bslli_epi128, mm256_bsrli_epi128
Package: Fixed managed (reference) implementation of mm256_cvttps_epi32 (case 1288563)
Package: Fixed managed implementation of sub_ss intrinsic
Package: Made
math.shufflecompile correctly when non-constantShuffleComponent's are used.Package: When "Enable Compilation" was unchecked in the Burst menu, Burst was incorrectly enabled after an Editor restart. This is now actually fixed.
Package Manager: Fixed the issue where PackageList have null ref errors when domain reload happens during Asset Store list request
Package Manager: Packages installed as a dependency are now listed in the 'In Project' tab of Package Manager Window.
Particles: Limit the rendering cache size to avoid using lots of memory when using multiple cameras. (1270438)
Playables: Fixed crash in playable graphs when multiple notification receivers callbacks exist and change the source playable graph in a destructive manner (1290690)
Profiler: Fix CPU Module Detailed view sorting when search field is active (1214785)
Profiler: Fixed a situation when Profiler remains active even with Profiler window closed in play mode. (1249581)
Profiler: Fixed visualization of a selected frame which is no longer available in Profiler hierarchy view to unify hierarchy and timeline view behavior (1242627)
Scripting: : Fixed crash during Domain Reloads after modifying scripts. (1262671)
Scripting: DEVELOPMENT_BUILD is included in Assembly define list when EditorUserBuildSettings.development is set to true (1294142)
Scripting: Fix generic mono array overwrite in bindings code. (1268308)
Serialization: Ensure that SerializedProperty.DataEquals works consistently even on fields prior to an alignment boundary. (1294238)
Serialization: SerializeReference reuse polymorphic instances when changing specific values in the inspector. (1193322)
Shaders: Fixed allocator errors due to orphaned memory when canceling a build during shader compilation. (1224325)
Shaders: Fixed incorrect shader code generated for Vulkan in some cases when tessellation is used (1256838)
Shaders: Fixed out of bounds access to static const arrays in generated GLSL code. (1276781)
Terrain: Undoing after removing terrain layer correctly restores alphamaps. (1276283)
UI: Fallback to non SRP when rendering uGUI's profiler rerender even if SRP is in use. (1275870)
UI: OnDrop callback not being called when using a TouchScreen (1279352)
WebGL: Added support for PVRTC and RG16 textures. Enable use of high-performance WebGL GPU powerPreference. (1187965)
WebGL: Fixed a bug with compressed single channel textures attempting to target unsupported BC4 compression format. (1274662)
XR: Fixed issue where attempting to launch a VR application when default rotation mode was set to autorotate would fail an assertion. (1275158)
API Changes
- Editor: Added: Added EditorUtility.IsRunningUnderCPUEmulation to detect whether Unity is running under CPU emulation.
Changes
Package: Improved our hashing performance some more by re-using fixed-sized buffers in the compiler to improve eager-compilation / warm-cache costs by 1.25x.
Package: Improved the performance of in-compiler hashing by 1.2x.
Package: Preserve the frame pointer when debugging is enabled to aid debugging.
Package Manager: com.unity.purchasing updated to 2.2.1, adding full support for the implementation of GooglePlay Billing Library v3 library in the Asset Store In-App Purchasing module (includes an essential runtime hotfix over 2.2.0).
Shaders: Editor now skips warming up shaders from shader collections in the Preloaded shaders section of Graphics settings
Improvements
- Mobile: com.unity.mobile.notifications updated to 1.3.2
System Requirements
For development
OS: Windows 7 SP1+, 8, 10, 64-bit versions only; macOS 10.12+. (Server versions of Windows & OS X are not tested.)
CPU: SSE2 instruction set support.
GPU: Graphics card with DX10 (shader model 4.0) capabilities.
The rest mostly depends on the complexity of your projects.
Additional platform development requirements:
iOS: Mac computer running minimum macOS 10.12.6 and Xcode 9.4 or higher.
Android: Android SDK and Java Development Kit (JDK); IL2CPP scripting backend requires Android NDK.
Universal Windows Platform: Windows 10 (64-bit), Visual Studio 2015 with C++ Tools component or later and Windows 10 SDK
For running Unity games
Generally content developed with Unity can run pretty much everywhere. How well it runs is dependent on the complexity of your project. More detailed requirements:
Desktop:
- OS: Windows 7 SP1+, macOS 10.12+, Ubuntu 16.04+
- Graphics card with DX10 (shader model 4.0) capabilities.
- CPU: SSE2 instruction set support.
iOS player requires iOS 10.0 or higher.
Android: OS 4.4 or later; ARMv7 CPU with NEON support; OpenGL ES 2.0 or later.
WebGL: Any recent desktop version of Firefox, Chrome, Edge or Safari.
Universal Windows Platform: Windows 10 and a graphics card with DX10 (shader model 4.0) capabilities
Exported Android Gradle projects require Android Studio 3.4 and later to build
News from Unity QA
We’re not just toolsmiths, but wordsmiths too! Read all the Unity QA blogposts past and present.