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:
-
If using Python 3.10 to 3.13, also run
pip install --user zstandardto install Zstandard support for Python. This is not required on Python 3.14 and above, which include Zstandard support by default.
Sistema di compilazione SCons 4.4+.
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
Prima di cominciare, è meglio assicurarti che emcc sia disponibile nel proprio PATH. Questo è solitamente configurato dall'SDK di Emscripten, ad esempio dopo aver invocato emsdk activate e source ./emsdk_env.sh/emsdk_env.bat.
Aprire un terminale e navigare nella cartella principale del codice sorgente del motore. Quindi, istruire SCons a compilare la piattaforma Web. Specifica target come template_release per una build di rilascio oppure template_debug per una build di debug:
scons platform=web target=template_release
scons platform=web target=template_debug
Normalmente, il singleton JavaScriptBridge verrà compilato nel motore. Anche i modelli di esportazione ufficiali hanno il singleton JavaScript abilitato. Poiché le chiamate a eval() possono essere un problema di sicurezza, è possibile usare l'opzione javascript_eval per compilare senza il singleton:
scons platform=web target=template_release javascript_eval=no
scons platform=web target=template_debug javascript_eval=no
Normalmente, il supporto per i thread di WebWorker è abilitato. Per disabilitarlo e utilizzare un solo thread, è possibile usare l'opzione threads per creare il modello web senza supporto per i thread:
scons platform=web target=template_release threads=no
scons platform=web target=template_debug threads=no
Il motore verrà ora compilato in WebAssembly da Emscripten. Una volta completato, il file risultante verrà collocato nella sottocartella bin. Il suo nome sarà godot.web.template_release.wasm32.zip per la versione di rilascio o godot.web.template_debug.wasm32.zip per la versione di 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 web export options 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
Once finished, the resulting file will be placed in the bin subdirectory.
Its name will have .dlink added.
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.
Refer to the web export options for the web server requirements.
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.