升级指南

本节介绍如何从旧版本升级。

关于升级到 2022，请查看升级到 2022。

从 realvirtual.io 2022 升级到 realvirtual.io 6

本指南将引导您完成将项目从 realvirtual.io 2022 升级到 realvirtual.io 6 的过程。

⚠️

重要提示：两步升级流程

升级必须分两个独立步骤完成：

1. 首先： 将您现有项目（包括旧 realvirtual 版本）升级到 Unity 6 并验证其正常工作

2. 其次： 项目在 Unity 6 中成功运行后，再升级 realvirtual 框架本身

不要尝试同时升级 Unity和 realvirtual。每个步骤必须完成并在继续下一步之前验证通过。

步骤 1：准备您的 Unity环境

确保 Unity 6 已安装： 使用 Unity Package Manager 安装最新的 Unity 6 版本。
在 Unity Hub 中选择项目： 打开 Unity Hub，选择您现有项目，将 Editor Version 更改为最新版本（6000.X）。
确认版本更改： 将出现一个关于版本更改的警告。选择 Change Version 继续。

步骤 2：打开并更新您的项目

打开项目： Unity将使用 Unity 6 打开您的项目。
接受兼容性警告：
- 继续警告： 通过选择 Continue 接受下一个警告。
- 旧 API警告： 您可能会收到一条关于脚本使用旧 API的消息。确认此消息并继续。当您导入 realvirtual.io 6 时，这些脚本将被更新。
项目外观： 您的项目将在 Unity 6 中打开，由于渲染管线更改，最初可能看起来不同。

步骤 3：将材质更新为 URP（Universal Render Pipeline）

将材质转换为 URP（Universal Render Pipeline）： 转到 Tools > realvirtual > RenderPipelines > Switch to Universal Render Pipeline (URP)。此操作将转换项目中的所有材质，使其与 URP（Universal Render Pipeline）兼容。

⚠️

重要提示： 在导入 realvirtual.io 6 包之前将材质更新为 URP（Universal Render Pipeline），以确保正确渲染并避免材质冲突。

步骤 4：导入 realvirtual.io 6 包

导入自定义包： 转到 Assets > Import Custom Package 并选择最新的 realvirtual.io 6 包。
预期编译错误： 导入后，您可能会在 Unity控制台中看到编译错误。这在升级过程中是正常的。
关闭 Unity： 完全关闭 Unity Editor。
清理项目缓存：
- 删除项目目录中的 Library 文件夹
- 删除 Assets/realvirtual 文件夹（旧版本）
- 重新打开项目： 在 Unity 6 中再次打开您的项目。这将使用更新的设置重新生成 Library 文件夹。
- 再次导入包： 通过 Assets > Import Custom Package 再次导入 realvirtual.io 6 包。
- 验证导入： 第二次导入后，编译错误应已解决，新的 realvirtual.io 6 框架将正确集成。

ℹ️

为什么要删除 Library 和 realvirtual 文件夹？

* Library 文件夹： 确保所有缓存的元数据和程序集定义为 Unity 6 兼容性重新生成

* realvirtual 文件夹： 移除第一次导入后残留的旧脚本，防止新旧框架版本之间的冲突

不用担心——场景和预制体中的所有引用将在此过程中保留。Unity通过 GUID（Globally Unique Identifier）自动维护这些引用，即使文件夹被删除并重新导入。

按照以上步骤操作后，您的项目应已完全升级到 realvirtual.io 6 并具有 URP（Universal Render Pipeline）兼容性，恢复正确的材质和场景外观。