Unity 2021.1.17

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.1.17f1

  • Ads: [Android] Unity Ad return app to Lock screen (1281041)

  • Asset Import Pipeline: Editor crashes with out of memory while importing a lot of assets (mostly textures) at once, on Windows/DX11 (1324536)

  • Asset Importers: Editor crashes on UnityEditor.Unsupported:IsDestroyScriptableObject when applying changes to a custom asset (1353925)

  • Asset Importers: [MacOS] Second Unity instance in Activity Monitor is "not responding” after importing (1331736)

  • Audio: Crash on AudioCustomFilter::GetOrCreateDSP when recompiling scripts while in Play Mode (1354002)

  • Audio: Crash on AudioMixer_CUSTOM_FindSnapshot when passing null as an argument to FindSnapshot() (1341752)

  • Customer QA Onboarding: Unity does not execute code weavers when the project is opened for the first time (1350116)

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

  • Global Illumination: [Enlighten] Fatal Error when closing the Editor while Generating Lighting (1354238)

  • Global Illumination: [LightProbes] Probes lose their lighting data after entering Play mode when Baked and Realtime GI are enabled (1052045)

  • IMGUI: Editor's Toolbar is sometimes replaced by a white bar when opening any Scene (1341951)

  • Linux: Crash on DisableSubMenu when double clicking to close a context menu (1347655)

  • Linux: Linux Editor crashes at "_XFreeX11XCBStructure" when loading tutorials (1323204)

  • Metal: Performance in Game View is significantly impacted by Gfx.WaitForPresentOnGfxThread when a second monitor is connected (1327408)

  • Mobile: "UnityException: Unable to package apk Unity library missing for the selected architecture x86" error on android il2cpp builds (1355394)

  • Mobile: [Android] App stops due to OnPixelCopyFinishedListener not being supported on devices with lower than 24 SDK (1331290)

  • Mobile: [Android] Using TouchScreenKeyboard.Open with a non-empty placeholder multiple times causes the app to crash (1347370)

  • Mobile Graphics: [iOS] Player crashing when connecting external Display via USB-C port (1321153)

  • Mono: [Mono Upgrade] CommandBuffer native plugin events hang in the Editor (1308216)

  • Packman: User can't easily configure location of both UPM and Asset Store package local cache (1317232)

  • Scene Management: Crash on BuildPrefabInstanceCorrespondingObjectMap when overriding nested prefab inside AssetDatabase.StartAssetEditing() block (1324978)

  • Scripting: Crashes on mono_class_init when entering Play Mode after recompiling scripts (1262671)

  • Scripting: DomainReloadTests performance tests have regressed due to removal of built-in support for Visual Studio as a code editor (1336648)

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

  • Scripting: Increased Script Assembly reload time (1323490)

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

  • Terrain: Terrain Lit Opacity as Density option causes alpha'd areas on the 5th layer or greater to appear with artifacts (1283124)

  • uGUI: Performance degradation when activating or deactivating uGUI GameObject (1348763)

  • Video: Video player fails to start playing and null handle errors are thrown when running Unity Editor/Build with specific hardware (1237818)

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

2021.1.17f1 Release Notes


  • Android: Added more complete support for running Android apps on the Chrome OS platform. These changes enable building and running Android on x86 and x86-64 CPUs, now officially supported on Chrome OS devices. These changes also include input-related improvements for Chrome OS.

  • Shaders: Added support for specifying package requirements for SubShaders and Passes to ShaderLab.

  • Version Control: - Plastic: Added support for inviting other members. This option is available from the gear / settings icon.

    • Plastic: Added support for signing in with Cloud Edition. This is available during the onboarding screen if you have never signed in.

    • Plastic: Added support for turning off Plastic in their project. This option removes the Plastic metadata from your directory. This option is available under Assets > Plastic SCM > Turn off Plastic SCM

    • Plastic: Added notification on the Plastic SCM tab title to indicate incoming changes. Users will no longer need to have the Plastic SCM window visible to know there are incoming changes.

    • Plastic: Auto configuration of SSO

    • Plastic: Added date column in incoming changes


  • Android: Add property PlayerSettings.Android.optimizedFramePacing API (1329232)

  • Android: Bump Android Logcat package to 1.2.3

  • Graphics: Improve Line/TrailRenderer quality when points are close together. (1322317)

  • Graphics: Improvements to scene culling CPU performance - Shadow casters are rejected earlier if their shadow casting is disabled which should improve performance in scenes with scenes with lots of renderable objects that are set to not cast shadows. (1322874)

  • Graphics: VFX : Optimization while sending event to a VisualEffect by script

  • iOS: Improve logging in iOS automation: clarify existing log messages and add new ones.

  • Networking: UnityWebRequest now supports gzip compression on Windows. (1343274)

  • Package: Update Addressables to 1.18.9 and SBP to 1.19.0

  • Physics: Overhauled the articulation gizmos to have better functionality and to better match other Unity gizmos' style

  • Version Control: - Stability and performance improvements

  • WebGL: Improved network bandwidth usage of VideoPlayer.Stop() API in WebGL builds by stopping the video stream from downloading further. (1348468)

