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...
Compilando para Web
Ver também
Esta página descreve como compilar o editor HTML5 e binários de modelos de exportação a partir do código-fonte. Se você deseja exportar seu projeto para HTML5, leia Exportando para a Web.
Requisitos
Para compilar modelos de exportação para a Web, é necessário fazer o seguinte:
Sistema de build SCons 4.4+.
Ver também
Para obter o código-fonte do Godot para compilação, consulte Adquirindo o código fonte.
Para uma visão geral do uso do SCons no Godot, veja Introdução ao sistema de compilação.
Construindo modelos de exportação
Antes de começar, confirme se o emcc está disponível no seu PATH. Isso geralmente é configurado pelo Emscripten SDK, ex.: ao invocar emsdk activate e source ./emsdk_env.sh/emsdk_env.bat.
Abra um terminal e navegue até o diretório raiz do código-fonte da engine. Em seguida, instrua o SCons a buildar a plataforma Web. Especifique o target como template_release para um build de release ou template_debug para um build de debug:
scons platform=web target=template_release
scons platform=web target=template_debug
Por padrão, o singleton JavaScriptBridge será buildado na engine. Os modelos de exportação oficiais também possuem o singleton do JavaScript habilitado. Como as chamadas de eval() podem ser uma preocupação de segurança, a opção javascript_eval pode ser usada para buildar sem o singleton:
scons platform=web target=template_release javascript_eval=no
scons platform=web target=template_debug javascript_eval=no
Por padrão, o suporte a threads WebWorker está habilitado. Para desabilitá-lo e usar apenas uma única thread, a opção threads pode ser usada para buildar o modelo web sem suporte a threads:
scons platform=web target=template_release threads=no
scons platform=web target=template_debug threads=no
A engine agora será compilada para WebAssembly pelo Emscripten. Quando terminar, o arquivo resultante será colocado no subdiretório bin. Seu nome é godot.web.template_release.wasm32.zip para release ou godot.web.template_debug.wasm32.zip para debug.
Por fim, renomeie o arquivo zip para web_release.zip para o modelo de release:
mv bin/godot.web.template_release.wasm32.zip bin/web_release.zip
E web_debug.zip para o modelo de debug:
mv bin/godot.web.template_debug.wasm32.zip bin/web_debug.zip
GDExtension
Os modelos de exportação padrão não incluem suporte a GDExtension por motivos de desempenho e compatibilidade. Consulte a página de exportação para mais informações.
Você pode buildar os modelos de exportação usando a opção dlink_enabled=yes para habilitar o suporte a GDExtension:
scons platform=web dlink_enabled=yes target=template_release
scons platform=web dlink_enabled=yes target=template_debug
Quando terminar, o arquivo resultante será colocado no subdiretório bin. Seu nome terá _dlink adicionado.
Por fim, renomeie os arquivos zip para web_dlink_release.zip e web_dlink_release.zip para o modelo de release:
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
Construindo o editor
Também é possível buildar uma versão do editor do Godot que pode ser executada no navegador. A versão de editor não é recomendada em relação ao build nativo. Você pode buildar o editor com:
scons platform=web target=editor
Quando terminar, o arquivo resultante será colocado no subdiretório bin. Seu nome será godot.web.editor.wasm32.zip. Você pode enviar o conteúdo do zip para o seu servidor web e acessá-lo com seu navegador para usar o editor.
Consulte a página de exportação para os requisitos do servidor web.
Dica
O repositório do Godot inclui um script em Python para hospedar um servidor web local. Isso pode ser usado para testar o editor web localmente.
Após compilar o editor, extraia o arquivo ZIP que foi criado na pasta bin/ e, em seguida, execute o seguinte comando na raiz do repositório do Godot:
# You may need to replace `python` with `python3` on some platforms.
python platform/web/serve.py
Isso servirá o conteúdo da pasta bin/ e abrirá o navegador web padrão automaticamente. Na página que abrir, acesse godot.editor.html e você poderá testar o editor web desta forma.
Note que para casos de uso em produção, este servidor web baseado em Python não deve ser usado. Em vez disso, você deve usar um servidor web estabelecido, como o Apache ou o nginx.