Компіляція для Інтернету

Дивись також

На цій сторінці описано, як скомпілювати редактор HTML5 і експортувати двійкові файли шаблону з джерела. Якщо ви натомість хочете експортувати свій проект у HTML5, прочитайте Експорт для Інтернету.

Вимоги

Для компіляції шаблонів експорту для Інтернету необхідно:

Дивись також

Щоб отримати вихідний код Godot для компіляції, перегляньте Отримання джерела.

Для загального огляду використання SCons для Godot див. Знайомство з системою побудови.

Збірка шаблонів експорту

Перш ніж почати, переконайтеся, що emcc доступний у вашому PATH. Зазвичай це налаштовується Emscripten SDK, напр. під час виклику emsdk activate і source ./emsdk_env.sh/emsdk_env.bat.

Відкрийте термінал і перейдіть до кореневого каталогу вихідного коду движка. Потім надайте команді SCons завдання зібрати веб-платформу. Вкажіть target як template_release для релізної збірки або template_debug для налагоджувальної збірки:

scons platform=web target=template_release
scons platform=web target=template_debug

За замовчуванням, JavaScriptBridge singleton буде вбудовано в рушій. Офіційні шаблони експорту також мають увімкнений JavaScript singleton. Оскільки виклики eval() можуть становити проблему безпеки, опцію javascript_eval можна використовувати для збірки без singleton:

scons platform=web target=template_release javascript_eval=no
scons platform=web target=template_debug javascript_eval=no

За замовчуванням підтримка потоків WebWorker увімкнена. Щоб вимкнути її та використовувати лише один потік, можна скористатися опцією threads для створення веб-шаблону без підтримки потоків:

scons platform=web target=template_release threads=no
scons platform=web target=template_debug threads=no

Тепер двигун буде скомпільовано до WebAssembly компанією Emscripten. Після завершення отриманий файл буде розміщено в підкаталозі bin. Його назва godot.web.template_release.wasm32.zip для випуску або godot.web.template_debug.wasm32.zip для налагодження.

Нарешті, перейменуйте zip-архів на web_release.zip для шаблону релізу:

mv bin/godot.web.template_release.wasm32.zip bin/web_release.zip

І web_debug.zip для шаблону налагодження:

mv bin/godot.web.template_debug.wasm32.zip bin/web_debug.zip

GDеxtension

Стандартні шаблони експорту не включають підтримку GDExtension з причин продуктивності та сумісності. Перегляньте export page для отримання додаткової інформації.

Ви можете створити шаблони експорту, використовуючи опцію dlink_enabled=yes, щоб увімкнути підтримку GDExtension:

scons platform=web dlink_enabled=yes target=template_release
scons platform=web dlink_enabled=yes target=template_debug

Після завершення отриманий файл буде розміщено в підкаталозі bin. До його імені буде додано _dlink.

Нарешті, перейменуйте zip-архіви на web_dlink_release.zip та web_dlink_release.zip для шаблону релізу:

mv bin/godot.web.template_release.wasm32.dlink.zip bin/web_dlink_release.zip
mv bin/godot.web.template_debug.wasm32.dlink.zip bin/web_dlink_debug.zip

Створення редактора

Також можливо створити версію редактора Godot, яка працюватиме у браузері. Версія з редактором не рекомендується використовувати замість нативної збірки. Ви можете зібрати редактор за допомогою:

scons platform=web target=editor

Після завершення отриманий файл буде розміщено в підкаталозі bin. Його назва буде godot.web.editor.wasm32.zip. Ви можете завантажити вміст zip на свій веб-сервер і відвідати його за допомогою браузера, щоб скористатися редактором.

Зверніться до export page щодо вимог до веб-сервера.

Порада

Репозиторій Godot містить «скрипт Python для розміщення локального веб-сервера <https://raw.githubusercontent.com/godotengine/godot/master/platform/web/serve.py>`__. Це можна використовувати для локального тестування веб-редактора.

Після компіляції редактора розпакуйте ZIP-архів, створений у папці bin/, а потім виконайте таку команду в корені сховища Godot:

# You may need to replace `python` with `python3` on some platforms.
python platform/web/serve.py

Це обслуговує вміст папки bin/ і автоматично відкриває веб-браузер за замовчуванням. На сторінці, що відкриється, перейдіть до godot.editor.html, і ви зможете перевірити веб-редактор таким чином.

Зауважте, що для робочих випадків використання цього веб-сервера на основі Python не слід використовувати. Натомість вам слід використовувати встановлений веб-сервер, наприклад Apache або nginx.