Version: 6000.3
语言: 中文
升级 Unity
API 更新程序

升级 Unity 项目

升级项目后,您可以访问较新版本的 Unity 编辑器中引入的最新功能、改进和错误修复。

本页详细介绍了一些升级项目的推荐最佳实践。但是,如何将这些实践应用于项目取决于项目的情况。升级项目的体验可能会因多种因素而有很大差异,例如:

  • 您要升级到的版本。
  • 项目的复杂性和规模。
  • 您在项目中使用的包和资产。

建议的最佳做法是按顺序将项目从一个主要版本升级到下一个主要版本。例如,如果您要从 2020 LTS 升级到 2022,则应先升级到 2021 LTS,然后再升级到 2022 LTS。如果您将项目从旧版本直接升级到较新版本,则与按顺序升级项目相比,您可能会遇到更多问题。

要将 Unity 项目升级到较新版本的 Unity 编辑器,请执行以下作:

  1. 确定是否应该升级
  2. 备份您的项目
  3. 为升级准备项目
  4. 在 Hub 中安装新版本的 Unity 编辑器
  5. 在新版本的 Unity 编辑器中打开项目
  6. 解决兼容性问题并调整项目以进行更改
  7. 测试您的项目

确定是否应该升级

在升级项目之前,请确保升级的优势超过针对特定情况进行升级所需的工作量。附加了多个第三方资产和包的大型复杂项目可能需要很长时间才能升级,并且需要进行重大更改。

如果您的项目使用许多第三方包和资源,请参阅其文档以检查它们是否与您要升级到的 Unity 编辑器版本兼容。如果它们与您的目标版本的 Unity 编辑器不兼容,您可能需要寻找替代解决方案或自行更新资源。考虑联系资源发布者寻求支持。

有关升级的帮助,请参阅:

  • Unity 中的新增功能文档,了解要升级到的 Unity 编辑器版本中引入的新功能和改进。
  • 要升级到的版本的升级指南。升级指南列出了从以前的版本升级现有项目时可能会影响现有项目的版本更改。请参阅升级指南,了解其描述的版本中引入的中断性和行为更改。
  • 发行说明,了解要升级到的版本中更详尽的更改列表。
  • 的文档包包是在 Unity 中共享和重复使用的资产集合。Unity 包管理器 (UPM) 可以在项目中显示、添加和删除包。这些包是 Unity 包管理器的原生包,并提供了提供 Unity 功能的基本方法。但是,Unity 包管理器还可以显示您从 Asset Store 下载的 Asset Store 包更多信息
    请参阅术语表
    您在项目中使用的。检查项目中的包和资源是否与您要升级到的 Unity 编辑器版本兼容。要查找包的文档,请参阅查找包文档
  • Unity 博客上发布帖子,了解有关新功能和改进的更多信息。

备份您的项目

在更新项目之前,备份项目文件至关重要。备份可确保在升级过程中遇到任何问题时可以恢复到项目的先前版本。您还可以使用备份将升级项目的性能与以前的版本进行比较。备份项目的推荐最佳实践是使用版本控制用于管理文件更改的系统。您可以将 Unity 与最常见的版本控制工具结合使用,包括 Perforce、Git、Mercurial 和 PlasticSCM。更多信息
请参阅术语表
.

如果您没有使用版本控制,您可以通过将项目文件夹复制到计算机上的其他位置或外部驱动器来手动备份项目。在大多数情况下,使用版本控制系统比手动备份项目文件更好。

【提示】如果要手动备份项目,则可以排除一些自动生成的文件夹,如“资源库”文件夹,以节省磁盘空间。当您在 Unity 编辑器中打开项目时,将重新生成 Library 文件夹。

为升级准备项目

要准备项目升级,请执行以下作:

  • 将项目中的现有包和资产升级到其最新版本。这使您有机会在较新版本的 Unity 编辑器中打开项目之前,以更易于管理的方式识别和修复错误。
  • 检查您的项目,了解要升级到的 Unity 编辑器版本中已弃用的任何功能或 API。制定更新或更换它们的计划。
  • 检查目标构建平台,并确保要升级到的 Unity 编辑器版本仍然支持它们。

