Wiki
Правила валидации
Проверки валидации ассетов, выполняемые при check-in : 9 встроенных правил, уровни серьёзности error / warning / info, конфигурация JSON, экспорт / импорт / сброс.
Введение
Правила валидации · это проверки ассетов Unreal, выполняемые в момент check-in : именование, размер текстуры, отсутствующие зависимости и т. д. Они служат для автоматического соблюдения соглашений студии до того, как контент попадёт в репозиторий. Они настраиваются для каждого репозитория.
Доступ и роли
Вкладка Правила доступна суперадмину и project_admin в репозиториях, которыми он администрирует.
Уровни серьёзности
| Серьёзность | Эффект при check-in |
|---|---|
error | Блокирует check-in, пока проблема не будет исправлена. |
warning | Предупреждает, но пропускает. |
info | Чисто информационный. |
9 встроенных правил
| Правило | По умолчанию | Что оно проверяет |
|---|---|---|
blueprint_compilation | error | Blueprint компилируются без ошибок перед check-in. |
naming_convention | warning | Префиксы именования (стиль Allar UE5) : T_ текстуры, M_ материалы, BP_ blueprints, SM_ статические меши, WBP_ виджеты и т. д. |
max_texture_size | warning | Максимальный размер текстур : по умолчанию 4096 × 4096, требуется степень 2. |
material_complexity | warning | Сложность материалов : по умолчанию не более 256 инструкций, 16 сэмплов текстур. |
import_settings | warning | Соответствующие настройки импорта (текстуры, меши). |
missing_dependency | error | Нет отсутствующих зависимостей (по умолчанию игнорирует контент движка). |
circular_dependency | error | Нет циклических зависимостей (глубина поиска 20 по умолчанию). |
unreferenced_asset | info | Отмечает ассеты без ссылок (по умолчанию исключает карты и виджеты). |
duplicate_asset | warning | Обнаруживает дублирующиеся ассеты (по умолчанию игнорирует .umap). |
Включение и настройка
Для каждого правила :
- Переключатель : включает / отключает правило. Немедленное сохранение.
- Серьёзность : выпадающее меню error / warning / info. Немедленное сохранение.
- Конфигурация (JSON) : разверните правило (шеврон), чтобы отредактировать его параметры в JSON, затем Save Config. Недопустимый JSON блокирует сохранение с указанием ошибки.
Пример : снизить max_texture_size до 2048 для мобильного проекта или перевести
naming_convention в error, чтобы применять его строго.
Экспорт, импорт, сброс
- Export : скачивает файл
rules.json, содержащий состояние всех правил (активация, серьёзность, конфигурация). - Import : перезагружает
rules.jsonи применяет каждую запись к соответствующим правилам (неизвестные ключи игнорируются). - Reset to Defaults : возвращает все правила к их значениям по умолчанию. Пользовательские конфигурации теряются (запрашивается подтверждение).
Экспорт / импорт служит для копирования политики валидации из одного репозитория в другой или для её версионирования в офлайне.
rules.json в репозитории
.uversion/rules.json применяется к политике репозитория только если автор коммита
обладает возможностью manage_rules. Иначе файл сохраняется, но правила не меняются. Это защита :
участник с правом записи по этому пути не может отключить валидацию, закоммитив файл.
Частые ошибки
Check-in заблокирован
Правило с уровнем error не прошло. В сообщении указано, какое именно. Исправьте ассет или (если правило
слишком строгое для вашего контекста) понизьте его серьёзность до warning.
Сброс стирает мои настройки
Reset to Defaults разрушителен для ваших пользовательских конфигураций. Сделайте Export заранее, если хотите иметь возможность вернуться назад.
Кажется, что правило ничего не делает
Проверьте, что оно включено (переключатель), и что его серьёзность не info, если вы ожидали блокировки.
Только error блокирует check-in.