Skip to main content

更新 SDK

如果需要更新 SDK,请务必按照以下步骤操作,以确保更新顺利进行,并且不会遗留旧的/冲突的文件。

版本控制​

如果你知道如何使用版本控制,建议使用像 Git 这样的版本控制软件来管理你的项目。你不需要将仓库上传到 Github 或类似服务也能享受版本控制的好处。在升级 SDK 之前创建一个提交,以确保安全。

VRChat Creator Companion​

使用 VCC 保持 SDK 最新非常容易。请参阅 VRChat Creator Companion 文档了解如何使用!

迁移到 VCC​

如果你想了解如何将项目迁移到 VCC,请查看此指南。

手动更新​

如果你使用 VCC,则无需担心手动更新。 但如果需要,你可以登录 VRChat 账号后在 VRChat 网站下载 SDK。

旧版 SDK3​

caution

以下说明仅适用于使用旧版 SDK(Assets\VRCSDK)的用户。 如果你的 SDK 在 Packages 文件夹中(Packages\com.vrchat.base),请勿执行以下操作。

对于 SDK3,你应该可以通过直接将新版 SDK 导入旧版 SDK 上来完成更新,这也称为原地升级。 这对于 SDK3 - 虚拟形象尤其重要,因为如果更新不正确,你可能会丢失动画控制器上的状态行为!

如果你想格外小心,请始终在更新 SDK 之前备份项目。

SDK3 - 世界​

  1. 关闭 Unity。
  2. 备份你的 Unity 项目!不需要备份 Library 文件夹,这些文件由 Unity 自动生成。
2020.3.2 之前的 SDK3 升级

这是一个非常用步骤,你可能不需要执行。

如果你要从 2020.3.2 之前的 SDK 升级,请进入项目的 Assets 文件夹,删除 VRCSDK 和 Udon 文件夹以及 VRCSDK.meta 和 Udon.meta 文件。

  1. 打开你的 Unity 项目。
  2. 将新的 SDK3 - 世界导入到旧的之上。

SDK3 - 虚拟形象​

不要对 SDK3 - 虚拟形象执行"删除重装"操作!

如果你在关闭 Unity 后删除 SDK 文件夹,然后在没有安装 SDK 的情况下打开 Unity,你将丢失状态行为。 它们很脆弱,无法在完整的删除升级中持久保留。请确保经常备份项目,并保存/记录你的状态行为设置。

如果你必须对 SDK3 - 虚拟形象包执行完整的删除重装,请先备份项目。你将不得不重新设置状态行为,请确保已做好记录。

  1. 关闭 Unity。
  2. 备份你的 Unity 项目!不需要备份 Library 文件夹,这些文件由 Unity 自动生成。
  3. 打开你的 Unity 项目。
  4. 将新的 SDK3 - 虚拟形象导入到旧的之上。如果导入完成后出现错误,请尝试重新启动 Unity。
SDK3 在虚拟形象动态升级时的预期错误

当你首次将 SDK3 - 虚拟形象升级到 Avatar Dynamics SDK 时,出现一些错误是正常的。这是因为 SDK 在安装过程中会安装 Burst 和 Mathematics 包,而 Unity 在导入它们时可能有些急于求成。

如果清除错误或重新启动 Unity,这些错误应该会消失。

SDK3 - 虚拟形象 - 单独项目流程​

如果通过上述流程升级时遇到问题,请尝试以下方法:

  1. 关闭 Unity。
  2. 创建一个新的空白项目。
  3. 将新的 SDK3 - 虚拟形象包导入到该项目中。
  4. 关闭该 Unity 项目。
  5. 使用资源管理器(此时不要打开 Unity!),从你要升级的项目中删除 VRCSDK3 文件夹。在本指南另有说明之前,不要打开 Unity。
  6. 将你要升级的项目中 Packages/vpm-manifest.json 中对 VRChat SDK3 的引用编辑为新 SDK 版本。
  7. 从你导入 SDK 的新空白项目中,将 VRCSDK3 文件夹复制到你要升级的项目中。
  8. 复制文件后,打开 Unity 并打开升级后的项目。你可以删除空白项目。

高级更新流程​

如果你要在包含复杂触发器设置的世界项目中重新安装 SDK,这里有一种更安全的更新方法。

  1. 关闭 Unity
  2. 将项目备份到另一个文件夹(不要备份 Library 文件夹,这些文件由 Unity 自动生成)
  3. 删除 SDK 和 Plugins 文件夹,以及相关的 .META 文件
  4. 将要升级的项目中 Packages/vpm-manifest.json 中对 VRChat SDK3 的引用编辑为新 SDK 版本
  5. 使用 Unity Hub 创建一个空白的 Unity 项目
  6. 在空白项目上安装最新的 VRChat SDK
  7. 将新添加的 SDK/Plugin 文件夹及相关 .meta 文件从空白项目复制到你的原始项目中
  8. 完成。现在你可以打开升级后的项目了

更新 Unity​

如果你要从旧版本的 Unity 更新,我们有一份指南教你如何升级到我们支持的最新版本!