安装新版本的 Unity 编辑器

使用 Hub 是安装 Unity 编辑器、创建项目和管理 Unity 体验的推荐最佳实践。中心提供了一个集中位置来管理编辑器安装、帐户、许可证和项目。要在 Hub 中安装最新版本的 Unity 编辑器,请参阅安装和卸载编辑器版本

确保安装的模块与要升级的项目中使用的模块相同。

要了解安装 Unity 编辑器的其他方法,请参阅安装 Unity

要手动安装特定版本的 Unity 编辑器,您还可以参考 Unity 下载存档

在新版本的 Unity 编辑器中打开项目

要在新版本的 Unity 编辑器中打开您的项目,请执行以下作:

  1. 打开 Unity Hub。
  2. 选择“项目”选项卡。
  3. 在要升级的项目行中,选择 编辑器版本(Editor Version) 以打开 安装(Installs) 窗口。安装窗口显示已安装的所有 Unity 编辑器版本。
  4. “安装”窗口中:
    1. 选择要用于打开项目的编辑器版本。
    2. 如果要更改项目构建的平台,请在与编辑器版本相同的行中选择一个可用平台。默认情况下,当前平台处于选中状态。
    3. 选择“打开方式...”按钮。
  5. “更改编辑器版本?”窗口中,选择“更改版本”。
  6. 在 在不匹配编辑器安装中打开项目(Opening Project in Non-Matching Editor Installation) 窗口中,选择 继续(Continue)。
  7. 如果项目包含编译错误,则会显示“进入安全模式?”窗口。如果是,请选择进入安全模式。安全模式提供了解决错误的最佳环境,而无需等待项目的其余部分导入。要了解更多信息,请参阅安全模式

提示:您还可以在“安装”窗口中选择“安装其他编辑器版本”,以安装不同版本的 Unity 编辑器。

解决兼容性问题并调整项目以进行更改

当您将项目升级到新版本的 Unity 编辑器时,您可能会遇到新版本中引入的兼容性问题和弃用。

提示:如果您遇到发布文档中未涵盖的问题,您可以在 Unity 讨论中向更广泛的 Unity 社区寻求帮助。

若要解决兼容性问题,请在安全模式下打开项目,然后执行以下作:

  • 查看“控制台”窗口中是否有任何错误或警告。解决发现的任何错误,并根据弃用通知采取行动。
  • 您的项目可能包含可能导致错误的不兼容包版本。打开包管理器并更新资产包来自 Unity 项目或项目元素的文件和数据的集合,这些文件和数据被压缩并存储在一个文件中,类似于 Zip 文件,使用.unitypackage外延。资产包是共享和重用 Unity 项目和资产集合的便捷方式。更多信息
    请参阅术语表
    到他们的最新版本。
  • 测试生成兼容性。如果您面向特定平台(例如 iOS、Android 或 Web),请确保项目在这些平台上正确构建和运行。

测试您的项目

测试您的项目以确保它在新版本的 Unity 编辑器中按预期工作:

  • 运行您的游戏并测试其所有功能。
  • 使用原始编辑器版本中的备份项目来比较不同版本的项目性能。有关更多信息,请参阅 Unity Profiler
  • 专门测试游戏中可能受到发布文档中描述的更改影响的任何功能,例如 Unity 中的新增功能指南升级指南以及要升级到的版本的发行说明
  • 格外注意定制脚本一段代码,允许您创建自己的组件、触发游戏事件、随时间修改组件属性以及以您喜欢的任何方式响应用户输入。更多信息
    请参阅术语表
    ,着色器在 GPU 上运行的程序。更多信息
    请参阅术语表
    或第三方资产以及它们在您的项目中的运作方式。它们可能需要更新以实现兼容性。
  • 检查并升级过时的软件包。较旧的软件包版本可能会导致较新的编辑器版本出现性能问题。

其他资源

升级 Unity
API 更新程序