虚幻引擎5文档已被迁移至 Epic开发者社区

虚幻引擎新版本发布后，你需要选择是将当前项目升级到新版本引擎，还是继续使用当前引擎版本，以保持项目功能不变。

虽然UE4无法完全消除与转换项目相关的工作，但可以提供一些帮助。UE4提供基于UI的项目更新功能，能够完整更新一个简单项目，还可以在更新更复杂项目时提供一个有利开端。

转换简单项目

如果要转换没有复杂代码或蓝图的简单项目，请按照以下步骤操作：

1. 启动项目要转换到的UE4版本，然后找到你的项目；你会注意到，如果项目版本与当前版本不同，将会列出每个项目的UE4版本。

2. 选择项目并打开。你将收到警告消息，提示项目是使用其他版本创建的。默认情况下，UE4将会创建项目的副本并对副本进行转换，以防原文件数据损坏。

   你可以利用 更多选项（More Options） 选择打开原始项目并进行转换，或者跳过项目转换，仅按其原样打开，但是这两种方法均不推荐使用。

   当你把项目升级到新的虚幻引擎版本后，就无法在旧版本中打开它了。尝试此操作将会失败。

3. 只要点击 打开副本（Open a copy） （或 就地转换（Convert in-place ）），UE4都将尝试用更新版本的引擎自动为你的项目文件生成代码。

4. 如果UE4成功完成自动转换流程，你的项目将在编辑器中打开。

转换复杂项目

转换复杂项目的过程类似于转换简单项目，不同之处在于UE4不太可能为项目生成完整代码，尤其是在使用了自定义C++代码或蓝图时。在这种情况下，将仅执行部分转换。你需要在Visual Studio中手动完成剩余的转换。

转换复杂项目，请按照以下步骤操作：

1. 与简单项目转换相同，开始都是先找到你的项目。本例中我们使用已废弃的 PlatformerGame 示例项目。

2. 按照上述简单项目转换过程中的步骤2-3进行操作。

3. 复杂项目的代码生成流程通常都会失败，并生成一个错误消息窗口，其中包含的详细信息将会说明转换流程的哪些部分遇到了问题。

   点击查看大图。

4. 你现在可以选择在Visual Studio中打开项目，以便手动更正那些阻止自动转换完成的问题，具体操作视项目具体情况而定。。