Установка обновлений Verge3D

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

Когда мне следует обновляться?

Подпишитесь на раздел официальных объявлений на форуме Soft8Soft или ищите информацию о новых обновлениях в социальных сетях.

Диалоговое окно «О продукте» со ссылками на официальные соц. сети.

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

Нажмите на этой иконке ⓘ чтобы открыть диалог About Verge3D с информацией о новом обновлении:

Обновление Verge3D в Windows

Обновление выполняется довольно просто. Скачайте и установите свежую версию Verge3D в ту же папку (например, "C:\Program Files\Verge3D_for_Blender"). Старая версия будет удалена, но все ваши приложения, настройки и лицензионный статус сохранятся.

Обновление Verge3D в macOS

Обновление выполняется довольно просто. Скачайте и установите свежую версию Verge3D. Старая версия будет удалена, но все ваши приложения, настройки и лицензионный статус сохранятся.

Обновление Verge3D в Linux и ChromeOS

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

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

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

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

Обновление Verge3D не добавляет новые возможности в имеющиеся приложения, поскольку они продолжают использовать рантайм Verge3D из старой версии (файл v3d.js). Чтобы обновить их, вам потребуется предпринять ряд дополнительных шагов.

Первый способ (автоматический) — использование функции обновления

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

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

Эта операция перезаписывает модули движка файлами из подпапки build установочной папки Verge3D, а именно: среду выполнения Verge3D v3d.js и дополнительные модули:

Эта операция также перезапишет выбранные файлы HTML/CSS/JavaScript и иконки приложения из папки media. Для этого будут использованы файлы шаблона, расположенные в папке manager/templates/template_name) (внутри установочной папки).

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

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

Второй способ (чистый) — воссоздание приложения с нуля

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

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

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

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

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

Проверка обновления

Проверка успешности обновления производится следующим образом. Откройте диалог About Verge3D диспетчера приложений и убедитесь, что строка Version содержит правильную версию:

А чтобы убедиться, что конкретное приложение использует правильную версию рантайма, запустите его, откройте браузерную консоль, а затем найдите следующую строку:

Убедитесь, что версия в консоли браузера совпадает с версией, которая выводится в диалоге About Verge3D.

Обновление пакетов моделирования

После того как вы установите новую (мажорную) версию Blender, 3ds Max или Maya, вам потребуется переустановить Verge3D. Это нужно, чтобы плагины для экспорта, меню и кнопки были правильно зарегистрированы в новой версии. Убедитесь, что Verge3D совместим с обновлённой версией соответствующего пакета моделирования. Кроме того, обязательно запустите свежеустановленную версию пакета, чтобы дать ей создать необходимые файлы конфигурации (после чего закройте соответствующую программу).

Blender является исключением из правила, позволяя скопировать настройки из предыдущей версии при первом запуске:

Нажмите на кнопку Import Blender X.Y Preferences, а затем проверьте что Verge3D работает корректно.

Известные проблемы и решения

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

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

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

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

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

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