API Changes

  • Asset Pipeline: Added: Added AssetDatabase.SaveAssetIfDirty() to save individual assets if required.

  • Services: Added: Added new com.unity.services.core package that is used for common behaviour of Game Service packages


  • 2D: Tile.StartUp is called after Tilemap is loaded instead of on the first Update after Tilemap is loaded. (1327583)

  • iOS: Use Shell.ExecuteProgramAndGetStdout for process handling in iOS automation code

  • Shadergraph: Only ShaderGraph keywords count towards the shader permutation variant limit, SubGraph keywords do not.

  • Version Control: ### Changed

    • Updating license to better conform with expected customer usage.

    • Updated documentation file to meet standards.

    • Updated third-party usage.

    • No longer requires downloading of the full Plastic client. Basic features will work without additional installation. Features that require the full Plastic client will allow download and install as needed.

    • Usability improvements around checking in code

    • Improved update workspace tab UX

    • Plastic SCM context menu is now available even if the Plastic SCM window is closed

  • XR: Updated XR Legacy Input Helpers to 2.1.8.


  • 2D: Fixed an issue where OnDrawGizmos was not being called for Tile Palette when Draw Gizmos are enabled. (1348123)

  • 2D: Fixed an issue with setting a Spritesheet with padding between Sprites on a Tile Palette had a positional offset when there should not be one.

  • 2D: Prevent instantiation of GameObjects from Tiles directly onto a prefab. (1334466)

  • AI: Fixed crash caused by the NavMesh builder code that occurred in very rare and specific configurations of the world geometry. (1329346)

  • Android: Fixed a crash caused by uncaught "java.lang.IllegalStateException: The specified child already had a parent" that mainly affects Android 7.x. (1347211)

  • Android: Fixed an issue in fast swipes where Begin touch event would report starting touch position and End touch event would report deltaPosition and deltaTime since previous event. (1325554)

  • Android: Fixed issue where Android orientation could not be changed via scripts. (1330535)

  • Burst: Added [Preserve] attribute to prevent stripping a compiler service call.

  • Burst: Additional notes about BurstCompiler.CompileFunctionPointer<T> regarding ; avoid wrapping in another open generic method, and interoperability with IL2CPP.

  • Burst: Fixed a Burst package warning in the editor compiler integration with respect to BuildOptions.EnableHeadlessMode.

  • Burst: Fixed a regression that caused eager-compilation at Editor startup to be slower than it should have been.

  • Burst: Fixed an error that could occur with the form "System.InvalidOperationException: Could not find burst.initialize function in library 'SomeLibrary'".

  • Burst: Fixed an incorrect compiler error that could occur when casting a pointer to a generic type and then calling a method with generic parameters.

  • Burst: Fixed an incorrect runtime behavior that could occur when casting a pointer to a generic type.

  • Burst: Fixed an issue where stackalloc's could be wrongly hoisted out of loops.

  • Burst: Fixed an issue where the Burst Inspector would not remembers scroll position between domain reloads.

  • Burst: Fixed an issue where tvOS/iOS and other statically linked platforms would fail to burst compile if the burst compiled code contained references to functions that were [DllImport("__Internal")], due to a mismatch in calling convention.

  • Editor: Fixed a crash in ReorderableList while ensuring a valid array SerializedProperty. (1320319)

  • Editor: Fixed a cursor lock and hide when entering playmode. (1302708)

  • Editor: Fixed a slow Editor startup time issue when ShaderCache/EditorEncounteredVariants has grown too large. This also prevents it from growing too much. (1330453)

  • Editor: Fixed an issue to avoid asserts when the gradient editor was opened. (1344785)

  • Editor: Fixed an issue where Inspector was ignoring NonReorderable attribute when a class implementing it was assigned to an interface or other abstract field. (1320158)

  • Editor: Fixed an issue where lists inside lists were not rendering elements after interaction. (1332688)

  • Editor: Fixed an issue where NonReorderable attribute was being ignored on derived class variables. (1331091)

  • Editor: Fixed an issue where ReorderableLists was not being able to expand while in inspector debug mode. (1316226)

  • Editor: Fixed an issue where saving a project from the "Learn" section of the Hub would crash the Windows Editor. (1338299)

  • Editor: Fixed an issue where the Device Simulator ignored the Android Player setting Render outside safe area. (1322862)

  • Editor: Fixed the beeping issue on keyboard input for input fields in mac editor playmode. (1338906)

  • GI: Fixed a crash when baking with Enlighten on a system with more than 64 threads. (1229259)

  • IL2CPP: Corrected the behavior of Marshal.Offset so that it properly accounts for the alignment requirements of fields that occur after a struct field. (1346805)

  • IL2CPP: Fixed a memory corruption issue when a generic field was of type which had an explicit layout, and the generic type had another type with explicit layout as a field. (1337921)

  • IL2CPP: Fixed an issue where a required System.Uri constructor was being stripped in Medium or High stripping modes. (1338763)

  • IL2CPP: Fixed an issue where unaligned reads and writes where imporperly handled in the System.Runtime.CompilerServices.Unsafe.dll assembly (among others) on ARMv7. (1343375)

  • Linux: Fixed an issue where adding a new shortcut profile would crash the Editor. (1334874)

  • Mono: Fixed a hang when entering playmode after calling into managed code from native thread. (1304163)

  • Mono: Fixed random crash in mono_thread_get_undeniable_exception. (1308625)

  • Nintendo Switch: Fixed a shader precision issue that could cause artifacts in Terrain rendering. (1345800)

  • Particles: Fixed a fog issue in all blend modes of the Standard Unlit shader. (1297332)

  • Physics: Fix a crash in "PhysicsScene2D::UpdateJoints()".

  • Physics: Fixed an Clamp ArticulationBody mass issue when loading data from disk was not within the valid range for the physics engine. (1316719)

  • Scripting: Fixed a crash in UnityLinker while processing the assembly override version of UnityEngine.UIElementsModule.dll. (1328995)

  • Scripting: Fixed a player crash because data was not generated for in the build.
    The generation failed because of path having single quote, and we did not handle that well. (1327870)

  • Scripting: Fixed a runtime crashes due to TypeConverter classes was missing their default constructor. (1285338)

  • Scripting: Fixed an AssemblyResolutionException from il2cpp about netstandard that could occur when an assembly contained SecurityPermission attributes. (1311865)

  • Scripting: Fixed an issue where "GetResponseStream() errors when using CopyTo() method". (1337986)

  • Shadergraph: Fixed a Procedural Virtual Texture compatibility issue with SRP Batcher. (1329336)

  • Shadergraph: Fixed an issue where SubGraph keywords would not be deduplicate before counting towards the permutation limit. (1343528)

  • Shaders: Fixed an issue where DIRECTIONAL was being defined to nothing when no other light type was defined. (1342654)

  • Shaders: Fixed an issue where line directives sometimes erroneously skipped in output by the caching preprocessor. (1340531)

  • Shaders: Fixed an issue where Shaders were not reimported correctly when include directives are affected by shader keywords. (1333654)

  • UI: Reverting change that caused highlight to take precedence over selected. (1325066)

  • UI Toolkit: Changed Image scale mode to the more intuitive default, being ScaleMode.ScaleToFit instead of ScaleMode.ScaleAndCrop. Changing scale mode will also trigger a repaint. (1215470)

  • Windows: Fixed an issue where the stack tracing code did not work even when excessively long mono method signatures were in the callstack. (1342150)

  • XR: Fixed an issue were the Splash screen did not sends correct zNear and zFar values to XRDisplaySystem. (1349851)

  • XR: [OpenXR] Fixed an issue for a Editor memory leak when HMD was in idle state. (1344762)


Third Party Notices

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

Usamos cookies para garantir a melhor experiência no nosso site. Visite nossa página da política de cookies para obter mais informações.

Eu entendi