Перейти к основному содержимому

Восстановление SerializeReference

Ссылки, потерянные после переименования классов, находятся по всему проекту и восстанавливаются группами.

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

Какой способ выбрать​

Где исправлятьЧто сохраняетсяОтмена
Fix в инспекторе ассетаДанные записи в файлеНет
Fix в сцене или Prefab ModeТолько простые поля верхнего уровняUndo до сохранения
Asset ReferencesДанные записи в файлеНет
Project ReferencesДанные записей группы в файлахКнопка Undo в сводке перезаписи

Project References также восстанавливает имена, которые хранят поля SerializableType и SerializableMonoScript, см. Имена типов. Как замечать новые поломки в редакторе, перед сборкой и в CI, описано на странице Проверка перед сборкой и CI.

Fix в инспекторе​

После переименования, переноса или удаления класса у поля появляется Missing type, а данные остаются в ассете.

Потерянная ссылка с Fix и подсказкой → Pistol в инспектореПотерянная ссылка с Fix и подсказкой → Pistol в инспекторе

ДействиеЧто делает
FixОткрывает выбор класса, включая скрытые через Hidden
→ PistolНазначает предложенный класс; причину показывает подсказка
внимание

В сцене и Prefab Mode Fix возвращает только простые поля верхнего уровня: вложенные объекты, массивы, списки, векторы, цвета и ссылки на объекты получают значения по умолчанию.

Когда Fix нет​

СлучайЧто делать
Выбрано несколько объектовВыберите один: до этого Missing type не показывается
В сцене или Prefab Mode есть несохранённые измененияСохраните: до этого поле показывает <None> без Missing type
После несохранённых правок списка не понять, какой элемент стоит в слоте: например, удалён один из двух соседних потерянных элементовСохраните: до этого слот показывает <None> без Missing type
Экземпляр префаба, класс хранится в исходном префабеИсправьте исходный префаб, его имя в подсказке
Экземпляр префаба, класс задан overrideВыберите новый класс на экземпляре или отмените override

Потерянные элементы в списках​

Сохранение, которое меняет размер списка, а у префаба любое сохранение, записывает потерянные элементы списка как <None> и удаляет их данные. FastTools возвращает их сразу после сохранения. Остальные элементы он сопоставляет по rid, поэтому если вы переместили, удалили, продублировали или добавили элемент, потерянный элемент встаёт между прежними соседями. Восстановленные элементы перечисляются в Console.

СлучайЧто происходит
Вы выбрали для потерянного элемента <None>, другой класс или вставили поверх негоЭлемент остаётся заменённым, в том числе после перезагрузки скриптов. После Edit → Undo этого выбора следующее сохранение элемент не теряет
Вы удалили элемент, стоявший среди других потерянных или <None>-элементовПо сохранённому файлу не понять, какой именно удалён: <None>-элементы и первые потерянные остаются. Console предупреждает о невосстановленном элементе, называет его индекс и rid, чтобы вы могли взять его из системы контроля версий
Между двумя сохранениями вы несколько раз правите списокДанные возвращаются, но в наиболее вероятный слот, а он не всегда исходный. Console называет слот каждого восстановленного элемента, а самые неуверенные помечает как slot guessed
Списки внутри другой ссылки или вложенного класса, загруженные сцены, Prefab ModeНе защищаются

Project References: восстановить группу​

Откройте Tools → Aspid 🐍 → FastTools → Project References; Asset References — соседняя вкладка того же окна. Scan Project читает файлы .prefab, .asset, .unity, .controller и .playable под Assets/, кроме Excluded scan folders. Каждый проход показывает индикатор прогресса; Cancel останавливает проверку и оставляет прежние результаты. Группа показывает первые 200 записей, а Show more добавляет следующие 200.

Project References: группы Broken с Fix all и Smart Fix, группа Renamed с Migrate allProject References: группы Broken с Fix all и Smart Fix, группа Renamed с Migrate all

Действия с группой​

ГруппаКнопка в заголовкеСтрока под заголовком
Потерянный типFix all ▼ — выбрать класс для всех записейSmart Fix → Game.Weapons.Pistol — применить предложенный класс; причина в подсказке
Переименование с [MovedFrom]Reassign all ▼ — выбрать другой класс вместо нового имениMigrate all → Game.Weapons.Crossbow — записать новое имя, см. Миграции

Подписи кнопок Fix all, Reassign all, Migrate all содержат число записей группы: Fix all (4) ▼, Migrate all (4) → Game.Weapons.Crossbow.

Каждое действие спрашивает подтверждение Rewrite. <None> в выборе класса очищает ссылки группы и удаляет их данные, включая поля с тем же rid; он спрашивает Clear и Undo не имеет. В открытых и несохранённых файлах он очищает ссылки в памяти, до сохранения.

Что сохраняется при восстановлении​

Восстановление переписывает только класс, пространство имён и сборку записи; её данные и rid остаются.

внимание

Если поля группы разных типов, выбранный класс может подойти не всем: несовместимые записи станут null при переимпорте.

В сводке перезаписи есть Undo: он возвращает прежний класс записям, в которых всё ещё стоит новый. Undo пропадает после Rescan, закрытия окна и перезагрузки домена; Edit → Undo перезапись не отменяет.

Экземпляры префабов​

Потерянный класс, заданный через override экземпляра префаба, — в варианте, вложенном префабе или экземпляре в сцене, — показывается в отдельном разделе Prefab instance overrides.

Карточка Prefab instance overrides с потерянным GhostRailgun в варианте EliteLoadoutКарточка Prefab instance overrides с потерянным GhostRailgun в варианте EliteLoadout

Fix all, Smart Fix, Migrate all и <None> такие записи не переписывают: выберите новый класс на экземпляре в инспекторе или отмените override. В Asset References ссылки, которые есть только в override, не видны.

Имена типов​

Поле SerializableType или SerializableMonoScript, чьё сохранённое имя больше не находится, попадает в группу с пометкой type name. Группа объединяет одно сохранённое имя и перечисляет его поля по ассету и пути поля.

ДействиеЧто делает
Fix all ▼Открывает выбор типа с ограничением полей и записывает выбранный тип во все поля группы
Smart Fix → Game.Combat.SpearЗаписывает единственный подходящий тип с тем же именем класса

Поле SerializableMonoScript получает ещё и скрипт выбранного типа. Override экземпляра префаба тоже переписывается, потому что хранит имя как обычное значение.

Строки с [TypeSelector] сканирование не находит: восстановите их в инспекторе или кнопкой Change ▼ в Asset References.

Asset References: разобрать один ассет​

Откройте Tools → Aspid 🐍 → FastTools → Asset References и укажите сохранённый префаб, ScriptableObject или сцену в поле рядом с Rescan. Либо выберите ассет в окне Project и вызовите Assets → Aspid 🐍 → FastTools → Asset References в главном или контекстном меню, либо нажмите Alt+Shift+R (Option+Shift+R на macOS): вкладка откроется на этом ассете. Щелчок по строке записи в Project References открывает её ассет здесь же.

Asset References: потерянный GhostCrossbow, общий Pistol с меткой shared и запись Railgun в OrphanedAsset References: потерянный GhostCrossbow, общий Pistol с меткой shared и запись Railgun в Orphaned

ОбозначениеЗначение
Полоса с Fix Missing ▼Сохранённый класс не найден; кнопка открывает выбор класса
Строка Smart Fix → Game.Weapons.PistolКласс, подобранный как у Smart Fix в Project References
Строка Migrate → Game.Weapons.Crossbow под полосой Fix ▼Класс переименован с [MovedFrom]: строка записывает новое имя, Fix ▼ выбирает другой класс
Полоса с Change ▼, Assign ▼ или Assign Required ▼Меняет класс исправной ссылки, заполняет пустое или обязательное поле; ассет сохраняется сразу
● sharedНесколько полей указывают на один экземпляр; точки одного цвета отмечают связанные поля
type name в подписи карточкиПоле [TypeSelector]-строки, SerializableType или SerializableMonoScript; оно показано, задан в нём тип или нет
children on another card в подписи карточкиДочерние ссылки этой ссылки нарисованы один раз, под её первой карточкой, которая не стоит под потерянным типом; эта карточка — другое поле, которое указывает на ту же ссылку
Строка с именем поля и Assign ▼Необязательное поле без ссылки или типа, на своём месте среди полей; пустое поле с [Required] остаётся янтарной карточкой
Раздел OrphanedЗаписи, на которые не указывает ни одно поле; Clear в шапке карточки удаляет запись из файла после подтверждения, без Undo
Заголовок с ▼Объект, чьи поля показаны в карточках ниже, например Player › Loadout; щелчок сворачивает его карточки
Unsaved changes с кнопкой Save AssetВ ассете есть несохранённые правки, а карта читает сохранённый файл: кнопка сохраняет ассет и строит карту заново

Fix Missing, Smart Fix и Migrate записывают класс в файл сразу, и Edit → Undo его не отменяет.

GhostWeapon восстанавливается как Pistol в Asset ReferencesGhostWeapon восстанавливается как Pistol в Asset References

Миграции с MovedFrom​

Если CrossbowLauncher переименован в Crossbow с [MovedFrom], Unity загружает старые ссылки сам. Migrate all записывает новое имя в файлы, чтобы атрибут можно было удалить:

В файле — до Migrate allПосле
type: {class: CrossbowLauncher, …}type: {class: Crossbow, …}

Группа становится ожидающей миграцией, только если старое имя указано в [MovedFrom] ровно у одного класса, этот класс подходит полю, а сохранённый класс — не закрытый generic.

Удаляйте [MovedFrom], только когда старое имя не осталось ни в одном файле. Migrate all не переписывает его:

  • в override экземпляров префабов;
  • в папках из Excluded scan folders и в файлах вне Assets/;
  • в файлах из таблицы ограничений.

Ограничения​

ГдеОграничение
Открытые сцены, Prefab Mode, несохранённые и заблокированные файлыFix all, Smart Fix и Migrate all их пропускают: сохраните и закройте файл или используйте Fix в инспекторе с ограничениями переноса данных
Сцены и поля под потерянной родительской ссылкойAsset References меняет только потерянные типы; в сцене показывает только пустые обязательные имена типов
Двоичные ассеты и нескачанные файлы Git LFSНе сканируются: Scan Project считает их, Console перечисляет, Asset References показывает Not scanned; используйте Force Text и скачайте файлы LFS
Файлы, последний раз сохранённые до Unity 2021.2Их managed-ссылки не читаются: пересохраните файлы в текущей версии Unity
Больше 1000 карточек ссылок в одном окнеAsset References рисует первые 1000 и сообщает, сколько пропустил; Project References исправляет потерянные типы без этого предела