Использование пользовательского движка

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

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

Давайте посмотрим, как справиться с каждой из этих ситуаций:

Запуск с Dev Engine

Когда вы запускаете ваше приложение из редактора, открывается новая вкладка, называемая страницей запуска. URL-адрес этой страницы имеет следующий вид:

https://launch.playcanvas.com/<scene_id>

Просто отредактируйте URL-адрес страницы запуска, добавив следующую строку в конец:

https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-latest.js

Чтобы запустить с минимизированной сборкой, используйте:

https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-latest.min.js

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

https://launch.playcanvas.com/<scene_id>?debug=true&use_local_engine=https://code.playcanvas.com/playcanvas-latest.dbg.js

Запуск с предыдущим стабильным движком

Предыдущие стабильные сборки движка PlayCanvas архивируются на code.playcanvas.com. Вы можете найти все предыдущие выпуски на GitHub. Движок именуется согласно следующей конвенции:

playcanvas-<major>.<minor>.<patch>.js

Так, например:

playcanvas-0.225.0.js

Чтобы запустить с этой конкретной сборкой движка, используйте следующий URL-адрес запуска:

https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-0.225.0.js

Чтобы запустить с минимизированной сборкой, используйте:

https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-0.225.0.min.js

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

Запуск с локально собранным движком

Если вы создадите ветку репозитория движка на GitHub, вы сможете собрать движок самостоятельно. Чтобы страница запуска запускала вашу пользовательскую сборку, вам нужно начать с обслуживания его с локального хоста с использованием порта 51000. Убедитесь, что вы видите исходный код вашего движка по URL-адресу:

http://localhost:51000/path/to/engine/playcanvas-latest.js

Чтобы теперь использовать этот движок на странице запуска, отредактируйте URL-адрес на:

http://launch.playcanvas.com/<scene_id>?use_local_engine=http://localhost:51000/path/to/engine/playcanvas-latest.js

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