Unity 2021.2.2

Select the runtime platforms of your choice from the list below (the desktop runtime is included as standard) or, to install the full complement of runtime platforms, use the download assistant installer above.
New to Unity? Get started

Known Issues in 2021.2.2f1

  • Android: Sometimes text is not rendered when using OpengLES3 on a Xiaomi Redmi9A device. (1347186)

  • Android: * Devices might wake up from sleep when in split screen mode.

    • Chrome OS devices that support tablet mode might not pause apps when they are no longer visible.

    • Some Android devices may experience delayed resolution updates after resizing a window.

    • Minimum window size might not be respected properly on all Android devices.

  • Asset Bundles: Building process of the AssetBundles is slow when there is a huge filecount. (1358059)

  • Asset Import Pipeline: Crash on OnDemandScheduler::SetStandbyWorkerCount when opening a project with a symbolic link in it (1370389)

  • CodeEditors: Crash on stopping debugging (1355156)

  • Global Illumination: Crash while sculpting Terrain and Baking Lightmaps (1266511)

  • Global Illumination: Scene is brighter in Standalone player if it was open in the Editor at build time (1375015)

  • Global Illumination: [GPU PLM] Crash in (nvopencl64) clGetPlatformInfo after enabling Auto Generate checkbox at the end of GI Bake (1379762)

  • Global Illumination: [GPU PLM] Fallback to CPU PLM in CL_INVALID_MEM_OBJECT after switching light color only and rebaking GI (1356714)

  • HD RP: HDRP Template fills the Console with "Shader error...couldn't open include file" messages after building the project (1342989)

  • IL2CPP: System.Runtime.Serialization.Formatters.BinaryFormatter doesn't work when Project is build with IL2CPP Scripting Backend (1374185)

  • Input: Touch Input doesn't work in Play Mode when running an Editor on a Touchscreen device (1341159)

  • Input: [macOS] Text input lags by one keystroke when inputting text in the Editor (1376732)

  • Linux: Linux Editor crashes at "__assert_fail_base.cold" when opening a project (1375312)

  • MacOS: [Mac] Performance regression in Editor UI (1376273)

  • Mono: Microsoft.Extensions.Logging Nuget Package causes errors in console when built into UWP with .NET Standard 2.1 (1373389)

  • Scene Management: Instantiated FBX through code throws error after leaving Play Mode (1363573)

  • Scene/Game View: Tool handles are invisible in Scene View when certain objects are selected (1374532)

  • Scripting: Crash in CombineMeshFiltersForStaticBatching after switching active additively loaded scenes and entering Play mode (1377416)

  • Scripting: Error CS8035 is thrown on opening a project when using rulesets (1349517)

  • Scripting: Only some assemblies fail to be loaded when assembly name does not match the file name (1345099)

  • Templates: Editor crashes when exiting and keeping a tutorial project (1338299)

  • uGUI: UI handles in scene view are detached from UI elements (1376302)

  • Vulkan: [Editor] The Scene's GameObjects textures are seemingly random and change colours depending on the Scene's Camera pos. (1337772)

  • Window Management: Broken layout stops panels located in the top left corner of the Editor from rendering in the Karting Microgame project (1367783)

  • XR SDK: Severe flickering in Unity 2020.3.21f1 with OpenXR on HL2 (1376203)

  • XR SDK: [XR][Linux] Scene View doesn't render when opening new AR or VR Template project or pressing "Show Tutorials" (1362435)

2021.2.2f1 Release Notes


  • Physics: Change "Collider2D.GetShapeHash()" so that it calculates the hash incrementally rather than when entirely when it is called. This results in the time take being constant rather than scaling as the number of physics shapes increases.

  • Visual Scripting: Eliminating domain reload cost for users when not using Visual Scripting

