Включаем Nullable reference types в Unity за несколько минут

? Что такое Nullable reference types

Nullable reference types допускает присваивать значение null ссылочным типам.

? Какие преимущества дает концепция ссылочных nullable-типов

• Design time анализ

• Четкие контракты API

• Проверка Null состояния статическим анализом IDE, помогает устранить исключения System.NullReferenceException

? Требования

• .NET Standard 2.1+

• Unity 2021+

? Как включить статический анализ

Для анализа отдельных сборок

Создаем файл csc.rsp рядом со сборкой asmdef :

В содержимое csc.rsp добавляем аргумент nullable :

-nullable:enable

Для анализа отдельных .cs файлов

В содержимое .cs добавляем контекст аннотаций #nullable :

#nullable enable  namespace Sandbox.Domain {     public struct User     {         public int Id { get; set; }         public string Nickname { get; set; }         public string? Phone { get; set; }     } }

Использование Nullable типа в свойстве Phone, указывает что значение можно не присваивать.

? Руководство по миграции

Если заранее известно, что объекты инициализируется внешними сервисами, подавляем предупреждения анализатора с помощью null-forgiving оператора !.

Unity UI бинды:

[SerializeField] private Image _image = null!;

DI VContainer атрибуты:

namespace Sandbox.Domain {     private MoveController _moveController = null!;      [Inject]     public void Init(MoveController moveController)     {         _moveController = moveController;     } }

Чтобы исключить из анализа отдельную часть кода, воспользуйтесь следующей аннотацией:

#nullable disable  using System;  namespace Sandbox.Server.Responses {     [Serializable]     public class UserResponse     {         public int Id;         public string Name;     } }

? Полезные ссылки

Nullable reference types in Unity
NullReferenceException = ♥ 
Microsoft guide