更新 SDK
如果需要更新 SDK,请务必按照以下步骤操作,以确保更新顺利进行,并且不会遗留旧的/冲突的文件。
版本控制
如果你知道如何使用版本控制,建议使用像 Git 这样的版本控制软件来管理你的项目。你不需要将仓库上传到 Github 或类似服务也能享受版本控制的好处。在升级 SDK 之前创建一个提交,以确保安全。
VRChat Creator Companion
使用 VCC 保持 SDK 最新非常容易。请参阅 VRChat Creator Companion 文档了解如何使用!
迁移到 VCC
如果你想了解如何将项目迁移到 VCC,请查看此指南。
手动更新
如果你使用 VCC,则无需担心手动更新。 但如果需要,你可以登录 VRChat 账号后在 VRChat 网站下载 SDK。
旧版 SDK3
以下说明仅适用于使用旧版 SDK(Assets\VRCSDK)的用户。
如果你的 SDK 在 Packages 文件夹中(Packages\com.vrchat.base),请勿执行以下操作。
对于 SDK3,你应该可以通过直接将新版 SDK 导入旧版 SDK 上来完成更新,这也称为原地升级。 这对于 SDK3 - 虚拟形象尤其重要,因为如果更新不正确,你可能会丢失动画控制器上的状态行为!
如果你想格外小心,请始终在更新 SDK 之前备份项目。
SDK3 - 世界
- 关闭 Unity。
- 备份你的 Unity 项目!不需要备份 Library 文件夹,这些文件由 Unity 自动生成。
这是一个非常用步骤,你可能不需要执行。
如果你要从 2020.3.2 之前的 SDK 升级,请进入项目的 Assets 文件夹,删除 VRCSDK 和 Udon 文件夹以及 VRCSDK.meta 和 Udon.meta 文件。
- 打开你的 Unity 项目。
- 将新的 SDK3 - 世界导入到旧的之上。
SDK3 - 虚拟形象
如果你在关闭 Unity 后删除 SDK 文件夹,然后在没有安装 SDK 的情况下打开 Unity,你将丢失状态行为。 它们很脆弱,无法在完整的删除升级中持久保留。请确保经常备份项目,并保存/记录你的状态行为设置。
如果你必须对 SDK3 - 虚拟形象包执行完整的删除重装,请先备份项目。你将不得不重新设置状态行为,请确保已做好记录。
- 关闭 Unity。
- 备份你的 Unity 项目!不需要备份 Library 文件夹,这些文件由 Unity 自动生成。
- 打开你的 Unity 项目。
- 将新的 SDK3 - 虚拟形象导入到旧的之上。如果导入完成后出现错误,请尝试重新启动 Unity。
当你首次将 SDK3 - 虚拟形象升级到 Avatar Dynamics SDK 时,出现一些错误是正常的。这是因为 SDK 在安装过程中会安装 Burst 和 Mathematics 包,而 Unity 在导入它们时可能有些急于求成。
如果清除错误或重新启动 Unity,这些错误应该会消失。
SDK3 - 虚拟形象 - 单独项目流程
如果通过上述流程升级时遇到问题,请尝试以下方法:
- 关闭 Unity。
- 创建一个新的空白项目。
- 将新的 SDK3 - 虚拟形象包导入到该项目中。
- 关闭该 Unity 项目。
- 使用资源管理器(此时不要打开 Unity!),从你要升级的项目中删除 VRCSDK3 文件夹。在本指南另有说明之前,不要打开 Unity。
- 将你要升级的项目中
Packages/vpm-manifest.json中对 VRChat SDK3 的引用编辑为新 SDK 版本。 - 从你导入 SDK 的新空白项目中,将 VRCSDK3 文件夹复制到你要升级的项目中。
- 复制文件后,打开 Unity 并打开升级后的项目。你可以删除空白项目。
高级更新流程
如果你要在包含复杂触发器设置的世界项目中重新安装 SDK,这里有一种更安全的更新方法。
- 关闭 Unity
- 将项目备份到另一个文件夹(不要备份 Library 文件夹,这些文件由 Unity 自动生成)
- 删除 SDK 和 Plugins 文件夹,以及相关的 .META 文件
- 将要升级的项目中
Packages/vpm-manifest.json中对 VRChat SDK3 的引用编辑为新 SDK 版本 - 使用 Unity Hub 创建一个空白的 Unity 项目
- 在空白项目上安装最新的 VRChat SDK
- 将新添加的
SDK/Plugin文件夹及相关.meta文件从空白项目复制到你的原始项目中 - 完成。现在你可以打开升级后的项目了
更新 Unity
如果你要从旧版本的 Unity 更新,我们有一份指南教你如何升级到我们支持的最新版本!