API Changes

  • Apple TV: Added: Added identifier for 2nd generation Apple TV 4K.

  • Apple TV: Changed: Changed identifiers for Apple TV HD and first generation Apple TV 4K.

  • Editor: Added: EditorStyles.iconButton is now public so custom editor windows can implement help, settings and other icon buttons

  • iOS: Added: Added identifiers for all iPhone 13 models, 6th generation iPad Minis, 9th generation iPads.

  • Shaders: Added: It is now possible to query tags on each subshader and pass (1363534)

  • URP: Added: URP global setting for stripping off shader variants.

  • URP: Added: URP global setting for stripping post processing shader variants.


  • HDRP: Changed the max distance for Light Anchors to avoid unstability with high values. (1362802)

  • HDRP: In path tracing, camera ray misses now return a null value with Minimum Depth > 1.

  • Package: com.unity.purchasing has been updated to 4.1.0.

  • URP: Main light shadow, additional light shadow and additional light keywords are now enabled based on urp setting instead of existence in scene. This allows better variant stripping.


  • 2D: Fixed a case where quads generated in the Skinning Editor would be created with the wrong size and position. (1361053)

  • 2D: Fixed an issue where an error would show up when destroying a Sprite Skin component while deep profling. (1364910)

  • 2D: Fixed an issue where copying mesh and bone data from a .psb containing a single sprite would throw an exception. (1351543)

  • 2D: Fixed an issue where IK Solvers would not be updated when previewing an animation clip. (1354389)

  • 2D: Fixed artifacts on images when flatten for PSDImporter.

  • 2D: Fixed case where colliders do not extend to the end of the sprite texture when Sprite Borders are enabled. (1348701)

  • 2D: Fixed case where Edge and Polygon colliders have missing edges on certain open-ended shapes. (1362440)

  • 2D: Fixed case where enabling Fill Tessellation and setting profile's fill offset to positive causes errors. (1363215)

  • 2D: Fixed case where Sprite Shapes appear only when their pivot is revealed in the Scene view. (1356204)

  • 2D: Fixed exception "PsdInvalidException: Unrecognized layer section type" when importing certain files.

  • 2D: Fixed render texture size error in the Skinning Editor. (1357552)

  • 2D: Removed memory requirement check since we cannot properly determine if there will be enough memory to import the file in PSDImporter. (1338690)

  • 2D: [RuleTile] Fixed error in RuleTileEditor when removing all Rules and adding a new Rule

  • AI: Fixed crash caused by the Navigation system on editor shutdown (1367374)

  • Android: Asset packs located in Packages should be properly supported (1370382)

  • Android: Fixed bug where Display.systemWidth, Display.systemHeight and Screen.resolutions[] is not updated when folding/unfolding a Galaxy Fold device (1345508)

  • Android: Fixed crash when using Application.Quit with Optimized Frame Pacing. (1341467)

  • Animation: Fixed a potential crash when generating asset previews, if destructive methods are called in user callbacks. (1343886)

  • Asset Bundles: Fixed crash when reloading an AssetBundle after recompiling scripts in playmode. (1333402)

  • Asset Import: Configure button now immediately enabled when switching Animation type to Humanoid. (1197249)

  • Editor: Backported fix for a bug which prevented the access token to be refreshed after it expired. This issue required the user to close and reopen the editor every time the access token expired to get it refreshed.

  • Editor: Drag-and-drop in Editor windows no longer raises errors about unfreed allocations (1367401)

  • Editor: Fixed a crash on Apple silicon devices when using crunch compression (1344991)

  • Editor: Fixed erroneous "Unfreed allocations" error messages in the console. (1346970)

  • Editor: Fixed launching a Linux standalone player whose folder is in $PATH (1339398)

  • Editor: Fixed Mask Field not being wide enough for long layer names. (1366623)

  • Editor: Fixed number fields not reverting to zero after becoming empty. (1349798)

  • Editor: Fixed warning when instantiating a read-only scene template with new dependencies. (1368721)

  • Editor: Inspector AnimationCurve field does not try to show both the context menu and the curve editor when right-clicked now. (1312594)

  • Editor: Recent Mac Metal editor change delayed frame updates by 1, affecting selection feedback - this is now fixed. (1374546)

  • Editor: Recent Mac Metal editor change delayed frame updates by 1, affecting undo/redo update time - this is now fixed. (1374538)

  • GI: Fixed crash when generating lighting which calls print function with incorrect parameters. (1368383)

  • Graphics: Descriptor sets were not validated properly under certain circumstances for Vulkan (1300203)

  • Graphics: Fixed alpha dilation filtering when a 16 bit-per-component texture with transparent pixels is imported. (1355265)

  • Graphics: Fixed incorrect NativeArray de-allocation error when using the results of Texture2D.GetPixelData in multiple jobs per frame. (1359263)

  • Graphics: Fixed incorrect texture settings for externally created textures (1358700)

  • Graphics: Fixed player error and memory leak when player window is hidden (1361670)

  • Graphics: Fixed read/write access on NativeArray after an AsyncGPUReadback request is fulfilled (1295472)

  • Graphics: Resolved an issue where AssetPreview.GetAssetPreview would sometimes return a texture in the incorrect color space when the project itself was set to Linear color space. (1364124)

  • HDRP: Fixed emissive value when switching between HDR and LDR mode.

  • HDRP: Fixed performance on PrepareLightsForGPU by burstifying light loop.

  • Input: Recent Mac Metal editor change delayed frame updates by 1, affecting keyboard input lag - this is now fixed. (1375664)

  • iOS: Added support for iPhones, iPads and Apple TV released in 2021. (1367775)

  • Package: Fixed a usability issue where in some cases searcher would suggest one collapsed category of results that user would have to manually expand anyway, now searcher auto-expands the single suggested category
    Fixed searcher bug that caused incorrect search results with non whitespaced queries for nodes with spaces in their name and for subgraphs [1375249]
    Fixed bug that causes search results to not be visible sometimes in the searcher window [1375251]
    Fixed bug that causes exceptions to be thrown when using the up/down arrow keys with search list focused [1375248]
    Fixed bug that causes some searcher items to be irreversibly collapsed due to expand icon disappearing on collapsing those items [1375250]

  • Package Manager: Dragging and dropping Assets in projects that reference the package that they are part of (i.e. most projects that are used to test packages within Unity) will now move the Assets instead of copying them. (1374942)

  • Particles: Fixed particle face-culling when rendering into Cubemaps. (1340494)

  • Particles: Fixed stuttering slow-motion preview when using Custom Data. (1365360)

  • Physics: Fixed an issue with edge selection when editing the PolygonCollider2D or EdgeCollider2D are large Transform scales. (1361571)

  • Prefabs: Fixed Prefab sorting issue that re-arranged order of prefabs due to AddedComponents not being handled properly (1252436)

  • Profiler: Custom Profiler counters using a custom category or a category of Audio or Video now display correctly in the chart view. (1365365)

  • Profiler: Prevented an ArgumentOutOfRangeException occurring in the Module Editor when enabling deep profiling after deleting a module. (1335309)

  • Scene/Game View: Backport for lightmap exposure field negative value fix. (1370679)

  • Scene/Game View: Fixed 2D toggle not correctly positioned when starting a new 2D project (URP) (1368728)

  • Scene/Game View: Fixing GridSize value when using a linked field (1369312)

  • Scene/Game View: Fixing Increment Snapping linked property not working (1351800)

  • Scripting: Fixed assembly corruption (by AssemblyUpdater) in some scenarios where types moved to a different assembly. (1369442)

  • Shadergraph: Fixed a bug that caused the Scene Depth Node in Eye space to not work correctly when using an orthographic camera. (1311272)

  • Shadergraph: Fixed missing shader keyword stage during keyword copying.

  • Shaders: Fixed an issue with Editor using some default data until a shader is imported or compiled. (1369645)

  • UI Toolkit: Exposed ProgressBar.lowValue and ProgressBar.highValue. (1357268)

  • UI Toolkit: Fixed minor instabilities in the layout that would cause text to wrap (1332695)

  • UI Toolkit: Fixed performance test issue for UI Toolkit renderer repaints. (1337832)

  • UI Toolkit: Fixed right-click menu not appearing on Foldout header for hierarchical PropertyFields. (1306190)

  • UI Toolkit: Fixed scissor clipping on hidden elements. (1340827)

  • UI Toolkit: Fixed setting cursor value in :hover selector does not update cursor (1351689)

  • UI Toolkit: Fixed the unstable ellipsis of text (1294350)

  • UI Toolkit: UXML factory types are now preserved automatically (1336612)

  • URP: Added "Conservative Enclosing Sphere" setting to fix shadow frustum culling issue where shadows are erroneously culled in corners of cascades (1153151)

  • URP: Fixed a regression bug where XR camera postion can not be modified in beginCameraRendering (1365000)

  • URP: Fixed an issue where screen space shadows has flickering with deferred mode (1354681)

  • URP: Fixed for rendering thumbnails. (1348209)

  • URP: Fixed ShaderGraph needing updated normals for ShadowCaster in URP.

  • VFX Graph: Compilation error while using not exposed texture in ShaderGraph (1367167)

  • Virtual Texturing: Fixed issue where VT-only textures were rendered as default color in the Player when VT was disabled (1280281)

  • Visual Scripting: AOT prebuild works properly when building a project in batchmode.

  • Visual Scripting: Fixed il2cpp crash caused by infinite recursion when generating AotStubs

  • Visual Scripting: Fixed jitter on fuzzy finder.

  • Visual Scripting: Fixed missing icons when the "Transition End Arrow" is on.

  • Visual Scripting: Fixed missing textures after switching platform.

  • Visual Scripting: Fixed variable duplication not working properly.

  • Visual Scripting: Fixed Welcome Screen not opening the proper graph.

  • Visual Scripting: Restoring the public icon set api.

  • WebGL: Fixed a regression that prevented users from building .jspre plugins in Release mode. (1369085)

  • WebGL: Fixed crash on Oculus Browser when the EXT_multisampled_render_to_texture extension is enabled. (1370782)

  • Windows: Removed error.log generation for crash uploads in favor of editor.log and dmp files. (1278602)

  • XR: Fixed all cameras stop rendering when VR headset is off.

  • XR: Updated XR Interaction Toolkit to 1.0.0-pre.6 and removed it from being a discoverable pre-release package since a 1.0.0 version will not be released in the 2021 Editor version.


Third Party Notices

For more information please see our Open Source Software Licenses FAQ on the Unity Support Portal

Ce site utilise des cookies dans le but de vous offrir la meilleure expérience possible. Consultez notre politique de cookies pour en savoir plus.