Unity Hub: как управлять проектами и версиями редактора без путаницы

На компьютере стоят две версии Unity, учебный проект открывается одной, старый — другой, а после переноса папки Hub пишет, что проект не найден. В таких ситуациях проблема часто находится до запуска самого редактора: нужно правильно связать проект, путь на диске и версию Editor.

Unity Hub — приложение для управления этой связью. Через него создают и открывают проекты, устанавливают версии Unity Editor, добавляют модули и управляют лицензиями. Ниже — объяснение основных разделов и практические сценарии, которые пригодятся уже во время первых недель обучения.

Руководство по настольному Unity Hub. Названия и положение элементов интерфейса могут различаться между его версиями.

ТОП-5 курсов обучения Unity:

Представьте проект как папку с исходными ресурсами, пакетами и настройками. Unity Editor определённой версии читает её и запускает игру. Hub показывает доступные проекты и помогает выбрать подходящую установку редактора.

Это объясняет несколько вещей. Установка Hub сама по себе не устанавливает все версии Editor. Папка проекта находится на диске отдельно от приложения Hub. А обновление Hub не означает, что все ваши проекты автоматически переведены на новую версию Unity.

Если Editor ещё не установлен, начните с пошаговой установки Unity на ПК. Здесь сосредоточимся на ежедневном использовании уже работающей среды.

Основные возможности собраны в нескольких местах. Их назначение описано в официальном справочнике окна Hub.

Загрузка графики из Asset Store находится уже в Editor, в Package Manager. Hub может открыть нужный проект, но размещать в нём модели и настраивать их материалы вы будете в редакторе.

Откройте Projects и выберите New project. Перед нажатием Create проверьте три решения: версию Editor, шаблон и папку проекта. В официальном руководстве по созданию проекта они рассматриваются как отдельные настройки.

Версия важна для совместимости. Если учитесь по курсу, используйте согласованную с ним версию. Если начинаете самостоятельно, выберите поддерживаемый стабильный выпуск; различия между ветками разобраны в статье о выборе версии Unity.

Шаблон задаёт исходную конфигурацию. Для простой игры с видом сверху разумно начать с базового 2D-шаблона. Для проекта на URP выбирайте подходящий шаблон с этим конвейером. Если урок использует Built-in, переход на другой шаблон добавит отличия в материалах и настройках рендеринга.

Папку выбирайте осознанно. Например, D:\UnityProjects\CoinCollector позволяет сразу понять, где искать исходники. Название проекта в Hub и имя исполняемого файла будущей игры — разные настройки; окончательное имя продукта можно задать позже в Player Settings.

Не выбирайте папку Assets вместо корня. И не добавляйте внешний каталог с несколькими проектами, ожидая, что Unity откроет его как одну игру. Нужна именно папка конкретного проекта.

При получении проекта из Git отсутствие Library обычно нормально: Unity восстановит импортированные данные при открытии. Важнее, чтобы автор передал исходные ресурсы вместе с метаданными, пакеты и настройки проекта. Подробности — в разборе структуры проекта Unity.

Посмотрите номер в строке проекта в Hub. Дополнительно его можно проверить в текстовом файле ProjectSettings/ProjectVersion.txt. Например, строка m_EditorVersion: 6000.3.7f1 указывает конкретную версию редактора, в которой проект сохранялся.

Когда вы разбираете чужой проект, начинайте с указанной версии, если она доступна. Открытие сразу в самом новом Editor смешивает две задачи: понять устройство игры и устранить различия между версиями.

Для командной работы фиксируйте полную версию, включая номер исправления. Формулировка «у всех Unity 6» слишком неточна, если нужно одинаково воспроизводить ошибки и сборки.

Разные проекты могут требовать разные ветки Unity. Учебный пример может использовать 2022.3, новый прототип — Unity 6, а рабочая игра — конкретную версию, согласованную с командой. Hub позволяет хранить эти установки одновременно и открывать проект подходящей версией.

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

Если Editor уже установлен вручную, в Installs используйте Locate, чтобы добавить существующую установку. Это регистрация приложения в Hub. Она не превращает ручную установку в установку через Hub и не гарантирует доступность Add modules.

Для Editor, установленного через Hub, откройте Installs, найдите нужную версию и выберите Manage → Add modules. Добавьте поддержку целевой платформы. Официальная инструкция по модулям Editor также объясняет ограничение для ручных установок.

Добавляйте модуль той версии, которой действительно открывается проект. Если Android установлен для другого Editor, это не даёт текущему проекту нужные инструменты сборки. После установки переключение целевой платформы выполняется в самом Unity Editor.

Сам модуль ещё не решает все платформенные задачи. Для Android нужно проверить SDK и параметры приложения, для Web — ограничения браузерной среды. Hub подготавливает инструменты; настройки игры остаются частью проекта.

Hub хранит путь к проекту. Если папка переехала из C:\Projects\Game в D:\UnityProjects\Game, старая запись может перестать работать, хотя файлы игры целы.

Команда удаления записи из списка Hub и удаление файлов проекта — разные операции. При работе со списком внимательно читайте название выбранного действия. Порядок добавления и удаления записей приведён в руководстве по управлению проектами.

Настройка Project location задаёт место для создания новых проектов. Если вы изменили её в Settings, это само по себе не означает перенос всех старых папок. Различия между путями проекта и установок описаны в справочнике настроек Hub.

Обновление Hub и смена версии Editor требуют разных проверок. Если меняется только Hub, проверьте, что он по-прежнему видит установки и открывает проекты. Если вы открываете игру другой версией Editor, подготовьтесь к изменениям самого проекта.

Перед переходом сделайте коммит или резервную копию. Установите новый Editor рядом со старым, откройте отдельную копию проекта и проверьте Console, основные сцены, материалы, пакеты и сборку. Откат через сохранённую копию надёжнее, чем попытка просто снова открыть обновлённую папку старым редактором.

Сначала обновляйте учебный прототип или тестовую копию. У игры, которая уже готовится к выпуску, смена версии должна иметь конкретную причину: нужное исправление, поддержка платформы или функция. Номер новее сам по себе не описывает пользу для этого проекта.

Появление проекта в списке не подтверждает, что он загружен в облако или что его исходники сохранены ещё где-то. Для истории изменений используйте систему контроля версий; для восстановления после потери диска нужна копия в другом месте.

Как минимум сохраняйте исходные Assets с .meta, Packages и ProjectSettings. Если проект зависит от локальных пакетов за пределами своей папки, сохраните и их. Список Projects удобен для запуска, но не является архивом ваших игр.

Такой порядок помогает не переустанавливать всё сразу. Сначала устанавливайте, что сломалось: запись о проекте, установка Editor, лицензия или содержимое самой игры. Каждому случаю соответствует свой следующий шаг.