Воспроизводимый импорт ресурсов: идентичность, настройки и версии инструментов

Определите критерий воспроизводимости

Конвейер ресурсов преобразует авторские файлы в ресурсы времени выполнения. Для воспроизводимости нужно знать и входные данные, и преобразование. Два разработчика могут иметь одинаковые байты изображения, но получать разные текстуры из-за настроек импорта. Решите, нужны ли проекту идентичные выходные байты, эквивалентные свойства ресурсов или согласованный визуальный результат: это разные критерии приёмки.

Сохраняйте идентичность ссылок

Метаданные Unity хранят уникальный идентификатор и параметры импорта в сопутствующем файле .meta. При перемещении ресурса вне редактора этот файл должен перемещаться вместе с ним; потеря метаданных может разрушить ссылки. [1] Рассматривайте перенос как операцию с сохранением идентичности и проверяйте метаданные вместе с исходниками. Имя файла не заменяет идентификатор, используемый сериализованными ссылками.

Отделяйте конфигурацию от кэша

Godot сохраняет конфигурацию импорта каждого ресурса рядом с исходником в файлах .import и рекомендует включать её в контроль версий. Сгенерированные импорты находятся в .godot/imported/ и восстанавливаются повторным импортом. [2] Руководство по контролю версий для Godot 4.1 и новее исключает данные кэша .godot/. У старых выпусков другие исключения, поэтому используйте руководство для версии проекта. [3]

Храните необходимые настройки проекта, скрипты импорта и версии зависимостей вместе с авторитетными исходными данными. Явно фиксируйте платформенные переопределения, как и настройки по умолчанию. Рабочий кэш разработчика не должен быть единственной сохранившейся копией нужного входного файла.

Разберите проверку чистого импорта

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

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

Делайте изменения объяснимыми

При обновлении инструментов сначала пересоберите характерные текстуры, меши и аудио. Сохраняйте хэши исходников, версии инструментов и изменения импорта в записи сборки. Если выходные байты изменились при стабильных требуемых свойствах, исследуйте причину до принятия различия.

Проверяйте переименование и перенос тестового ресурса вместе с редактированием. Воспроизводимая текстура, потерявшая все ссылки материалов, всё равно означает сломанный конвейер. Рассматривайте политику кэша, сохранение идентичности и проверку результатов как отдельные обязанности.

Источники

[1] Asset metadata — Unity Technologies.

[2] Godot import process — Godot Engine contributors.

[3] Godot version control systems — Godot Engine contributors.