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...

Compilare per il Web

Vedi anche

Questa pagina descrive come compilare i binari dell'editor e dei modelli di esportazione per HTML5 dal codice sorgente. Se invece si desidera esportare il proprio progetto su HTML5, consultare Esportazione per il Web.

Requisiti

Per compilare i modelli di esportazione per il Web, è necessario quanto segue:

Vedi anche

Per ottenere il codice sorgente di Godot per la compilazione, consultare Ottenere il codice sorgente.

Per una panoramica generale sull'utilizzo di SCons per Godot, consultare Introduzione al sistema di compilazione.

Compilare modelli di esportazione

Before starting, confirm that emcc is available in your PATH. This is usually configured by the Emscripten SDK, e.g. when invoking emsdk activate and source ./emsdk_env.sh/emsdk_env.bat.

Open a terminal and navigate to the root directory of the engine source code. Then instruct SCons to build the Web platform. Specify target as either template_release for a release build or template_debug for a debug build:

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

By default, the JavaScriptBridge singleton will be built into the engine. Official export templates also have the JavaScript singleton enabled. Since eval() calls can be a security concern, the javascript_eval option can be used to build without the singleton:

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

By default, WebWorker threads support is enabled. To disable it and only use a single thread, the threads option can be used to build the web template without threads support:

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

The engine will now be compiled to WebAssembly by Emscripten. Once finished, the resulting file will be placed in the bin subdirectory. Its name is godot.web.template_release.wasm32.zip for release or godot.web.template_debug.wasm32.zip for debug.

Infine, rinomina l'archivio zip in web_release.zip per il modello di rilascio:

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

E web_debug.zip per il modello di debug:

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

GDExtension

The default export templates do not include GDExtension support for performance and compatibility reasons. See the export page for more info.

È possibile compilare i modelli di esportazione tramite l'opzione dlink_enabled=yes per abilitare il supporto di GDExtension:

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

Una volta terminato, il file risultante sarà inserito nella sottocartella bin. Al suo nome verrà aggiunto _dlink.

Infine, rinominare gli archivi zip in web_dlink_release.zip e web_dlink_release.zip per il modello di rilascio:

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

Compilare l'editor

È anche possibile compilare una versione dell'editor Godot eseguibile nel browser. La versione dell'editor non è consigliata rispetto alla build nativa. È possibile compilare l'editor con:

scons platform=web target=editor

Una volta terminato, il file risultante sarà inserito nella sottocartella bin. Il suo nome sarà godot.web.editor.wasm32.zip. È possibile caricare il contenuto dello zip sul proprio server web e visitarlo con il browser per utilizzare l'editor.

Consulta la pagina di esportazione per i requisiti di configurazione di un server web.

Suggerimento

Il repository di Godot include uno script Python per ospitare un server web locale. Questo può servire per testare l'editor web localmente.

Dopo aver compilato l'editor, estrarre l'archivio ZIP creato nella cartella bin/, quindi eseguire il seguente comando nella radice del repository di Godot:

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

Questo servirà il contenuto della cartella bin/ e aprirà automaticamente il browser web predefinito. Nella pagina che si apre, accedere a godot.editor.html e dovrebbe essere possibile testare l'editor web in questo modo.

Si noti che per i casi d'uso in produzione, non si dovrebbe usare questo server web basato su Python. È invece consigliabile usare un server web consolidato come Apache o nginx.