更新Verge3D版本 - Soft8Soft
Description: 了解如何在Verge3D新版本发布后正确地更新自己的应用。

# 版本更新

Verge3D一直处在快速迭代开发中，定期发布新版本。另外还有预览版发行渠道，更新频率更高。我们建议您跟上开发周期，及时更新您的Verge3D安装包和应用。

- 何时更新？
- 在Windows系统中升级Verge3D
- 在macOS系统中升级Verge3D
- 在Linux或ChromeOS系统中升级Verge3D
- 更新应用
  - 方法#1（自动）— 使用更新功能
  - 方法#2（清洁）— 从头重建应用
- 验证Verge3D更新
- 更新3D建模软件
- 已知问题及故障排除

#

## 何时更新？

订阅官方公告论坛或Soft8Soft的社交媒体，以获取Verge3D开发进展和新版本发布的通知。

包含版本信息和社交媒体链接的About窗口。

此外，如果您在应用管理器中注意到ⓘ图标旁边有一个小橙色圆点，这意味着有新的Verge3D稳定版本可供下载。

点击ⓘ图标以显示包含新更新信息的 About Verge3D 对话框：

#

## 在Windows系统中升级Verge3D

只需将最新的Verge3D发行版下载并安装到与旧版本相同的文件夹中（即"C:\Program Files\Verge3D_for_Blender"）。旧版本将被移除，但所有您的应用、设置和授权状态都将保留。

#

## 在macOS系统中升级Verge3D

只需下载并安装最新的Verge3D发行版。旧版本将被移除，但所有您的应用、设置和授权状态都将保留。

#

## 在Linux或ChromeOS系统中升级Verge3D

通过重命名的方式来备份当前的Verge3D文件夹（例如，将"verge3d"重命名为"verge3d_old"）。

下载并解压Verge3D最新版软件包到一个新的同名文件夹中（即"verge3d"）。

通过使用相同的文件夹名称，可以避免在3D编辑器中重新配置路径。

#

## 更新应用

更新Verge3D安装包并不会为现有应用带来新功能，这些应用仍然使用旧版本的Verge3D运行时（名为 v3d.js 的文件）。为了更新应用，还需要执行额外的步骤（见下文）。

#

### 方法#1（自动）— 使用更新功能

完成Verge3D安装包更新后，重新启动应用管理器。您的应用应该出现在列表中，并在 operations 列中显示带有圆形箭头按钮（如果没有，请刷新页面）。点击该按钮开始更新应用。

在弹出的窗口中，选择您要覆盖的模板文件。如果您未编辑这些文件，可以安全地选择所有内容。如果您修改了它们，请务必备份文件以便后续挑选恢复更改，然后再进行覆盖。

在后台，此操作将使用 Verge3D安装路径 的 build 文件夹中的文件覆盖引擎模块，即Verge3D运行时 v3d.js 和可选模块：

- opentype.js — 在创建应用面板中通过 Font Converter 复选框启用。
- basis_transcoder.js, basis_transcorder.wasm — 在创建应用面板中通过 Texture Decompressor 复选框启用。
- ammo.wasm.js, ammo.wasm.wasm — 在创建应用面板中通过 Physics 复选框启用。

如果您选择如此，此操作还将使用 Verge3D安装路径 中的 manager/templates/template_name 文件夹中的文件覆盖选定的HTML/CSS/JavaScript文件和图标文件夹 media。

更新时，应用管理器会将文件的旧版本保存在应用的 v3d_app_data/update_backup 目录中，并添加时间戳。这允许您在需要时恢复应用文件的任何先前保存的修订版本。只需将文件复制回应用文件夹根目录，并从其名称中删除时间戳即可。

最后，您还需要执行glTF的导出，以便导出的格式能够跟进最近的更新。如果您的应用中使用了拼图，您需要在拼图编辑器中重新保存场景，以生成与最新版引擎匹配的代码。

#

### 方法#2（清洁）— 从头重建应用

这是一种替代更新方法，您可以完全掌控文件。您可以用这种方法来删除过时的文件，或者因某些原因自动更新方法不可用时使用。

为执行清洁更新，请在应用管理器的 Create new App 窗口输入应用的名称，然后点击 Create App 按钮。

从旧应用文件夹复制Blender/Max/Maya场景文件、所有贴图/声音和拼图场景文件 visual_logic.xml 到新创建的应用文件夹中（位于您的applications目录中）。当系统提示时选择覆盖。如果您在应用中使用了基于HTML的UI，请同样复制相关文件。

最后，您还需要执行glTF的导出，以便导出的格式能够跟进最近的更新。如果您的应用中使用了拼图，您需要在拼图编辑器中重新保存场景，以生成与最新版引擎匹配的代码。

如果您更改了应用的 .html、.css 或 .js 文件，请务必备份文件，以便后期可以挑选恢复更改。

#

## 验证Verge3D更新

要验证Verge3D安装是否已成功升级，请在应用管理器中打开 About Verge3D 对话框，检查 Version 行：

要验证特定应用是否使用了更新的Verge3D运行时，运行该应用，打开浏览器控制台，然后检查第一行：

确保控制台中打印的版本与 About Verge3D 对话框中显示的版本相对应。

#

## 更新3D建模软件

安装Blender、3ds Max或Maya的新主要版本后，您需要重新安装Verge3D。这样才能正确注册导出器插件、菜单和按钮。请确保Verge3D与该特定版本的建模套件兼容。此外，您必须先运行建模套件至少一次以初始化其系统配置（然后必须关闭该软件）。

此规则的例外是Blender，它允许在首次启动更新版本时从旧版本复制偏好设置：

点击 Import Blender X.Y Preferences，然后确保Verge3D正常运行。

#

## 已知问题及故障排除

在某些情况下，即当维护订阅已过期时更新Verge3D，您需要在每次更新到新版本时重新输入许可证密钥。否则您的应用可能会使用不正确的Verge3D运行时，导致不可预测的结果。

在极少数情况下，应用的"拼图"按钮会在应用管理器中消失。请执行清洁更新以修复此问题。

在极少数情况下，拼图编辑器在更新后可能无法加载。请重置浏览器设置以修复此问题。

如果更新后某些功能出现故障，请在论坛上报告，以便我们调查问题并发布更正版本。

## 遇到问题？

欢迎您随时在 论坛上提问！您还可以加入中文用户社区QQ群(171678760)，在线寻求帮助。