Cleaner
Работая с проектом, вы создаете, копируете, перемещаете, наследуете, переименовываете и удаляете ассеты. В результате может быть создано огромное количество ненужных файлов.
Cleaner — это инструмент, используемый для оптимизации проекта и экономии места на диске за счет удаления ассетов, которые не будут использоваться в окончательной сборке. Cleaner также проверяет наличие поврежденных ссылок на ассеты.
- Cleaner проверяет только те типы файлов, которые считаются ассетами с точки зрения UNIGINE. Для проверки пользовательских типов файлов нужно добавить их расширения в проектных настройках Редактора.
- Чтобы узнать больше о работе с данным инструментом, посмотрите этот видеоурок.
Обзор инструмента#
Cleaner проверяет каждый ассет в вашем проекте и отображает неправильно используемые ассеты.
Чтобы открыть окно Cleaner, выберите Tools -> Cleaner в строке меню UnigineEditor.
Откроется окно Cleaner:
Unused Assets#
На этой вкладке отображаются ассеты, которые присутствуют в вашем проекте, но при этом не используются ни в одном из файлов, включенных в проект (миры, слои, ноды, меши, материалы), и на которые также нет ссылок из кода ни в одном из файлов проекта, содержащих исходный код (проверяется папка source/).
Cleaner показывает имя файла и тип ассета для неиспользуемых ассетов. Когда вы щелкаете неиспользуемый ассет в Cleaner, он отображается в Asset Browser и в окне Parameters.
С помощью Cleaner вы можете удалить любые или все отображаемые ассеты.
Список Unused Assets также включает все ассеты, на которые ссылаются неиспользуемые ассеты.
- Delete Selected — удаляет только выбранные ассеты из списка неиспользуемых ассетов. Эта опция также доступна, по щелчку правой кнопкой мыши по выбранным файлам в Cleaner.
-
Delete Listed — удаляет весь список отображаемых ассетов.
Используйте кнопки удаления с осторожностью. Удаленные объекты не могут быть восстановлены. -
Show Ignore List... — отображает список игнорируемых ассетов, который уже содержит список подстановочных шаблонов по умолчанию, используемых для исключения файлов из проверки с помощью инструмента Cleaner. Этот список может быть расширен пользователем.
Если имя файла в вашем проекте создается через код (например, строка, составленная из нескольких слов), добавьте такие случаи в список игнорируемых ассетов. В противном случае такие файлы будут удалены.После нажатия кнопки Check все файлы проекта, которые будут игнорироваться инструментом Cleaner при проверке, отображаются в нижней части окна Ignore List.
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-файл.
Управление потерянными runtime-файлами осуществляется с помощью кнопок, доступных на вкладке: они такие же, что и для неиспользуемых ассетов.
- Delete Selected — удаляет только выбранные рантаймы из списка неиспользуемых. Этот параметр также доступен, если щелкнуть правой кнопкой мыши по выбранным файлам в Cleaner.
Delete Listed — удаляет весь список отображаемых в данный момент рантаймов.
Используйте кнопки удаления с осторожностью. Удаленные файлы нельзя восстановить.
Similar Assets#
На этой вкладке отображаются группы, содержащие изображения с высокой степенью визуального сходства. Вы можете найти и удалить лишние изображения, чтобы сэкономить место в проекте.
Directory | Каталог, содержащий сравниваемые ассеты. |
---|---|
Similarity Threshold | Степень визуального сходства, на основании которой группируются похожие изображения. |
Preview Resolution | Разрешение предварительного просмотра изображения, которое будет использоваться в качестве основы для сравнения. |
Resolution of Compared Images | Разрешение других предварительных просмотров изображений, которые будут сравниваться с основным. |
Similarity | Минимальный процент сходства между всеми выбранными изображениями. |
После нажатия кнопки Refresh начнется процесс сравнения. Результат этого процесса будет отображен в виде списка групп, каждая из которых содержит изображения с визуальным сходством, превышающим значение Similarity Threshold. Управление файлами осуществляется с помощью контекстного меню, доступного при нажатии правой кнопки мыши на файле из списка.
Console Info#
Время, затраченное на выполнение этих процессов, можно выводить в консоль и в лог-файл. Для этого вам нужно задать переменную окружения UNIGINE_EDITOR_TIME_TRACE.
Рекомендуемый рабочий процесс#
-
Щелкните Refresh, чтобы проверить проект на наличие утерянных и неиспользуемых ассетов. Проанализировав ассеты в проекте, Cleaner показывает следующие детали.
Вы можете сузить область поиска, указав каталог в поле Directory: Cleaner будет отображать и управлять потерянными и неиспользуемыми ассетами только из указанного каталога. Чтобы увидеть результаты после установки (или сброса ) каталога, еще раз нажмите Refresh.
После анализа ассетов в вашем проекте Cleaner показывает информацию.
-
Управляйте неиспользуемыми ассетами с помощью кнопок, доступных во вкладке Unused Assets.
Используйте кнопки удаления с осторожностью. Удаленные объекты невозможно восстановить. - Щелкните Refresh, чтобы обновить список. Удаление неиспользуемых ассетов может уменьшить количество потерянных ассетов.
- Исправьте потерянные ассеты. Исправление утерянных ассетов возможно только вручную — путем проверки каждого ассета, отображаемого во втором или третьем столбце.
-
Управляйте потерянными runtime-файлами с помощью кнопок, доступных на вкладке: они такие же, что и для неиспользуемых ассетов (см. выше).
Используйте кнопки удаления с осторожностью. Удаленные файлы нельзя восстановить. - Выполните поиск похожих ассетов в проекте и подумайте, можно ли использовать один и тот же ассет вместо нескольких.
Видеоурок#
Чтобы узнать об удалении неиспользуемых ассетов из проекта, посмотрите следующее видео: