Проверка перед сборкой и CI

Находит потерянные ссылки и незаполненные обязательные поля до выпуска проекта.

Быстрый старт

Откройте Tools → Aspid 🐍 → FastTools → Settings и выберите Build / CI gate → Fail. Теперь потерянные типы прерывают сборку плеера. По умолчанию стоит Warn.

Проверка сообщает о нарушениях; исправление описано на странице Восстановление SerializeReference.

Проверка перед сборкой

Строгость проверки задаёт настройка Build / CI gate:

Режим	Сборка плеера	Отдельный CI-запуск
Off	Проверка пропускается	Ни поиска, ни отчёта, старый отчёт остаётся; код 0
Warn	Предупреждение, сборка продолжается	Отчёт и нарушения в журнале; код 0
Fail	Потерянные типы прерывают сборку	Отчёт; код 1 при нарушениях

Сборка проверяет все ассеты под Assets/, а не только попадающие в неё: в режиме Fail её остановит и неиспользуемый префаб — исключите такие папки в Excluded scan folders.

Что проверяет каждый запуск

Запуск	Потерянные типы	Пустые поля с Required = true
Project References → Scan Project	Да, вместе с ожидающими миграциями	Если режим не Off, отдельной группой Required violations
Asset References	Да	Да, в любом режиме
Сборка плеера	Если режим не Off	Нет
CI без -srGateRequired	Если режим не Off	Нет
CI с -srGateRequired	Если режим не Off	Если режим не Off

Обязательное поле задаёт [TypeSelector(Required = true)], подробнее — в разделе Обязательное поле. В сценах не проверяются обязательные поля внутри managed-ссылок, в коллекциях и в override префабов.

Обнаружение новых поломок

Breakage detection сообщает о новых потерянных ссылках и именах типов сразу после изменения скриптов или ассетов — уведомлением, а также в Console. Настройка включена по умолчанию и находится в Tools → Aspid 🐍 → FastTools → Settings, а также в Preferences → Aspid.FastTools → SerializeReference. Это личная настройка: у каждого участника своя.

Область проверки

• сохранённые .prefab, .asset и .unity под Assets/, кроме Excluded scan folders;
• [SerializeReference] и имена в полях SerializableType и SerializableMonoScript; строки с [TypeSelector] не проверяются;
• ожидающие миграции с MovedFrom потерянными не считаются;
• двоичные ассеты и нескачанные файлы Git LFS не проверяются, CI перечисляет их в отчёте; для полного сканирования включите Asset Serialization → Mode → Force Text и скачайте файлы LFS.

Excluded scan folders исключает папки из Project References, проверки сборки, CI и обнаружения новых поломок.

Build / CI gate, Excluded scan folders и Auto de-alias duplicated list elements — общие настройки с зелёной полосой. Они хранятся в ProjectSettings/SerializeReferenceSharedSettings.asset, общем для команды и CI, а ещё открываются в Project Settings → Aspid.FastTools → SerializeReference.

Запуск в CI

Unity -batchmode -projectPath . \
  -executeMethod \
  Aspid.FastTools.SerializeReferences.Editors.SerializeReferenceCiGate.RunCheck \
  -srGateReport SerializeReferenceGateReport.txt \
  -srGateRequired -srGateFail

Код выхода 2 означает сбой самой проверки.

Флаги запуска

Флаг	Действие
-srGateReport <path>	Путь отчёта от корня проекта, по умолчанию SerializeReferenceGateReport.txt; папка должна существовать, файл перезаписывается
-srGateRequired	Дополнительно проверить незаполненные поля с Required = true
-srGateFail	Использовать Fail вместо режима проекта, даже Off
-srGateWarnOnly	Использовать Warn вместо режима проекта, даже Off; важнее -srGateFail, если переданы оба

Отчёт

Отчёт содержит потерянные типы, незаполненные обязательные поля и пропущенные файлы. Пропущенные файлы не меняют код выхода.

Формат отчёта

Отчёт начинается с заголовка:

# SerializeReference Gate Report
# Violations: 2
# Not scanned (not text YAML): 2
#   Binary	Assets/Legacy/OldLoadout.prefab
#   LfsPointer	Assets/Levels/Arena.unity

Дальше — по строке на нарушение, поля разделены табуляцией:

KIND    assetPath    fileId    rid    className    fieldPath    origin

Поле	Содержимое
KIND	MissingType, MissingTypeName или RequiredUnset
assetPath	Путь файла
fileId	Идентификатор объекта-владельца внутри файла; для override экземпляра префаба — идентификатор экземпляра
rid	Идентификатор managed-ссылки; в строках RequiredUnset — -2 для пустого [SerializeReference] и 0 для string и SerializableType; в строках MissingTypeName — managed-ссылка, в которой лежит поле, или 0
className	Сохранённое имя класса для MissingType; сохранённое имя типа целиком для MissingTypeName
fieldPath	Путь обязательного поля; поле обёртки для MissingTypeName; для MissingType из override — переопределённое поле; иначе пусто
origin	override для типа, заданного override экземпляра префаба; иначе пусто

В Asset References запись находится по rid, строка RequiredUnset с rid 0 — по fieldPath; строка с origin override — в карточке Prefab instance overrides в Project References. Строка MissingTypeName находится в своей группе type name в Project References.

Пример в пакете

Обязательное поле и потерянные типы для проверки есть в примере SerializeReferences.