diff options
| author | Fabio Alessandrelli <fabio.alessandrelli@gmail.com> | 2020-12-03 20:57:58 +0100 |
|---|---|---|
| committer | Fabio Alessandrelli <fabio.alessandrelli@gmail.com> | 2021-03-11 05:11:13 +0100 |
| commit | f6899e190f26de8365a1f477957635d211c88e87 (patch) | |
| tree | 2fbe818d5152336555cfacb523105d67cfa9f486 /README.md | |
| parent | 55c0a2ea03369efefa0f795bdc7f81fbd4568a47 (diff) | |
| download | redot-cpp-f6899e190f26de8365a1f477957635d211c88e87.tar.gz | |
Add JavaScript platform support (emcc, wasm).
Includes update to `README.md` with instructions on how to build a
GDNative library for webassembly.
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 15 |
1 files changed, 12 insertions, 3 deletions
@@ -275,9 +275,18 @@ Godot headers repository for more information. #### HTML5 -GDNative isn't supported on the HTML5 platform yet. Support is being tracked on -[issue #12243](https://github.com/godotengine/godot/issues/12243) in the main -Godot repository. +GDNative is supported on [specific exports](https://docs.godotengine.org/en/latest/tutorials/export/exporting_for_web.html#export-options) for the HTML5 platform since Godot `3.2.4`. Linking webassembly modules is currently underspecified in the standard, but [emscripten](https://emscripten.org/), which Godot uses to build the HTML5 version, implements its own linking system. + +To build GDNative libraries you wwill need a recent version of [emscripten](https://emscripten.org/). + +```bash +cd SimpleLibrary +emcc -o bin/libtest.wasm -g -O3 -s SIDE_MODULE=1 src/init.cpp godot-cpp/bin/<name of the godot-cpp> -Igodot-cpp/include -Igodot-cpp/include/core -Igodot-cpp/include/gen -Igodot-cpp/godot-headers +``` + +You'll need to replace `<name of the godot-cpp>` with the file that was created in [**Compiling the cpp bindings library**](#compiling-the-cpp-bindings-library). + +This creates the file `libtest.so` in your `SimpleLibrary/bin` directory. ### Creating `.gdnlib` and `.gdns` files |