Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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

Дивись також

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

Вимоги

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

• Emscripten 4.0.0+.

• Python 3.9+.

• SCons 4.4+ build system.

Дивись також

Щоб отримати вихідний код 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.