Установка обновлений «Вердж3Д»

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

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

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

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

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

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

Обновление «Вердж3Д» в «Виндоус»

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

Обновление «Вердж3Д» в «Мак ОС»

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

Обновление «Вердж3Д» в «Линукс» и «Хром ОС»

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

После того как вы установите новую (мажорную) версию «Блендера», «3дс Макса» или «Майи», вам потребуется переустановить «Вердж3Д». Это нужно, чтобы плагины для экспорта, меню и кнопки были правильно зарегистрированы в новой версии. Убедитесь, что «Вердж3Д» совместим с обновлённой версией соответствующего пакета моделирования. Кроме того, обязательно запустите свежеустановленную версию пакета, чтобы дать ей создать необходимые файлы конфигурации (после чего закройте соответствующую программу).

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

Нажмите на кнопку Import Blender X.Y Preferences, а затем проверьте что «Вердж3Д» работает корректно.

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

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

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

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

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

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

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