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

Коротко о терминах

• Unity Hub — менеджер установок и проектов для Unity.
• Редактор Unity (Unity Editor) — сама среда разработки, совпадает по версии с инстансом Unity.

Зачем нужен Unity Hub

Unity Hub решает две частые проблемы разработчиков игр:

• хранение нескольких версий Unity в одном месте;
• управление списком проектов и ассоциацией версий к каждому проекту.

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

Важно: смена версии Unity для проекта может потребовать миграции и обновления пакетов. Делайте резервную копию проекта перед обновлением.

Как установить Unity Hub

Вы можете скачать Unity Hub с официального сайта Unity.

1. Перейдите на страницу загрузки Unity.
2. Нажмите «Download Unity Hub» на официальной странице.

3. Запустите загруженный установщик (Windows — .exe, macOS — .dmg).
4. Следуйте шагам мастера установки. На Windows нажмите «Install», чтобы продолжить.

5. Откройте Unity Hub и авторизуйтесь через ваш аккаунт Unity или создайте новый.

Советы по установке:

• На Windows используйте менеджер закачек только при необходимости. Обычно достаточно обычного инсталлятора.
• На macOS проверьте разрешения в System Preferences, если установка блокируется.

Как установить несколько версий Unity

1. Откройте вкладку Установки (Installs) в Unity Hub.

2. Нажмите «Установить редактор» (Install Editor).

3. Выберите нужную версию и нажмите «Install».
4. Отметьте дополнительные модули: WebGL Build Support, Mac/Windows Build Support, Android/iOS и др. Нажмите «Continue».

5. Согласитесь с условиями и начните установку. Прогресс отображается во вкладке «Загрузки» (Downloads).

6. Повторите для других версий по необходимости.

7. После завершения установки версии отображаются во вкладке «Установки».

Советы по выбору версий:

• Используйте LTS‑ветку (Long Term Support) для проектов, требующих стабильности.
• Для тестирования новых функций ставьте техверсии (Tech Stream) на отдельный ПК или копию проекта.

Как открыть проект в другой версии Unity

1. Перейдите на вкладку Проекты (Projects).

2. Для каждого проекта рядом с названием указана текущая версия редактора.
3. Нажмите на номер версии, чтобы выбрать другую установленную версию.

4. Unity Hub предложит открыть проект в выбранной версии. При первом открытии Unity может выполнить процесс обновления проекта и пакетов.

Рекомендации перед сменой версии:

• Создайте резервную копию проекта или используйте систему контроля версий (Git, Perforce).
• Запишите список установленных пакетов (Package Manager). Некоторые пакеты могут требовать обновления вручную.

Организация проектов в Unity Hub

Unity Hub помогает держать проекты в порядке и быстро находить их в списке. Рекомендации по организации:

• Держите проекты в отдельной папке по типу/движку: /Projects/Prototypes, /Projects/Release.
• В описании проекта укажите требуемую версию Unity и платформы сборки.
• Используйте контроль версий и CI для сборок.

Важно: Unity Hub хранит только ссылки на папки проектов. Перемещение проекта в файловой системе потребует обновления пути в Hub.

Методология безопасного обновления версии проекта (мини‑метод)

1. Создайте ветку в системе контроля версий (например, feature/upgrade-unity-202X).
2. Сделайте полный бэкап и отметьте коммит до обновления.
3. Обновите Unity в отдельной копии проекта.
4. Прогони юнит‑тесты и автоматические сборки; проверьте ключевые сцены.
5. Ручное тестирование: игровые механики, сохранения, плагины.
6. Закоммитьте изменения и смержьте после проверки.

Чек‑лист миграции версии Unity

• Резервная копия проекта (zip/архив).
• Коммит в VCS до миграции.
• Список версий пакетов из Package Manager.
• Тестовые сборки для целевых платформ выполнены.
• Нет критических ошибок в консоли после открытия.
• Проверены сцены с основными механиками и сохранениями.

Критерии приёмки

• Проект успешно открывается в новой версии без ошибок сборки.
• Автоматические тесты не падают.
• Основные игровые сценарии проходят ручную проверку.
• CI-сборка проходит для целевых платформ.

Роли и обязанности при управлении версиями (короткие чек‑листы)

• Разработчик:
  • Убедиться в работоспособности сцен и логики после обновления.
  • Обновить notes и changelog.
• Тестировщик:
  • Прогнать регрессионные тесты и проверку производительности.
• Тимлид/Релиз‑менеджер:
  • Утвердить миграцию и контроль релизной ветки.

Когда Unity Hub не подходит

• Если нужно управлять сотнями инсталляций на CI‑сервере — имеет смысл использовать автоматизированные скрипты установки Unity (CLI) и конфигурацию в инфраструктуре.
• Если проект критичен к стабильности, стоит проводить обновления только на выделенных средах.

Альтернативные подходы

• Управление версиями Unity через пакетный менеджер командной строки (Unity Installer CLI).
• Создание контейнеризованных CI‑агентов с нужной версией Unity для изоляции сборок.

Decision tree для обновления версии проекта

flowchart TD
  A[Новая версия Unity доступна?] -->|Нет| B[Оставить текущую версию]
  A -->|Да| C{Проект в активной разработке?}
  C -->|Да| D[Создать копию проекта и ветку]
  C -->|Нет| E[Отложить обновление до релиза]
  D --> F{Падение тестов?}
  F -->|Да| G[Откат и анализ проблем]
  F -->|Нет| H[Слияние и релиз]

Примеры ошибок и когда они возникают

• Конфликты API после обновления — возникают при смене мажорной версии движка.
• Неподдерживаемые плагины — встречаются у сторонних SDK и нативных плагинов.
• Различия в поведении рендеринга — возможны при смене рендер‑пайпа (Built‑in → URP/HDRP).

Совет: для крупных изменений создавайте экспериментальные ветки и проводите стресс‑тесты.

Безопасность и конфиденциальность

Unity Hub использует аккаунт Unity для входа. Убедитесь, что доступ к аккаунту защищён двухфакторной аутентификацией, особенно в командах.

Краткая сводка

• Unity Hub упрощает управление версиями и проектами Unity.
• Перед сменой версии делайте бэкапы и проверяйте пакеты.
• Для стабильных проектов используйте LTS‑версии Unity.

Дополнительные действия: поддерживайте документацию проекта с указанием требуемой версии Unity в README и настройках CI.

Источники и полезные ссылки

• Официальная документация Unity: страницы загрузки и Unity Hub.