Upgrading to Unity 2021.1

Note: Follow the advice in this section in release order. For example, if you need to upgrade your project from 2018 to 2021, read the 2019 upgrade guides to see if there are any changes that you need to make before you read the 2021 upgrade guides.

This page lists changes in the Unity 2021.1 version which might affect existing projects when you upgrade from 2020 LTS to 2021.1.

Device Simulator

The Device Simulator is now part of the Editor and is accessible from the Game window. To set up the Device Simulator, add the UnityEngine.Device namespace to the Screen, Application, and SystemInfo classes: UnityEngine.Device.Screen; UnityEngine.Device.Application; UnityEngine.Device.SystemInfo;

To switch to UnityEngine.Device, add the following logic to each script you want to use with the simulator: using Screen = UnityEngine.Device.Screen; using Application = UnityEngine.Device.Application; using SystemInfo = UnityEngine.Device.SystemInfo; The new namespace UnityEngine.Device transitions smoothly from Simulator (when in Editor) to actual device API with a runtime build.

Environment Lighting

The Editor now automatically bakes the default skyboxA special type of Material used to represent skies. Usually six-sided. More info
See in Glossary probe and ambient probe and retains that data until you manually bake the SceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary. When you upgrade, Scenes with no ambient lightLight that doesn’t come from any specific direction, and contributes equal light in all directions to the Scene. More info
See in Glossary contribution might visually change. To restore the original look of these Scenes, set the Environment lighting intensity multiplier to 0. Alternatively, set the skybox to black, bake the scene, then reset the skybox to your preferred sky color.

Enable Code Coverage preference

The user interface for managing Code Coverage has moved from General Preferences to within the Code Coverage package.

The Code Coverage package is available as a released package via the Package Manager for Unity 2019.3 and above. The latest version is 1.0.0.

You can use one of the following methods to enable code coverage:

• Install the Code Coverage package, open the Code Coverage window (Window > Analysis > Code Coverage) and select Enable Code Coverage.
• Use the Command line argument -enableCodeCoverage in batchmode.
• Use the Coverage.enabled API. Example class:

// Create a new C# script called CodeCoverageMenuItem and place it
// under the Editor folder.
// This class creates a toggle menu item under Code Coverage > Enable
// Code Coverage. Use it to enable/disable Code Coverage.

using UnityEditor;
using UnityEngine.TestTools;

class CodeCoverageMenuItem
{
    const string EnableCodeCoverageItemName = "Code Coverage/Enable Code Coverage";

    [MenuItem(EnableCodeCoverageItemName, false)]
    static void EnableCodeCoverage()
    {
        Coverage.enabled = !Coverage.enabled;
    }

    [MenuItem(EnableCodeCoverageItemName, true)]
    static bool EnableCodeCoverageValidate()
    {
        Menu.SetChecked(EnableCodeCoverageItemName, Coverage.enabled);
        return true;
    }
}