Cleaner
Работая с проектом, вы создаете, копируете, перемещаете, наследуете, переименовываете и удаляете ассеты. В результате может быть создано огромное количество ненужных файлов.
Cleaner — это инструмент, используемый для оптимизации проекта и экономии места на диске за счет удаления ассетов, которые не будут использоваться в окончательной сборке. Cleaner также проверяет наличие поврежденных ссылок на ассеты.
- Cleaner проверяет только те типы файлов, которые считаются ассетами с точки зрения UNIGINE. Для проверки пользовательских типов файлов нужно добавить их расширения в проектных настройках Редактора.
- Чтобы узнать больше о работе с данным инструментом, посмотрите этот видеоурок.
Cleaner проверяет каждый ассет в вашем проекте и отображает неправильно используемые ассеты, разделяя их на три категории:
-
Unused Assets — это ассеты, которые присутствуют в вашем проекте, но при этом не используются ни в одном из файлов, включенных в проект (миры, слои, ноды, меши, материалы), и на которые также нет ссылок из кода ни в одном из файлов проекта, содержащих исходный код (проверяется папка source/).Cleaner показывает имя файла и тип ассета для неиспользуемых ассетов. Когда вы щелкаете неиспользуемый ассет в Cleaner, он отображается в Asset Browser и в окне Parameters.
С помощью Cleaner вы можете удалить любые или все отображаемые ассеты.Список Unused Assets также включает все ассеты, на которые ссылаются неиспользуемые ассеты. -
Lost Assets — ассеты, на которые ссылается GUID, но недоступные в проекте.Когда вы щелкаете по утерянному ассету, другой ассет, содержащий ссылку на него, отображается в браузере ассетов и в окне Parameters. Исправление утерянных ассетов возможно только вручную.Таблица в разделе Lost Assets состоит из трех столбцов:
- Lost Asset — показывает GUID потерянного ассета.
- Asset File — показывает имя файла, содержащего ссылку на утерянный ассет.
- Node Name — показывает имя ноды, если файл, содержащий ссылку, включает ноду, которая действительно имеет ссылку на потерянный ассет.
-
Lost Runtimes — runtime-файлы, сгенерированные для ассетов, которые не доступны в проекте, но на которые ссылаются ноды в сцене.Таблица в разделе Lost Runtimesсостоит из трех столбцов:
- Runtime Path — показывает путь до потерянного runtime-файла.
- Asset — показывает имя файла, в котором хранится ссылка на ассет, для которого был сгенерирован потерянный runtime-файл.
- Node Name — показывает имя ноды, если файл со ссылкой на ассет хранит ноду, которая на самом деле ссылается на ассет, для которого был сгененирован потерянный runtime-файл.
Время, затраченное на выполнение этих процессов, можно выводить в консоль и в лог-файл. Для этого вам нужно задать переменную окружения UNIGINE_EDITOR_TIME_TRACE.
Использование Cleaner#
Чтобы открыть окно Cleaner, выберите Tools -> Cleaner в строке меню UnigineEditor.
Откроется окно Cleaner:
Рекомендуемый рабочий процесс#
-
Щелкните Refresh, чтобы проверить проект на наличие утерянных и неиспользуемых ассетов. Проанализировав ассеты в проекте, Cleaner показывает следующие детали.Вы можете сузить область поиска, указав каталог в поле Directory: Cleaner будет отображать и управлять потерянными и неиспользуемыми ассетами только из указанного каталога. Чтобы увидеть результаты после установки
(или сброса 
) каталога, еще раз нажмите Refresh.После анализа ассетов в вашем проекте Cleaner показывает следующую информацию.
-
Управляйте неиспользуемыми ассетами с помощью кнопок, доступных в верхней части окна:
- Delete Selected — удаляет только выбранные ассеты из списка неиспользуемых ассетов. Эта опция также доступна, по щелчку правой кнопкой мыши по выбранным файлам в Cleaner.
-
Delete Listed — удаляет весь список отображаемых ассетов.ВниманиеИспользуйте кнопки удаления с осторожностью. Удаленные объекты не могут быть восстановлены.
-
Show Ignore List... — отображает список игнорируемых ассетов, который уже содержит список подстановочных шаблонов по умолчанию, используемых для определения области проверки по Cleaner. Этот список может быть расширен пользователем.ВниманиеЕсли имя файла в вашем проекте создается через код (например, строка, составленная из нескольких слов), добавьте такие случаи в список игнорируемых ассетов. В противном случае такие файлы будут удалены.
После нажатия кнопки Check все файлы проекта, оставшиеся после применения списка игнорируемых ассетов (т.е. те, которые не игнорируются Cleaner и, таким образом, будут проверены), отображаются в нижней части окна Ignore List.
- Щелкните Refresh, чтобы обновить список. Удаление неиспользуемых ассетов может уменьшить количество потерянных ассетов.
- Исправьте потерянные ассеты. Исправление утерянных ассетов возможно только вручную — путем проверки каждого ассета, отображаемого во втором или третьем столбце.
- Управляйте потерянными runtime-файлами с помощью кнопок, доступных в верхней части окна: они те же, что и для неиспользуемых ассетов (см. выше).
- Delete Selected — удаляет только выбранные рантаймы из списка неиспользуемых. Этот параметр также доступен, если щелкнуть правой кнопкой мыши по выбранным файлам в Cleaner.
- Delete Listed — удаляет весь список отображаемых в данный момент рантаймов.ВниманиеИспользуйте кнопки удаления с осторожностью. Удаленные файлы нельзя восстановить.
Видеоурок#
Чтобы узнать об удалении неиспользуемых ассетов из проекта, посмотрите следующее видео: