Updating for New Versions ——fastest已校订

Verge3D is being actively developed with software releases occuring regularly. There is also the pre-release channel of updates with new versions coming out even more often. We recommend you to keep in pace with the development cycle and timely update your Verge3D distribution and applications.


  • 更新Verge3D安装(Update Verge3D Installation)

  • 更新应用程序 - 方法#1(自动)(Update Applications - Method #1 (Automatic))

  • 更新应用程序 - 方法#2(纯净)(Update Applications - Method #2 (Clean))

  • 更新后(After Update)

  • 已知问题和故障排除(Known Issues and Troubleshooting)

更新Verge3D安装(Update Verge3D Installation)

Backup your current Verge3D folder by renaming it (from "verge3d" to "verge3d_old", for example).


Download and unpack the latest Verge3D bundle in a fresh folder with the same name (that is, "verge3d").


By using the same name for the fresh folder you can avoid re-configuring paths in the 3D editor of your choice.


更新应用程序(Update Applications)

方法#1(自动) - 使用更新功能(Method #1 (Automatic) - use the update feature)

Simply copy the entire folder with your application to the applications folder of the fresh Verge3D installation. After launching the App Manager, your app name should appear in the list of apps (reload the page if not). Click the update button with the round arrow on it.

只需将应用程序的整个文件夹复制到新Verge3D安装的applications文件夹即可。启动App Manager后,您的应用程序名称应显示在应用程序列表中(如果没有,则重新加载页面)。单击带有圆形箭头的更新按钮。

n the window shown up, select the template files you'd like to overwrite. You can safely select everything if you didn't edit the files. If you modified the files, be sure to backup them first so that you can cherry-pick the changes back later, and only after that proceed with overwriting.


Under the hood, this operation overwrites the engine modules by the files from verge3d/build folder, namely, Verge3D runtime v3d.js and optional compatibility modules ie_compat.js (enabled by IE 11 checkbox) and webxr-polyfill.js (enabled by Legacy VR checkbox in the app creation panel). If you choose so, this operation will also overwrite the selected HTML/CSS/JavaScript files and the icons folder media by the files from verge3d/manager/app/Standard folder.

此操作将通过verge3d / build文件夹中的文件覆盖引擎模块,即Verge3D运行时v3d.js和可选兼容模块ie_compat.js(由IE 11启用复选框)和webxr-polyfill.js(由Legacy启用)应用创建面板中的VR复选框。如果选择此操作,此操作还将通过verge3d / manager / app / Standard文件夹中的文件覆盖选定的HTML / CSS / JavaScript文件和图标文件夹媒体。


方法#2(纯净) - 从头开始​​重新创建您的应用程序(Method #2 (Clean) - re-create your app from scratch)

This is an alternative method of updating where you are in full control of your files. You can use it to get rid of obsolete files or if for some reason the automatic update method is not applicable.


To perform clean updating, in the App Manager type the name of your app in the "Create new App" window and click "Create App" button.

要执行纯净更新,请在App Manager中的“创建新应用程序”窗口中键入应用程序的名称,然后单击“创建应用程序”按钮。

Copy .max or .blend files, all the textures/sounds and the Puzzles scenario file visual_logic.xml from your old app folder to the newly created app folder (located within verge3d/applications). Overwrite files when you're asked so. If you were using HTML-based UI in your app, copy all relevant files as well.

.max.blend文件,所有纹理/声音和Puzzles场景文件visual_logic.xml从旧的app文件夹复制到新创建的app文件夹(位于verge3d / applications中)。出现弹窗时,请点击覆盖文件。如果您在应用中使用基于HTML的UI,请同时复制所有相关文件。

Finally, you should perform exporting to glTF so that the exported format receives the latest updates. If you were using Puzzles in your app, you'll need to re-save your scenario in the Puzzles editor so that the generated code matches the newest version of the engine.


If you changed anything in your application's .html, .css or .js files, be sure to backup them first so that you can cherry-pick the changes back later.


更新后(After Update)

还原拼图库(Restore Puzzles library)

If you were adding new entries in the Puzzles library, you can restore it after updating by copying the file verge3d/puzzles/library.xml to the fresh installation folder and overriding the old file.

如果您在Puzzles库中添加新条目,则可以在更新后通过将文件verge3d / puzzles / library.xml复制到全新安装文件夹并覆盖旧文件来还原它。

重新激活您的许可证(Re-activate your license)

You should enter the license key each time you update to a new version, otherwise your apps may render the trial watermark when running.


已知问题和故障排除(Known Issues and Troubleshooting)

On rare occasions the Puzzles button can disappear for your app in the App Manager. Please perform clean updating to fix this.

在极少数情况下,拼图按钮可能会在App Manager中消失。请执行干净更新以解决此问题。

On rare occasions the Puzzles editor may fail to load after updating. Please reset your browser settings to fix this.


If after updating some feature got broken, please report this on the forums so that we can investigate the problem and issue a correcting release.


Last updated