Обновление SDK до новой версии

Verge3D активно развивается и мы регулярно публикуем релизы с новыми функциями. Также выкладываются пре-релизы. Мы рекомендуем вам своевременно обновлять дистрибутив Verge3D и приложения.

Обновление Verge3D

Сделайте резервную копию текущей папки Verge3D, переименовав ее, например, с «verge3d» на «verge3d_old».

Загрузите и распакуйте свежий дистрибутив Verge3D в новую папку с тем же именем (то есть «verge3d»).

Используя одно и тоже название папки, вы можете избежать повторной настройки путей в выбранном 3D-редакторе.

Обновление приложений

Способ №1 (автоматический) - использование функции обновления

Просто скопируйте всю папку с приложением в папку applications новой установки Verge3D. После запуска менеджера приложений имя вашего проекта должно появиться в списке приложений (если нет, то перезагрузите страницу). Нажмите кнопку обновления с изображением круглой стрелки.

В появившемся окне выберите файлы шаблонов, которые вы хотите перезаписать. Вы можете смело выбирать все, если не редактировали файлы. Если вы изменили файлы, обязательно сначала сделайте их резервную копию, чтобы потом можно было восстановить изменения, и только после этого приступайте к перезаписи.

Эта операция перезаписывает модули движка файлами из папки /build , а именно: среду выполнения Verge3D v3d.js , дополнительные модули совместимости ie_compat.js (активируется флажком IE 11) и webxr-polyfill.js (активируется флажком *Legacy VR * на панели создания приложения). Если вы выберете этот вариант, то также перезапишутся файлы HTML/CSS/JavaScript и иконки папки media (файлами из директории /manager/templates/template_name) .

После обновления менеджер приложений сохранит старые версии ваших файлов в каталоге проекта v3d_app_data/update_backup с добавленной отметкой времени. Это позволяет вам восстанавливать любую из ранее сохраненных версий файлов вашего приложения, когда они вам нужны. Просто скопируйте файл обратно в корень папки приложения и удалите отметку времени из его имени.

Способ №2 (чистый) - воссоздание приложения с нуля

Это альтернативный метод обновления, при котором вы полностью контролируете свои файлы. Вы можете использовать его, чтобы избавиться от устаревших файлов или когда метод автоматического обновления не применим.

Чтобы выполнить чистое обновление, в менеджере приложений введите имя вашего проекта в окне «Create new App» и нажмите кнопку «Create App».

Скопируйте файлы .max или .blend , все текстуры/звуки и файл сценария пазлов visual_logic.xml из старой папки приложения в новую (созданная папка приложения находится в verge3d/applications ). Перезапишите файлы, когда вас об этом попросят. Если вы использовали пользовательский интерфейс на основе HTML в своем приложении, скопируйте также все соответствующие файлы.

В конце, вы должны выполнить экспорт в glTF. Если вы использовали пазлы в своем приложении, вам необходимо повторно сохранить сценарий в редакторе пазлов, чтобы сгенерированный код соответствовал новейшей версии движка.

Если вы изменили что-либо в файлах .html, .css или .js вашего приложения, обязательно сначала сделайте их резервную копию, чтобы осталась возможность вернуть изменения обратно.

После обновления

Восстановление библиотеки пазлов

Если вы добавляли новые записи в библиотеку пазлов, вы можете восстановить ее после обновления, скопировав файл /puzzles/library.xml в новую папку установки и заменив старый файл.

Обновление лицензии

Вы должны вводить лицензионный ключ каждый раз при обновлении до новой версии, иначе ваши приложения могут отображать водяной знак во время работы.

Известные проблемы и устранение неполадок

Изредка кнопка Puzzles может исчезнуть для вашего приложения в менеджере приложений. Пожалуйста, выполните чистое обновление, чтобы исправить это.

Иногда редактор пазлов может не загружаться после обновления. Пожалуйста, сбросьте настройки вашего браузера, чтобы исправить это.

Если после обновления какая-то функция сломалась, сообщите об этом на форуме, чтобы мы могли исследовать проблему и выпустить корректирующий релиз.

Все еще есть вопросы?

Задавайте их на нашем форуме!