← Руководство

Обновите ваш проект Unity

Обновление вашего проекта дает вам доступ к последним функциям, улучшениям и исправлениям ошибок, представленным в новой версии Unity Editor.

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

Версия, которую вы обновляете к и от.
Сложность и размер вашего проекта.
Пакеты и ресурсы, которые вы используете в своем проекте.

Например, если вы обновляете с 2020 LTS на 2022, вам следует сначала обновить до 2021 LTS, а затем до 2022 LTS.. Если вы обновляете свой проект с гораздо более старой версии прямо к более новой версии, вы можете столкнуться с большей проблемой, чем при последовательном обновлении проекта.

Чтобы обновить ваш проект Unity до более новой версии Unity Editor:

Определить, следует ли обновить
Резервное копирование проекта
Подготовка проекта к обновлению
Установка новой версии Unity Editor
Откройте свой проект в новой версии Unity Editor
Решение проблем совместимости и настройка проекта для изменений
Проверьте свой проект

Определение необходимости обновления

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

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

Для получения помощи с обновлением см.:

Документация Что нового в Unity, чтобы узнать о новых функциях и улучшениях, введенных в версию Unity Editor, которую вы обновляете.
Руководство по обновлению для версии, до которой выполняется обновление. В руководствах по обновлению перечислены изменения соответствующей версии, способные повлиять на существующие проекты при обновлении с предыдущей версии. Сведения о нарушающих совместимость и поведенческих изменениях в описываемой версии см. в руководстве по обновлению.
Заметки о выпуске Замечания о выпуске для более полного списка изменений в версии, на которую вы обновляетесь.
Документация для сессии пакеты Проверьте, совместимы ли пакеты и ассеты в вашем проекте с версией Unity Editor, на которую вы обновляетесь. Чтобы найти документацию для пакета, обратитесь к Поиск документации пакета.
Чтобы узнать больше о новых функциях и улучшениях, читайте статьи о выпуске в блоге Unity.

Резервное копирование проекта

Перед обновлением проекта крайне важно создать резервную копию файлов проекта. Резервная копия обеспечивает возможность возврата к предыдущей версии проекта в случае возникновения каких-либо проблем во время процесса обновления. Вы также можете использовать резервную копию для сравнения производительности обновленного проекта с предыдущей версией. Рекомендуемая наилучшая практика для резервного копирования проекта — это использование управления версиями.

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

Совет: Если вы резервируете свой проект вручную, вы можете исключить некоторые автоматически созданные папки, такие как папка Библиотека, чтобы сэкономить место на диске. Папка Библиотека восстанавливается, когда вы открываете проект в Unity Editor.

Подготовка проекта к обновлению

Чтобы подготовить проект к обновлению:

Обновите существующие пакеты и ассеты в вашем проекте до их последних версий. Это дает вам возможность идентифицировать и исправить ошибки более управляемым образом, прежде чем открывать ваш проект в более новой версии Unity Editor.
Проверьте свой проект на наличие каких-либо функций или APIs, которые были устаревшими в версии Unity Editor, на которую вы обновляетесь. Составьте план обновления или замены этих функций.
Проверьте платформы целевой сборки и убедитесь, что они по-прежнему поддерживаются в версии Unity Editor, на которую вы обновляетесь.

Установка новой версии Unity Editor

Для установки Unity Editor, создания проектов и управления Unity рекомендуется использовать центр Hub. Центр предоставляет централизованное место для управления установками Editor, учетными записями, лицензиями и проектами. Чтобы установить новейшую версию Unity Editor в центре, см. Установка и удаление версий Editor.

Убедитесь, что вы установили те же модули, которые использовались в проекте, который вы обновляете.

Чтобы узнать о других способах установки Unity Editor, см. Установка Unity.

Чтобы вручную установить конкретную версию Unity Editor, вы также можете обратиться к Unity Скачать Архив.

Откройте свой проект в новой версии Unity Editor

Чтобы открыть свой проект в новой версии Unity Editor:

Откройте Unity Hub.
Выберите вкладку Проекты.
В строке проекта, который вы хотите обновить, выберите Editor Version, чтобы открыть окно Установки. В окне Установки отображаются все установленные версии Unity Editor.
В течение Установки окно:
1. Выберите версию редактора, которую вы хотите использовать для открытия проекта.
2. Если вы хотите изменить платформу, для которой создан проект, выберите одну из доступных платформ в той же строке, что и версия Редактора. По умолчанию выбрана текущая платформа Текущая платформа.
3. Выберите кнопку Открыть с….
В течение Изменить версию редактора? окно, выбрать Изменить версию.
В окне Открытие Project в Установка несоответствующего редактора выберите Продолжить.
Если проект содержит ошибки компиляции, отображается окно Перейти в безопасный режим?. Если это окно отображается, выберите Перейти в безопасный режим. Безопасный режим обеспечивает наилучшую среду для устранения ошибок без ожидания импортирования остального проекта. Дополнительные сведения см. в Безопасный режим.

Тип: Вы также можете выбрать Установка другой версии редактора в 2000 году Установки окно для установки другой версии Unity Editor.

Решение проблем совместимости и корректировка проекта для изменений

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

Тип: Если вы столкнулись с проблемой, которая не охватывается документацией выпуска, вы можете попросить помощи у более широкого сообщества Unity сообщества на Unity Обсуждения.

Для решения проблем совместимости откройте проект в Безопасный режим, и выполните следующие действия:

Рассмотрение Консоль окно для любых ошибок или предупреждений. Разрешите любые ошибки, которые вы обнаружите, и действуйте по уведомлениям об устаревании.
Ваш проект может содержать несовместимые версии пакетов, которые могут вызывать ошибки. Package Manager и обновление пакеты и пакеты активов к их последним версиям.
Проверьте совместимость сборки. Если вы работаете с конкретными платформами, такими как iOS, Android или Web, убедитесь, что проект правильно собирается и запускается на этих платформах.

Проверьте свой проект

Проверьте свой проект, чтобы убедиться, что он работает как ожидалось в новой версии Unity Editor:

Запустите игру и проверьте все ее возможности.
Используйте резервную копию проекта в оригинальной версии Редактора для сравнения производительности проекта между версиями. Дополнительные сведения см. в Unity Profiler.
Обязательно протестируйте все функции игры, на которые могут повлиять изменения, описанные в документации выпуска: руководстве «Что нового в Unity», руководстве по обновлению и примечаниях к выпуску для версии, до которой выполняется обновление.
Обратите особое внимание на пользовательские скрипты, шейдеры или сторонние ресурсы и их функционирование в вашем проекте. Они могут требовать обновления для совместимости.
Проверка и обновление устаревших пакетов. Старые версии пакетов могут вызывать проблемы с производительностью в более новых версиях Редактора.